SuperAPI AI 工具集

unity-yaml-editing

通用与其它

查看项目

更新于 10-16 09:51

技能介绍

用途:这是 Unity 序列化 YAML 文本手编的操作性指导模块,定位为最后手段而非捷径。正常对象与资源操作应优先使用 REST 技能,因为它们能保证序列化有效性。

何时加载:仅当 REST 无法触达时手编 YAML,包括编译失败导致编辑器无法反序列化组件、.meta 文件(无 REST 技能覆盖,GUID 与导入器字段仅在文本中)、ProjectSettings 中隐藏字段、以及 Git 合并冲突(REST 无法做三方合并)。不属上述情况应停止并使用 REST,不要为省事手编 YAML。

主要能力与用法:

  1. 引用/fileID 修复:从脚本的 .cs.meta 读取当前 GUID,在 prefab/scene 中把 m_Script: {fileID: 11500000, guid: ..., type: 3} 的 guid 改为正确值;删除 Missing 组件需同时移除整个 --- !u!114 &<fileID> 块与拥有者 GameObject 的 m_Component 列表中对应项。
  2. .meta/GUID 安全:伪 GUID 检测与 uuid4 修复复用 /metacheck;替换 GUID 用 python -c "import uuid; print(uuid.uuid4().hex)",不要手写。
  3. ProjectSettings 补丁:先 git 备份,按 key 定位字段,仅改其值,让 Unity 重新加载并重新序列化以验证可往返。
  4. 合并冲突协助:按每个 --- !u!<classID> &<fileID> 块逐块解决,单侧改动取该侧,双侧改动做真正的三方合并。

硬性规则:改前确认干净的 git 树;除非修复引用否则不动结构,仅改值;改后触发 Unity 重新导入验证无新错误且文件可往返;GUID 必须是 uuid4;批量编辑前先 grep 影响集;改 GUID 必须同一变更中更新所有引用。

路由:REST 能做的用 gameobject_/prefab_/scriptableobject_/scene_/importer_/graphics_;GUID 健康审计与修复走 /metacheck;技能文档一致性走 /skillcheck。

限制:本模块为纯文档、无 REST 技能需要门控,可在任何操作模式下加载。资料未提供具体价格、平台或更多步骤细节。