17727d08c3
冻结 GameArtifactManifest/GameSourceArchive 契约和 V34 pending/committed 状态记录，增加专用 writer 的全量回读物化校验，并让 Runtime API 在消费和发布前对账 committed、GamePackage checksum 与实际 engineBundle hash。隔离 staging 已验证真实消费拒绝未提交版本；源码桶权限仍保持 fail-closed，正式金标不切换。
绘境AI · 设计文档总索引 + SoT 注册表
这是什么:绘境AI 全部设计文档的唯一入口,以及全项目 canonical 文档的注册表(机器对账,
docs-gateG2 门守护)。 读它 = 当前真相。本目录是策展层——每个主题只保留一份真值;过程稿与历史在 git(见文末"其它去哪找")。 怎么用:先查 §2 注册表锁定主题的 SoT;做架构级任务按 §3 六域导航下钻;任何新设计开工前必须先查注册表(见feature-design-doc),避免漏读既有设计。
1. 文档怎么组织:四级结构
设计文档按产品生命周期的六个领域组织,每个领域内部分四级(L1 总索引=本页 → L2 领域主文档 → L3 模块子文档 → L4 详细展开):
flowchart LR
P["① 产品<br/>需求 / 定位"] --> A["② 架构<br/>技术怎么搭"]
A --> BE["③ 后端<br/>服务实现"]
A --> FE["④ 前端<br/>端实现"]
BE & FE --> OP["⑤ 运营<br/>上线 / 变现"]
OP --> DO["⑥ 运维<br/>部署 / 可用性"]
风格约定:人读散文、配图说明、少黑话、单档不超过 2000 行。给 AI agent 的速查在
.agents/。
2. SoT 注册表(canonical 唯一锚 · 机器对账)
每行一个主题,SoT 文档头部带 frontmatter topic: + canonical: true,与本表由 bash .agents/tools/docs-gate.sh 双向对账;同一 topic 出现第二份 canonical 即红线。视图/参考不标 canonical,只在表中登记去处。
| topic | SoT | 状态 |
|---|---|---|
| 产品域总览 | 产品/README | canonical |
| 产品需求清单 | 产品/需求清单 | canonical |
| 需求模块映射 | 产品/需求模块映射 | canonical |
| 商业定位 | 产品/商业定位 | canonical |
| 护城河话术 | 产品/护城河话术 | canonical |
| 游戏内容金标 | 产品/游戏内容金标 | canonical |
| 架构域总览 | 架构/README | canonical |
| 13模块注册表 | 架构/13模块 | canonical |
| 产物执行沙箱 | 架构/产物执行沙箱 | canonical |
| 契约总览 | 架构/契约总览 | canonical |
| 生成引擎子树总览 | 架构/生成引擎/README | canonical |
| 生成引擎运行时 | agentic运行时架构图说 | canonical |
| 生成验收门 | 生成引擎/验收门 | canonical |
| prompt治理 | 生成引擎/prompt治理 | canonical |
| 数据飞轮 | 生成引擎/数据飞轮 | canonical |
| 游戏质量与爆火能力 | 生成引擎/游戏质量与爆火能力 | canonical |
| 后端域总览 | 后端/README | canonical |
| 数据模型 | 后端/数据模型 | canonical |
| 鉴权与权限 | 后端/鉴权与权限 | canonical |
| 前端设计体系 | 前端/README | canonical |
| 运营域总览 | 运营/README | canonical |
| 变现与单位经济 | 运营/变现与单位经济 | canonical |
| 变现端到端 | 运营/变现端到端 | canonical |
| 合规闸门 | 运营/合规闸门 | canonical |
| 审核台运营 | 运营/审核台运营 | canonical |
| 渠道发行 | 运营/渠道发行 | canonical |
| 运维域总览 | 运维/README | canonical |
| k8s迁移 | 运维/k8s迁移 | canonical |
| 生成容量与并发 | 运维/生成容量与并发规划 | canonical |
| 观测体系 | 运维/观测体系 | canonical |
| 项目上线主计划 | 可行性方案16周-波次映射 | canonical |
| 模块进度总账 | MVP进度总账 | canonical |
| 活任务清单 | MVP作战清单 | canonical |
| 合规闸门看板 | A1闸门看板 | canonical |
| 单位经济模型 | 单位经济敏感性模型 | canonical |
| 人办清单 | 人办清单 | canonical |
| 全成本财务模型 | 全成本收益测算模型-v2 | canonical |
| 内网凭据与端点 | 内网凭据与端点 | canonical |
| 生成引擎执行计划 | 2026-06-25 统一执行计划 | canonical |
| 架构图集(00-07 图说) | 00 系统总览图说 起 8 篇 | 派生视图(域树为 SoT) |
| OpenGame 对照 / WG1 基准 / tier2 spike runbook | 生成引擎子树内同名档 | 参考(非 SoT) |
| MVP 执行 spec | mvp-execution-spec | 视图(主计划之下) |
| 对外演示版 | 总架构图说-对外演示版 | 视图(对外叙事) |
| 在飞设计与计划 | agent-specs/_index | 在飞板 |
3. 六大领域导航
| 领域 | 一句话 | 主文档 |
|---|---|---|
| ① 产品 | 产品对用户提供什么(需求 / RTM / 商业定位 / 护城河) | 产品/ |
| ② 架构 | 系统用什么技术、怎么搭(分层 / 决策 / 13 模块 / 生成引擎) | 架构/ |
| ③ 后端 | 13 个后端业务模块的服务实现视角 | 后端/ |
| ④ 前端 | studio / admin 的设计体系(token / i18n / 主题) | 前端/ |
| ⑤ 运营 | 上线、变现与合规(单位经济 / 渠道发行 / 合规闸门) | 运营/ |
| ⑥ 运维 | 环境、部署、可用性目标 | 运维/ |
生成引擎子树(护城河关键路径,内容最厚):现行 = AgentScope 统一收敛、三档按 AI 参与深度、A-model 直写真 src/ 多文件工程、九门兜底;运行时唯一真相 = agentic运行时架构图说,子树导航 = 生成引擎/README。
看图入口:全部架构图按领域拆成 8 篇编号图说(本目录顶层 00-系统总览图说 起)。图集是派生视图——图文冲突以六域树为准。
4. 怎么按角色读
- 对外演示 / 技术尽调:总架构图说-对外演示版(对外叙事视图,事实源仍是本策展层)。
- 产品 / 运营 / 投资人:产品域 → 运营域。
- 工程师(新加入):架构域 → 你负责的模块(13 模块)→ 相关子树。
- 做生成主线的:生成引擎子树。
- 前端:前端域;运维 / 部署:运维域。
5. 其它去哪找
- 在飞设计与计划:
docs/agent-specs/_index.md(在飞板,唯一入口)。 - 留痕层(检索,不通读):
docs/plans/、docs/brainstorms/、agent-specs 带日期档;历史已清缩,旧档一律 git 找(如git show 6d2f8789^:<旧路径>)。 - 横切进度:MVP进度总账(模块进度单一 SoT = 其 §2 矩阵)。
- AI 速查 / 规则 / 技能:
.agents/(索引在.agents/README.md)。 - 本目录
_archive/与_recall/:域化重构源档(带 tombstone)与创始人判定录,只读留痕。