来源: AGENTS.md GOVERNANCE.md ai/docs-impact.yml ai/generated-files.yml doc/migration/markdown-inventory.schema.json commit d32b9cc880a8 governance

文档政策

CCB-Docs 是正式的教程、解释、架构、参考与导航站，但它不与游戏仓库平分权威。

权威模型

主题	权威来源
运行时行为	CCB 源码与测试
JSON、Lua 与 API 契约	Schema、LuaLS 声明、注册、生成清单
构建与验证	CI、CMake、Makefile、Gradle、仓库验证器
贡献与治理	CCB AGENTS.md、CONTRIBUTING.md、GOVERNANCE.md
解释与导航	CCB-Docs，并按上述来源核验

正文与源码契约冲突时，必须将页面标为 stale、移出 AI 索引并修复。不得为了匹配 文档而改变运行时行为。

双语发布

新 active 页面首次发布必须同时有中文和英文。中文更新后，英文可标记 translation-stale 最多 30 天并自动建立跟踪 Issue。逾期只阻止修改该双语对或 同一高风险文档子系统的 PR，不阻止无关修复。未完成双语的迁移页面保持 draft， 不进入正式导航、搜索与 AI 索引。

源码漂移与生成内容

每页声明精确 source_paths、核验 commit/日期和 fingerprint。只有这些路径变化才 构成漂移；master 的任意 commit 不会让全部页面 stale。无实际变化不得创建 Bot PR；漂移更新合并为一个 PR，经人类审阅，绝不自动合并。

docs-catalog.yml 是唯一手工维护的机器目录，并生成导航、双语映射、搜索/AI/归档 策略、redirect、sitemap 元数据、llms.txt 与 JSON 索引。应修改 catalog 或 生成器，不得手改派生索引。

旧路径

迁移后的仓库路径永久保留轻量双语 moved stub。六个月后可删除旧正文，但历史 PR、 Issue、Fork 与外部链接仍必须能通过稳定文档 ID 到达当前中英文页面。