SuperAPI AI 工具集

unity-workflow

办公与效率

查看项目

更新于 10-15 17:25

技能介绍

用途:为 Unity 中的 AI 操作提供持久历史与回滚系统(“Time Machine”),可给任务打标签、在修改前对对象做快照、撤销特定任务,且重启编辑器后仍有效。

主要能力:书签(bookmark_set/goto/list/delete)保存与恢复选择集和场景视图;历史撤销/重做(history_undo/history_redo/history_get_current,支持 steps);任务级(workflow_task_start/end、snapshot_object、undo_task、redo_task、undone_list、delete_task);会话级撤销(workflow_session_start/end/undo/list/status);批量治理(workflow_plan 生成计划、batch_query_assets 查询资产、batch_retry_failed 重试失败项)。自动追踪的创建类操作(gameobject_create、component_add、ui_create_* 等)及修改前自动快照。快照按 Created/Moved/Deleted/Modified/Setting 分级,文件按内容寻址存于 Library/UnitySkills/workflow_files/。设置类技能(console、graphics、physics、project 等)现已可回滚。

用法:调用任意技能前若参数靠名称猜测,应先读本文件或用 GET /skills/recommend?includeSchema=true 获取 schema。常用:workflow_task_start 开启任务并在结束时用 workflow_task_end 保存;撤销用 workflow_undo_task(按 taskId)或 workflow_session_undo(按 sessionId),已废弃的 workflow_revert_task 应替换为 workflow_undo_task。单步撤销用编辑器 editor_undo;多步用 history_undo。

限制:workflow_clear_history 为高风险不可逆,仅 Bypass 或 Allowlist 可调用,且只清历史不回滚改动;workflow_undo_task 等在 surface profile 排除某类别时会整体拒绝(SURFACE_EXCLUDED),不会部分应用;未保存场景中创建的对象重启后 GlobalObjectId 失效,撤销会失败;scene_save 的撤销需重载场景生效;外部副作用(如 Package Manager)无法回滚。自动清理配置见 EditorPrefs UnitySkills.Workflow.*(默认 MaxTasks=200、MaxHistoryMB=32、MaxStoreMB=512 等,0 表示禁用该项)。确切函数签名以 GET /skills/schema 为准。