《游戏编辑器技术原理与架构》9.2 引用清理与孤儿回收
资产会过期:删了旧模型、弃用旧数值表。清理工具在依赖图上做两件事:findOrphans 找无人引用、也不在 roots 的孤儿;simulateDelete 模拟删除 target 会破多少图。6 条用例本机真跑,钉住「孤儿判定、root 豁免、删除破图、不含 target 自身」四条清理语义。
category
资产会过期:删了旧模型、弃用旧数值表。清理工具在依赖图上做两件事:findOrphans 找无人引用、也不在 roots 的孤儿;simulateDelete 模拟删除 target 会破多少图。6 条用例本机真跑,钉住「孤儿判定、root 豁免、删除破图、不含 target 自身」四条清理语义。
节点图要能跑:拓扑排序保证依赖先算,求值器按序执行。本节实现拓扑排序与图求值。6 条用例钉住排序、常量节点与多入口。对标 Unity ShaderGraph 的编译与 Blender 的求值。
实例不该是原型的复制品,而是「原型 + 覆盖表」:模板值打底,实例只记录差异。OverrideTable.set 记录覆盖,apply 合成可见值(覆盖优先),diff 自动列出改了什么;变体继承 = 覆盖叠在基准上,后设置者赢。6 条用例本机真跑,对标 Unity Prefab override 与 Unreal 的 Blueprint 继承。
材质、着色器、AI、蓝图都共享节点图结构:节点、输入/输出端口、连线。本节实现 NodeGraph 的连接、删除与入边查询。6 条用例钉住连线、去重与删除连带。对标 Unity ShaderGraph 与 Blender Geometry Nodes。
原型是一份可复制的定义,实例是它在场景里的化身。PrototypeRegistry 注册原型,createInstance 深拷贝字段并递归实例化嵌套子结构——改实例不影响原型,两个实例互不影响。6 条用例本机真跑,对标 Unity 的 Prefab、Unreal 的 Blueprint 与 Cocos 的预制体。
资产引用关系就是一张有向图:边 from→to 表示「from 依赖 to」。本节实现 DependencyGraph——正向查依赖、反向查被引用、迭代求传递闭包、环安全;6 条用例本机真跑,钉住「登记、正向、反向、传递闭包、环安全」五条图语义,清理与重命名都建在这张图上。
变体选择常是「平台 × 用途」两维:iOS + UI 用变体 A,Android + 光照图用变体 B。本节实现 PlatformMatrix——规则表解析(精确平台+用途 → 单维通配 → 全通配 → null);6 条用例本机真跑,钉住「精确解析、同平台通配、通配平台兜底、全通配、无规则 null」五条矩阵解析语义。
场景里不只有父子关系,还有跨对象引用:灯光指向某资产、组件指向某节点、运行期才有的动态引用。ObjectGraph 把引用从父子结构中独立出来,引用带域 node/asset/runtime,missingRefs 一次列全断引用;6 条用例本机真跑,对标 Unity 的 SerializeField 对象引用与 Unreal 的软/硬引用。
预览动画时用状态机决定播哪条:条件满足就切状态。本节实现条件判定与 AnimStateMachine 的更新、转移、重置。6 条用例钉住条件、转移与保持。对标 Unity Animator 与 Unreal AnimGraph 的状态机。
场景格式会演进:V1 的 pos 只有两分量,V2 加 z,V3 改默认名。老文件不能读不了。MigrationChain 维护「起点版本 → 迁移函数」的链,migrate 从文件版本逐级迁到目标,缺环就拒绝而非静默读错;示例 V1→V2→V3 真跑 5 条用例,对标 Unity 的 SerializeField 兼容与 Godot 的 resource 版本迁移。
派生资产(缩略图、LOD、图集、压缩纹理)由源资产经过一道工序产生,是增量导入在派生层上的延伸。本节实现 DerivedCache——key 由源标识 + 源内容哈希 + 工序 + 设置指纹构成,源或设置一变 key 就变;6 条用例本机真跑,钉住「命中、覆盖、源哈希失效、工序/设置独立、key 确定性」五条缓存语义。
Dope Sheet 按轨道展示剪辑与关键帧:每个轨道一行、剪辑块可移动与裁剪。本节实现剪辑定位、移动、裁剪与轨道重叠检测。6 条用例钉住区间与重叠。对标 Unity Timeline 与 Blender Dope Sheet。
同一份源资产产出多个变体:同一 PNG 在 iOS 要 sRGB 直通、在 Android 要压缩。本节实现 VariantSet——登记变体、按平台挑选(精确平台匹配 → 通用变体 → 默认变体 → null);6 条用例本机真跑,钉住「登记计数、精确优先、通用回退、默认兜底、全无返回 null」五条变体选择语义。
动画编辑器最核心的是曲线:关键帧与之间的插值。本节实现 Hermite 插值、曲线求值、关键帧增删与时长。6 条用例钉住端点、切线与增删。对标 Unity AnimationCurve 与 Blender F-Curve。
场景文件是给编辑器自己读写的,第一品质是「可 diff」:相同内容恒得相同字节,让 VCS、对照、增量保存有意义。本节实现场景格式:serialize 按稳定 id 排序逐行输出,parse 逐行还原,diff 按 id 对齐输出 added/removed/changed;6 条用例本机真跑,对标 Unity 的 YAML 场景与 Godot 的文本 tscn。
Play 期间要检查运行态对象:当前值快照、与编辑态差异、汇总报告。本节实现快照检查、运行态补丁应用、差异计算与摘要。6 条用例钉住差异提取与补丁回放。对标 Unity 的 Inspector 运行态显示与 Unreal 的 Gameplay Debugger。
本地化表 = 键 × 语言:精确命中 → 回退默认语言 → 无。本节实现 I18nTable——put/lookup 回退链、{name} 占位符替换、missingKeys 高亮缺翻译;6 条用例本机真跑,钉住「精确命中、默认语言回退、缺键 undefined、占位符替换与缺失保留、missingKeys」五条本地化不变量。
操作 API 负责改得对,不变量校验负责查得对。checkInvariants 把文档按 id 唯一、parent 存在、无环、children 与 parent 双向一致四条不变量过一遍,返回错误列表;加载、撤销、脚本写入之后各跑一次,结构坏在第一时间暴露。6 条用例本机真跑,对标 Unity/Unreal 编辑器启动时的场景一致性检查。
Play 可以共享编辑进程(快但会拖慢编辑器)或独立进程(慢启动但隔离崩溃)。本节实现 PlayMode 枚举、合法转移判定与进程共享判定。6 条用例钉住模式转移与进程策略。对标 Unity 的 Play 与 Unreal 的 Standalone/Dedicated。
内存自增 id 一旦保存再加载就失效——跨会话引用会断。本节实现稳定 id:makeStableId 用 FNV-1a 内容哈希做确定性生成,相同输入永远得到相同 id;DirtyTracker 维护父子链接,markDirty 沿祖先链向上传播,「改一个节点 = 祖先全脏」。6 条用例本机真跑,对标 Unity 的 InstanceID 与 Godot 的场景树脏跟踪。