4e801d5e8a
双查一致性(Codex+Opus)→ 修问题 → 出 plan 全链收口。 修问题(reframe 全活层 doc-sync · 框架统一 AgentScope / 三档按 AI 深度 / 去超休闲 / A-model 写真 src/ / tier2 spike accept · n=5 收敛环 / 预算闸 <¥10·<¥50): knowledge 三件套 + 顶层图说 00/01/02/05 + 6 域 README + 5 mvp 账本 + skill·workflow + agent-specs(_index / 演进路线降留痕);系统性死链 自治富游戏引擎.md → 运行时 SoT repoint(7 档)。 AGENTS.md:§2 收敛上线主计划 SoT、§3.1 入口自审 reframe 对齐。 出 plan:① 生成引擎统一执行计划(新建 · 统一三档 · 吸收退役 06-18-001/06-19-001/003); ② 4 份重复 plan 退役/并入/去两线 banner;③ 可行性方案16周 就地升格为项目上线主计划 SoT(canonical)。 §6.8 双评审(Codex+Opus)6 必修已修:WU-A 真实拓扑+JS留+迁移契约 / A11 孤儿接缝(①WU-B↔③阶段三) / 三档拆清 / ③ 过度表述 / 人办清单 n≥30→n=5 / 死链。 tier2/HANDOFF.md:n≥30→n=5 + agentscope-runtime→2.0.2 Workspace doc-sync banner。 ①③ status=草稿·双评审已过·待创始人确认 F1(WU-A 迁移归属)后转正式。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
绘境AI · 设计文档总索引
这是什么:绘境AI 全部设计文档的唯一入口。无论你是产品、工程师、运营,还是外部评审,都从这里开始。 读它 = 当前真相。这套文档是项目的策展层(curation layer)——经过收敛、只保留一份真值;过程稿、评审记录、历史留痕在别处(见文末"其它去哪找")。 怎么用:先看下面这张全景图认门,再按你的角色跳到对应领域的主文档,需要细节时层层下钻。 看图入口(架构图集):全部架构图(系统级 + 七领域 ≈ 71 张图 + 讲解)按领域拆成 8 篇编号文档(
00-系统总览+01–07各域,均在本目录顶层)→ 从 00 · 系统总览图说(总图 + 目录)进,看图加讲解读懂整个系统、据图 review 设计有没有缝。
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. 六大领域导航
| 领域 | 一句话 | 主文档 |
|---|---|---|
| ① 产品 | 产品对用户提供什么(需求 / RTM / 商业定位 / 护城河) | 产品/ |
| ② 架构 | 系统用什么技术、怎么搭(分层 / 决策 / 13 模块 / 生成引擎) | 架构/ |
| ③ 后端 | 13 个后端业务模块的服务实现视角 | 后端/ |
| ④ 前端 | studio / admin 的设计体系(token / i18n / 主题) | 前端/ |
| ⑤ 运营 | 上线、变现与合规(单位经济 / 渠道发行 / 合规闸门) | 运营/ |
| ⑥ 运维 | 环境、部署、可用性目标 | 运维/ |
架构域 · 生成引擎旗舰子树
生成引擎是绘境AI 护城河的关键路径,内容最厚,单独成一棵子树。🚧 注意:这块架构正处于演进中 —— 廉价线 gameDefinition 已废(错误路线),现行 = A-model 写真 src/(LLM 在 LittleJS 增强发行版上直接写真多文件源工程 + 调插件库 + 九门 harness 兜底);tier2 富游戏自治轨建设中(0 号 spike accept)。子树内结论可能随推进变化,以运行时 SoT agentic运行时架构图说 与最新裁定为准:
| 子文档 | 讲什么 |
|---|---|
| 生成引擎/ | 子树主档:一句话→游戏的现行架构 + 演进路线 + 范式原则 |
| 生成运行时架构图说 | 两条线统一的运行时架构 SoT:adapter 协议层、SAA·LittleJS 廉价线与 AgentScope·Phaser 富游戏两实例、固定游戏架构、SAA 编排与能力 API、引擎与运行时、开闸接线、设计合理性裁决等已并入此档 |
| 验收门 W-G1 | 一句话生成开闸的多道确定性验收门 |
| prompt 治理 | Prompt 作为第 8 契约的治理体系 |
| OpenGame 对照 | 外部标杆深读 + 复刻缺口 |
| W-G1 基准 | 20 款经典轻游戏靶集 + 缺口诊断 |
3. 怎么按角色读
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。