跳转至

上游同步

CCB 与其他 Cataclysm 系仓库共享历史,但不是镜像。上游 commit 是证据和素材,不能 覆盖 CCB 的运行时权威。

修改前记录来源

  • 来源仓库、PR/Issue 与精确 commit 范围;
  • 原作者和适用许可证;
  • 移植理由以及它要解决的 CCB 问题;
  • 有意省略或重写的文件与行为;
  • 已知 CCB 分歧与可能冲突区域。

在 commit message 和 PR 中保留署名,不要把多个上游变化压成无法追溯的补丁。

检查 CCB 边界

比较注册、数据 ID、序列化、Mod 加载、EOC context、Lua v5 公共契约、UI/input、 桌面/Android 配置与测试。查找来源修改之后的上游修复,但逐项评估。上游测试通过 不能证明 CCB 兼容。

验证与记录

先运行能证明目标行为的最小 CCB 测试;涉及共享核心、存档、数据、API 或平台风险时 再扩大。只有为防止未来错误重复移植所必需时才写源码注释;完整分歧解释放在 CCB-Docs 并链接精确来源。

只有来源可审计、最终 CCB diff 已理解、兼容影响明确且 Responsible human 负责时, 移植才达到 ready 状态。