【免费下载链接】Unity-SkillsAI automation skills specifically designed for Unity项目地址https://gitcode.com/gh_mirrors/un/Unity-Skills点击查看免费下载Unity-Skills 是一款面向 Unity 的 AI 自动化技能插件它内置的持久化快照与 Undo 系统让 AI 的每一步改动都可以按任务精确回退。本文带你深度解析它的核心机制五类分级快照、以 SHA1 哈希命名的内容寻址存储以及如何用workflow_undo_task一键撤销整个任务。为什么需要任务级快照而不只是 CtrlZUnity 原生 Undo 栈只存在于当前会话中一旦编辑器重载Domain Reload、重启工程撤销栈就基本失效了。而 AI 代理往往会在一次会话里连续修改场景对象、材质、脚本、工程设置出问题时需要的不是退回一步而是把刚才这一整批改动全部回滚。Unity-Skills 的 Workflow 模块为此设计了一个时间机器任务Task用workflow_task_start/workflow_task_end包裹一段操作期间所有被触碰的对象都会自动打快照会话Session用workflow_session_start/workflow_session_undo把整轮对话的改动打包支持一次性全部撤销持久化历史写入Library/UnitySkills/workflow_history.json当前schemaVersion为 5重启编辑器后依然可以撤销。相关的技能文档可参考 workflow/SKILL.md它完整列出了每个技能的参数与返回值。一图看懂五类快照类型快照不是无脑全量备份而是按改动性质分成五种类型由枚举 SnapshotType 定义类型触发时机实际存储内容撤销行为Created新建新建资产/文件夹仅记录路径 GUID直接删除新建的资产Moved移动asset_move旧路径 新路径移回原路径Deleted删除asset_delete等文件与.meta整体移入内容寻址仓库完整恢复连.cs脚本都能救回来Modified修改材质、SO、场景、shader 等内容寻址备份 轻量 JSON 状态还原被备份的字节Setting设置编辑器/工程设置通过注册表记录旧值注册表恢复旧值这套按需存最少数据的设计既省空间又省时新建一个物体只需存几个 ID而真正被删除的大文件才会完整搬进备份仓库。内容寻址存储把 SHA1 哈希当文件名的备份仓库Deleted 和 Modified 类快照的原始字节存放在一个内容寻址文件仓库中核心实现是 WorkflowFileStore.cs位置Library/UnitySkills/workflow_files/SHA1每个文件 blob 以自己的内容 SHA1 哈希为文件名自动去重相同内容只存一份多个任务删除了相同文件不会占用双倍空间.meta独立寻址Unity 的.meta伴生文件按自己的内容单独哈希存储历史中用fileHash/metaFileHash两个引用定位原子写入先写.tmp再改名避免存到一半的损坏文件完整性校验恢复前先重算哈希比对一旦内容对不上文件名blob 会被隔离为hash.corrupt并中止恢复——宁可不还也不写入坏数据见 VerifyBlobIntegrity。自动清理备份不会无限膨胀仓库不会一直膨胀。WorkflowAutoCleanConfig 提供了一组可调的自动清理参数默认值参数默认值含义MaxTasks200最多保留的任务数MaxHistoryMB32历史文件体积上限MaxTaskAgeDays30任务最长保留天数MaxStoreMB512备份仓库体积上限StoreMaxAgeDays7仓库 blob 最长保留天数清理逻辑非常克制仍被保留历史引用的 blob 绝不删除10 分钟内刚写入的 blob可能正属于尚未入史的快照也会被宽限保护见 PruneByAgeAndSize。workflow_undo_task如何撤销一个任务核心撤销入口是workflow_undo_task实现在 WorkflowSkills.cs。典型工作流workflow_task_start带 tag如创建 NPC→ AI 开始执行一系列操作workflow_task_end→ 任务连同所有快照落盘保存返回taskIdworkflow_list查看历史找到目标任务的taskIdworkflow_undo_task(taskId)→ 该任务的所有改动被逆序还原任务进入已撤销栈反悔了workflow_redo_task可把它重做回来workflow_undone_list查看可重做列表。撤销执行有三个值得注意的细节逆序执行快照按操作发生的相反顺序恢复保证依赖关系正确失败可重试中途某个快照恢复失败时失败及未处理的快照会留在栈上可再次调用重试逐条明细返回TaskUndoResulttotal/succeeded/failed/detailsAI 能精确知道哪个对象恢复失败、失败原因是什么。安全边界与已知限制 ⚠️面Surface门禁workflow_undo_task会预先检查目标任务的每个快照若还原会涉及当前配置排除的类别如场景 GameObject 或.unity/.mat资产整次调用会被拒绝并返回SURFACE_EXCLUDED而不是半撤销scene_save撤销还原的是磁盘上的.unity文件若场景正处于打开状态需要手动 Reload 才能生效未保存场景中的新物体其GlobalObjectId跨重启失效撤销时会在结果中标记为 failed外部副作用不可回滚如 Package Manager 操作等引擎外部行为快照无法覆盖清空历史是高危操作workflow_clear_history只删除追踪记录不会还原已应用的改动且不可逆仅在 Bypass 模式或白名单命中时可调用。快速上手清单 每轮对话开头调workflow_session_start结尾调workflow_session_end获得会话级兜底对高危改动额外用workflow_task_start/workflow_task_end包一层拿到细粒度taskId出问题先workflow_list定位任务再workflow_undo_task精确回退想彻底重来前记住顺序先 undo再考虑workflow_clear_history。延伸阅读快照机制与自动清理文档workflow/SKILL.mdSnapshot Mechanism 一节模式与门禁说明docs/OPERATING_MODES_CN.md安装与配置指南docs/SETUP_GUIDE_CN.md数据模型源码WorkflowModels.cs、WorkflowManager.cs理解了五类快照 内容寻址 任务级 Undo这套组合你就掌握了 Unity-Skills 让 AI 改工程时敢放手、能回头的核心底气。赞分享【免费下载链接】Unity-SkillsAI automation skills specifically designed for Unity项目地址https://gitcode.com/gh_mirrors/un/Unity-Skills点击查看免费下载相关推荐pnpm Store 深度解析内容寻址存储、虚拟存储与磁盘优化实践pnpm Store 深度解析内容寻址存储、虚拟存储与磁盘优化实践 导读 本文聚焦 pnpm 最核心的存储机制—— 内容寻址存储Content AddresAI 技能人工智能rqlite 快照存储架构深度解析基于 SQLite WAL 的增量快照与 MRSW 并发设计rqlite 快照存储架构深度解析基于 SQLite WAL 的增量快照与 MRSW 并发设计 导读 本文以 rqlite 仓库中 snapshot/DESI数据库分布式数据库关系型数据库Dockge存储管理卷快照与克隆功能深度解析Dockge存储管理卷快照与克隆功能深度解析 引言容器化时代的存储挑战 在现代容器化部署中数据持久化是确保应用稳定运行的关键要素。Docker卷Volu后端前端容器编排运维创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考