SuperAPI AI 工具集

unity-batch

通用与其它

查看项目

更新于 10-15 17:25

技能介绍

用途:在 Unity 中一次性操作大量对象、运行或轮询长时异步任务,以及先预览后提交的批量编辑。

主要能力:POST /skills/batch 是 HTTP 端点而非技能,可在一次主线程任务中按顺序运行最多 50 个普通技能调用,每个仍走完整单技能流程(校验、权限门、独立 Undo 组、审计)。请求体含 steps(必填,{skill,args} 数组,超过 50 返回 400 SEMANTIC_INVALID)、continueOnError(默认 false)、params(解析 $param 节点)。args 中仅含 $ref 的对象会替换为前序成功步骤结果中的值,无法解析则步骤失败。

使用方式:查询用 batch_query_gameobjects、batch_query_components、batch_query_assets;预览用 batch_preview_* 或 fixer(batch_fix_missing_scripts、batch_standardize_naming、batch_set_render_layer、batch_replace_material、batch_cleanup_temp_objects),返回 confirmToken、summary、riskLevel、targetCount、sampleChanges 等;确认后调用 batch_execute(confirmToken),token 单次有效、一小时过期。大任务返回 jobId,用 GET /jobs/{id}?wait=<s>(最长 120 秒)或 GET /jobs/{id} 轮询。报告用 batch_report_get,失败重跑用 batch_retry_failed(reportId)。

模式与限制:?mode=dryRun 只校验不执行;?mode=transactional 全有或全无并支持 Undo 回滚;?diff=1 加场景差异;?wire=v2 精简负载;不支持 ?mode=plan。22 个技能中 18 个为只读 SemiAuto,4 个 FullAuto(batch_execute、job_wait、job_cancel、batch_retry_failed)在 Approval 下需授权。授权中断优先于 continueOnError。batch_execute 与 POST /skills/batch 不同,前者提交单个预览过的批量操作。batch_run、job_poll、job_result、batch_delete、batch_move 均不存在。资产级批量移动/复制/删除用 asset_,工作流会话撤销用 workflow_。