ec7fda2cee
review 暴露生成域正处于 gameDefinition→src/ 终态迁移 + 产线化(plan 2026-06-18-001 U1–U4)。给 11 份子树档插「🚧 架构演进中」横幅 + L1 总索引/架构 README 导航处加注,提示现行结论可能随 plan 推进变化、以最新裁定为准。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
85 lines
4.9 KiB
Markdown
85 lines
4.9 KiB
Markdown
# 绘境AI · 设计文档总索引
|
||
|
||
> **这是什么**:绘境AI 全部设计文档的**唯一入口**。无论你是产品、工程师、运营,还是外部评审,都从这里开始。
|
||
> **读它 = 当前真相**。这套文档是项目的策展层(curation layer)——经过收敛、只保留一份真值;过程稿、评审记录、历史留痕在别处(见文末"其它去哪找")。
|
||
> **怎么用**:先看下面这张全景图认门,再按你的角色跳到对应领域的主文档,需要细节时层层下钻。
|
||
|
||
---
|
||
|
||
## 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. 六大领域导航
|
||
|
||
| 领域 | 一句话 | 主文档 |
|
||
|---|---|---|
|
||
| **① 产品** | 产品对用户提供什么(需求 / RTM / 商业定位 / 护城河) | [产品/](产品/README.md) |
|
||
| **② 架构** | 系统用什么技术、怎么搭(分层 / 决策 / 13 模块 / **生成引擎**) | [架构/](架构/README.md) |
|
||
| **③ 后端** | 13 个后端业务模块的服务实现视角 | [后端/](后端/README.md) |
|
||
| **④ 前端** | studio / admin 的设计体系(token / i18n / 主题) | [前端/](前端/README.md) |
|
||
| **⑤ 运营** | 上线、变现与合规(单位经济 / 渠道发行 / 合规闸门) | [运营/](运营/README.md) |
|
||
| **⑥ 运维** | 环境、部署、可用性目标 | [运维/](运维/README.md) |
|
||
|
||
### 架构域 · 生成引擎旗舰子树
|
||
|
||
生成引擎是绘境AI 护城河的关键路径,内容最厚,单独成一棵子树。**🚧 注意:这块架构正处于演进中**(gameDefinition→`src/` 终态迁移 + 产线化 plan `2026-06-18-001` U1–U4),子树内标注的现行结论可能随推进变化,以最新裁定 / plan 为准:
|
||
|
||
| 子文档 | 讲什么 |
|
||
|---|---|
|
||
| [生成引擎/](架构/生成引擎/README.md) | 子树主档:一句话→游戏的现行架构 + 演进路线 + 范式原则 |
|
||
| [固定游戏架构](架构/生成引擎/固定游戏架构.md) | 轻量声明式领域模型 + SAA 智能工作室 + 8 契约 + 救场阶梯 |
|
||
| [SAA 编排](架构/生成引擎/SAA编排.md) | 裸图 StateGraph 16 节点编排 + 六不变量 + 双脑防线 |
|
||
| [引擎与运行时](架构/生成引擎/引擎与运行时.md) | LittleJS 增强发行版 + Runner v2 两层装载契约 |
|
||
| [验收门 W-G1](架构/生成引擎/验收门-W-G1.md) | 一句话生成开闸的多道确定性验收门 |
|
||
| [prompt 治理](架构/生成引擎/prompt治理.md) | Prompt 作为第 8 契约的治理体系 |
|
||
| [设计合理性裁决](架构/生成引擎/设计合理性裁决.md) | 核心生成设计的对抗审查裁决与四改 |
|
||
| [OpenGame 对照](架构/生成引擎/OpenGame对照.md) | 外部标杆深读 + 复刻缺口 |
|
||
| [W-G1 基准](架构/生成引擎/WG1基准.md) | 20 款经典轻游戏靶集 + 缺口诊断 |
|
||
| [SAA 能力 API dossier](架构/生成引擎/SAA能力API-dossier.md) | SAA 接入的逐键源码证据底座(参考档) |
|
||
| [开闸接线](架构/生成引擎/开闸接线.md) | 一句话入口到首局可玩的端到端接线 |
|
||
|
||
---
|
||
|
||
## 3. 怎么按角色读
|
||
|
||
- **产品 / 运营 / 投资人**:[产品域](产品/README.md) → [运营域](运营/README.md)。
|
||
- **工程师(新加入)**:[架构域](架构/README.md) → 你负责的模块([13 模块](架构/13模块.md))→ 相关子树。
|
||
- **做生成主线的**:直接进[生成引擎子树](架构/生成引擎/README.md)。
|
||
- **前端**:[前端域](前端/README.md)。
|
||
- **运维 / 部署**:[运维域](运维/README.md)。
|
||
|
||
---
|
||
|
||
## 4. 其它去哪找
|
||
|
||
本目录是**策展层**(只保留现行真相)。其余内容:
|
||
|
||
- **过程稿与历史**:`docs/agent-specs/_archive/`、`docs/architecture/_archive/`(被本套文档取代的旧档,留 git 痕)。
|
||
- **任务喂料**:`docs/brainstorms/`(需求 WHAT)、`docs/plans/`(方案 HOW)。
|
||
- **横切进度账本**:`docs/mvp/MVP进度总账.md`(模块进度唯一 SoT)。
|
||
- **给 AI agent 的速查 / 规则 / 技能**:`.agents/`。
|
||
- **专项跟踪面**:合规闸门 → `docs/mvp/A1闸门看板.md`;单位经济 → `docs/mvp/单位经济敏感性模型.md`。
|