客户端内容工具链与质量
笔记列表 14
自动关联目录：发布恢复：远端结果未知时禁止自动重放 核心判断：上传或远端保存超时后，“本地没收到成功”不等于“远端没生效”。无法查询或幂等确认结果时，自动重放比停止更危险。 一、业务冲突 内容发布包含分配身份、上传源文件、上传平台制品、…
自动关联目录：导入提交：Submit 必须冻结 Revision 与 PlanDigest 核心判断：导入按钮提交的不是“当前草稿 ID”，而是一次不可变执行意图；只有同时冻结草稿 Revision、源文件指纹、计划摘要和工具能力版本，异…
自动关联目录：导入映射：名称不能承担跨工具节点身份 核心判断：本地预览器与 UE Cook 工具会为同一源文件生成不同临时 NodeId；跨工具迁移选择、动画和材质配置时，名称只能参与判别，不能成为身份。 一、业务冲突 创作者在轻量预览…
自动关联目录：工具分发：复制可执行目录不等于生成可验证 SDK 核心判断：UE Cook 工具能在开发机运行，不代表它可以独立分发；一个 SDK 必须声明最小文件闭包、插件与配置白名单、协议版本和每个文件摘要，并拒绝额外内容。 一、业务…
自动关联目录：检查点写入：原子替换失败时旧状态必须仍可读 核心判断：检查点的首要职责不是“尽快写出最新 JSON”，而是无论共享冲突、磁盘满还是进程崩溃，都至少保留一份可解析的旧状态。 一、业务冲突 Cook 与发布可能持续很久，桌面 …
自动关联目录：模块边界：Editor Guard 不等于运行时依赖已经移除 核心判断：在 C++ 调用点包一层 #if WITH_EDITOR 只能裁掉代码分支；只要 Runtime Module 的 Build.cs 仍依赖编辑模块、公…
自动关联目录：目标裁剪：禁用插件列表不是可证明的能力矩阵 核心判断：UE Target 中不断追加 DisablePlugins 能快速缩小包体，却只能表达“不要什么”；可维护的轻量运行时必须先声明“需要哪些能力”，再由构建系统推导模块、…
自动关联目录：管线进度：百分比必须来自已确认工作账本 核心判断：Stage 名称只能说明“正在做哪类工作”，不能计算可信百分比；可恢复管线的进度必须由提交前冻结的工作集合和已确认完成项推导。 一、业务冲突 一个导入任务可能产生多个产品、…
自动关联目录：缺失引用：自动补图不能越过材质槽语义 核心判断：一张外部图片“文件名相似”不能证明它应绑定到某个材质；自动修复必须同时锁定源材质对象、槽位语义和原引用，歧义时宁可阻塞。 一、业务冲突 模型文件常只保存外部贴图路径。路径失效…
自动关联目录：自动化验证：静态契约测试不能代替真实运行证据 核心判断：检查 Target.cs、Build.cs、脚本参数和 Manifest 能快速阻止配置回归，但它只能证明“声明看起来正确”；启动、跨进程通信、资产加载和 DS 行为仍…
自动关联目录：诊断闭环：Stage 必须绑定本次运行与制品身份 核心判断：日志写出 stage=cook 只能帮助搜索；要证明一次慢或失败发生在哪份输入、哪个目标和哪组制品上，Stage 必须与 Intent、Run、ArtifactSe…
自动关联目录：质量门禁：Error、Warning 与 Retryable 是三个维度 核心判断：严重度回答“能否继续”，可重试性回答“原输入不变时再跑是否可能成功”，二者不能合成一个成功/失败布尔值。 一、业务冲突 导入失败可能来自缺…
自动关联目录：跨语言合约：同一 Schema 必须拥有规范化身份 核心判断：桌面 UI、Python 服务和 UE 工具各有一份 Schema 文件并不等于共享合约；只有明确唯一来源、规范化身份、派生规则和跨实现向量，才能阻止格式相同但语…
自动关联目录：兼容协商：一个版本号不能描述整条资产管线 核心判断：预览解析、场景计划、UE Cook、Bundle、上传 Journal 和渲染后端可以独立升级；用一个“工具版本”全局判兼容，要么误杀可复用阶段，要么放过真正不兼容的组合。…