games-development-ai/docs/architecture/README.md

# 绘境AI · 设计文档总索引 + SoT 注册表

> **这是什么**:绘境AI 全部设计文档的**唯一入口**,以及全项目 canonical 文档的**注册表**(机器对账,`docs-gate` G2 门守护)。
> **读它 = 当前真相**。本目录是策展层——每个主题只保留一份真值;过程稿与历史在 git(见文末"其它去哪找")。
> **怎么用**:先查 §2 注册表锁定主题的 SoT;做架构级任务按 §3 六域导航下钻;**任何新设计开工前必须先查注册表**(见 [`feature-design-doc`](../../.agents/skills/feature-design-doc.md)),避免漏读既有设计。

---

## 1. 文档怎么组织:四级结构

设计文档按产品生命周期的六个领域组织,每个领域内部分四级(L1 总索引=本页 → L2 领域主文档 → L3 模块子文档 → L4 详细展开):

```mermaid
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](产品/README.md) | canonical |
| 产品需求清单 | [产品/需求清单](产品/需求清单.md) | canonical |
| 需求模块映射 | [产品/需求模块映射](产品/需求模块映射.md) | canonical |
| 商业定位 | [产品/商业定位](产品/商业定位.md) | canonical |
| 护城河话术 | [产品/护城河话术](产品/护城河话术.md) | canonical |
| 架构域总览 | [架构/README](架构/README.md) | canonical |
| 13模块注册表 | [架构/13模块](架构/13模块.md) | canonical |
| 产物执行沙箱 | [架构/产物执行沙箱](架构/产物执行沙箱.md) | canonical |
| 契约总览 | [架构/契约总览](架构/契约总览.md) | canonical |
| 生成引擎子树总览 | [架构/生成引擎/README](架构/生成引擎/README.md) | canonical |
| 生成引擎运行时 | [agentic运行时架构图说](架构/生成引擎/agentic运行时架构图说.md) | canonical |
| 生成验收门 | [生成引擎/验收门](架构/生成引擎/验收门.md) | canonical |
| prompt治理 | [生成引擎/prompt治理](架构/生成引擎/prompt治理.md) | canonical |
| 数据飞轮 | [生成引擎/数据飞轮](架构/生成引擎/数据飞轮.md) | canonical |
| 游戏质量与爆火能力 | [生成引擎/游戏质量与爆火能力](架构/生成引擎/游戏质量与爆火能力.md) | canonical |
| 后端域总览 | [后端/README](后端/README.md) | canonical |
| 数据模型 | [后端/数据模型](后端/数据模型.md) | canonical |
| 鉴权与权限 | [后端/鉴权与权限](后端/鉴权与权限.md) | canonical |
| 前端设计体系 | [前端/README](前端/README.md) | canonical |
| 运营域总览 | [运营/README](运营/README.md) | canonical |
| 变现与单位经济 | [运营/变现与单位经济](运营/变现与单位经济.md) | canonical |
| 变现端到端 | [运营/变现端到端](运营/变现端到端.md) | canonical |
| 合规闸门 | [运营/合规闸门](运营/合规闸门.md) | canonical |
| 审核台运营 | [运营/审核台运营](运营/审核台运营.md) | canonical |
| 渠道发行 | [运营/渠道发行](运营/渠道发行.md) | canonical |
| 运维域总览 | [运维/README](运维/README.md) | canonical |
| k8s迁移 | [运维/k8s迁移](运维/k8s迁移.md) | canonical |
| 生成容量与并发 | [运维/生成容量与并发规划](运维/生成容量与并发规划.md) | canonical |
| 观测体系 | [运维/观测体系](运维/观测体系.md) | canonical |
| 项目上线主计划 | [可行性方案16周-波次映射](../mvp/可行性方案16周-波次映射.md) | canonical |
| 模块进度总账 | [MVP进度总账](../mvp/MVP进度总账.md) | canonical |
| 活任务清单 | [MVP作战清单](../mvp/MVP作战清单.md) | canonical |
| 合规闸门看板 | [A1闸门看板](../mvp/A1闸门看板.md) | canonical |
| 单位经济模型 | [单位经济敏感性模型](../mvp/单位经济敏感性模型.md) | canonical |
| 人办清单 | [人办清单](../mvp/人办清单.md) | canonical |
| 全成本财务模型 | [全成本收益测算模型-v2](../mvp/全成本收益测算模型-v2.md) | canonical |
| 内网凭据与端点 | [内网凭据与端点](../内网凭据与端点.md) | canonical |
| 生成引擎执行计划 | [2026-06-25 统一执行计划](../plans/2026-06-25-生成引擎统一执行计划-AgentScope三档-plan.md) | canonical |
| 架构图集(00-07 图说) | [00 系统总览图说](00-系统总览图说.md) 起 8 篇 | 派生视图(域树为 SoT) |
| OpenGame 对照 / WG1 基准 / tier2 spike runbook | 生成引擎子树内同名档 | 参考(非 SoT) |
| MVP 执行 spec | [mvp-execution-spec](../superpowers/specs/mvp-execution-spec-design.md) | 视图(主计划之下) |
| 对外演示版 | [总架构图说-对外演示版](绘境AI-总架构图说-对外演示版.html) | 视图(对外叙事) |
| 在飞设计与计划 | [agent-specs/_index](../agent-specs/_index.md) | 在飞板 |

## 3. 六大领域导航

| 领域 | 一句话 | 主文档 |
|---|---|---|
| **① 产品** | 产品对用户提供什么(需求 / RTM / 商业定位 / 护城河) | [产品/](产品/README.md) |
| **② 架构** | 系统用什么技术、怎么搭(分层 / 决策 / 13 模块 / **生成引擎**) | [架构/](架构/README.md) |
| **③ 后端** | 13 个后端业务模块的服务实现视角 | [后端/](后端/README.md) |
| **④ 前端** | studio / admin 的设计体系(token / i18n / 主题) | [前端/](前端/README.md) |
| **⑤ 运营** | 上线、变现与合规(单位经济 / 渠道发行 / 合规闸门) | [运营/](运营/README.md) |
| **⑥ 运维** | 环境、部署、可用性目标 | [运维/](运维/README.md) |

**生成引擎子树**(护城河关键路径,内容最厚):现行 = AgentScope 统一收敛、三档按 AI 参与深度、A-model 直写真 `src/` 多文件工程、九门兜底;运行时唯一真相 = [agentic运行时架构图说](架构/生成引擎/agentic运行时架构图说.md),子树导航 = [生成引擎/README](架构/生成引擎/README.md)。

**看图入口**:全部架构图按领域拆成 8 篇编号图说(本目录顶层 [00-系统总览图说](00-系统总览图说.md) 起)。图集是**派生视图**——图文冲突以六域树为准。

## 4. 怎么按角色读

- **对外演示 / 技术尽调**:[总架构图说-对外演示版](绘境AI-总架构图说-对外演示版.html)(对外叙事视图,事实源仍是本策展层)。
- **产品 / 运营 / 投资人**:[产品域](产品/README.md) → [运营域](运营/README.md)。
- **工程师(新加入)**:[架构域](架构/README.md) → 你负责的模块([13 模块](架构/13模块.md))→ 相关子树。
- **做生成主线的**:[生成引擎子树](架构/生成引擎/README.md)。
- **前端**:[前端域](前端/README.md);**运维 / 部署**:[运维域](运维/README.md)。

## 5. 其它去哪找

- **在飞设计与计划**:[`docs/agent-specs/_index.md`](../agent-specs/_index.md)(在飞板,唯一入口)。
- **留痕层**(检索,不通读):`docs/plans/`、`docs/brainstorms/`、agent-specs 带日期档;历史已清缩,**旧档一律 git 找**(如 `git show 6d2f8789^:<旧路径>`)。
- **横切进度**:[MVP进度总账](../mvp/MVP进度总账.md)(模块进度单一 SoT = 其 §2 矩阵)。
- **AI 速查 / 规则 / 技能**:`.agents/`(索引在 [`.agents/README.md`](../../.agents/README.md))。
- **本目录 `_archive/` 与 `_recall/`**:域化重构源档(带 tombstone)与创始人判定录,只读留痕。