分支与版本策略

当前分支关系

• 上游稳定基线：release
• 当前功能分支：untoon

untoon 持续跟进上游稳定版本，同时保留 Untoon 渲染改动，不脱离上游独立演进。

为什么以 release 为基线

release 有更完整的 QA 覆盖，相比 ue5-main 更适合长期维护，作为团队统一的生产引擎版本落地风险也更低。

推荐版本管理策略

• 引擎版本沿用 UE 基础版本号，例如 5.8
• 分支版本加自定义后缀，例如 5.8-untoon.1
• 渲染结构有重大变更时单独记一个里程碑

推荐 Git 维护原则

• release 仅作为比较与合并基线，不直接承载 Untoon 功能
• untoon 承载所有正式可用 Untoon 功能
• 大功能在 codex/ 或团队约定前缀的分支上开发，完成后再合并回 untoon
• 每次同步上游后都应记录冲突位置和处理结论

升级节奏建议

每次从上游同步 release，按这个顺序处理：

1. 合并或 Rebase 上游
2. 处理 Engine/Private/Materials 冲突
3. 处理 Engine/Shaders/Private 冲突
4. 处理 Renderer/Private 冲突
5. 验证 GBuffer 绑定与 Shader 编译
6. 验证 Untoon Pass 行为

不建议的做法

• 把 Untoon 改动散落到多个临时分支
• 在没有文档的情况下大规模修改 Shader Packing
• 在未验证材质兼容性的情况下修改 GBufferToon 数据布局
• 把上游合并与新功能开发混在同一个提交集里