zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
games-development-ai/docs/agent-specs/2026-06-16-技术决策版重写-review.md
zizi 8e7ace3ec3 docs(architecture): 核心设计档全线对齐现行真相（技术决策版/开发团队版/投资人版/护城河） 
承接核心设计文档真相对齐，创始人批『全部核心档一起对齐』。废弃选型(Dify/OpenGame/自研Canvas/ComfyUI/AgentScope)曾被当现行架构详述，新接手照信即落废栈。

技术决策版(架构基线 1528→1562)：4 张 Mermaid 重画(DIFY/OG/COMFY/CANVAS_RT→new-api/SAA/mmx/LittleJS)+3 选型表翻面+删虚构字段 dify_workflow_id+MQ/Nacos 标 future-state(框架自带·MVP未部署)+顶部横幅升 v2.1+决策索引补 6 行。

开发团队版(13处)/投资人版(8处)/护城河(5处)：事实性技术栈改现行，工程目标态细节+护城河论述/愿景保留；Doc B 那处 AgentScope 已是『作废→SAA』现行标注。事实核查据 contracts/+game-cloud 实测。Mermaid 结构校验通过未真渲染→建议 mini-desktop 终确认。待定夺=成本或高估(¥4,300按纪律未改)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 12:24:46 +00:00

6.6 KiB
Raw Blame History

技术决策版重写 — 计划（评审版）

状态: 已执行（2026-06-16，创始人批"全部核心档对齐"：技术决策版/开发团队版/投资人版/护城河话术 4 档已对齐；Doc B 那处 AgentScope 已是"作废→SAA"现行标注无需改） · 更新: 2026-06-16 目标档：docs/architecture/系统概要设计-技术决策版.md（AGENTS §4 必读·架构基线，1527 行） 由来：2026-06-16 目录治理追问"哪些核心设计档需重写"——审计实测此档 96 处废弃选型词 vs 11 处现行词，是唯一真·过期权威基线（详见 2026-06-16-agent-specs目录治理-review.md）。

结论（先读）

  1. 问题：此档是钦定架构基线、新接手都信它，却把 Dify/OpenGame/自研Canvas/ComfyUI 当现行架构详述（含 4 张 Mermaid 图把它们画成现行拓扑）→ 照信即落废栈。顶部虽有"转模板驱动"横幅，正文未对齐。
  2. 推荐：逐节改写，不降级为历史。理由——它无替代基线（tech-decisions.md 是日常蒸馏入口、Doc B 只讲 13 模块 HOW，都不覆盖全决策画面），降级会留基线真空，违背"无孤儿设计"；且 ~80% 内容现行有效，过期集中在"生成引擎/Tier1引擎/素材工具链/agentic基建"四线、点状分布，逐节替换即可，约 200–230 行改动。
  3. 我不在批准前动正文。本档是待批计划。

改动分布（按处置归类，子代理全节审计已出逐行地图）

类 涉及节 量 处置
重画 Mermaid（高风险） §2.3 模式A时序图、§3.1 整体分层、§3.2 部署拓扑、§6.9 工具层全景 ~75 行 4 图含 DIFY/OG/COMFY/NACOS/RocketMQ/CANVAS_RT 参与者+连线，整图重画为 new-api 网关→LLM + SAA 编排 + mmx-cli + LittleJS/Runner v2
翻面选型表 §4.1 生成链路、§6.2 AI引擎、§6.6 运行时、§6.7 素材 ~70 行 ✅Dify/OpenGame/ComfyUI/自研Canvas → ❌MVP不用/远期；新增 ✅模板驱动+new-api / ✅LittleJS / ✅mmx-cli / ✅SAA
枝节单行 §1.3、§3.3、§5.1 ER、§5.2、§5.3、§7.1/7.5/7.6/7.8/7.10、§8 风险#1/#4/#5、§10 成本、§11 术语/索引 ~40 行（~30 处） 删/改 Dify/Nacos/RocketMQ 字样为现行口径
新增/补 顶部横幅升 v2、§11.2 决策索引 ~15 行 横幅补 SAA/LittleJS/mmx/W-CLEAN/命名空间 5 条裁定；索引补对应行
保留（现行有效，不动） §1 业务、§2 产品工作台、§3.4 SDK、§4.2 运行时链路、§4.3 推荐、§6.1/6.3/6.4 框架、§7.3–7.9、§8 风险#2/3/6–14、§10 成本骨架 0 与选型无关或已是现行口径

现行真相口径（重写基准 6 条）

  • 生成主线 = 模板驱动 via new-api 网关；Dify/OpenGame 降 long-term、MVP 从不部署。
  • Tier1 引擎 = LittleJS 增强发行版（55KB gz，勿写 13/15KB 旧数）+ Runner v2 装载契约 game-host.d.ts；自研 Canvas<15KB 已废除。
  • 模板 = LittleJS 插件；玩法模板层已废除（W-CLEAN），玩法/美术/关卡/UI=agent 生成域；Tier2-3=Cocos+MCP。
  • agentic 基建 = SAA(Spring AI Alibaba GA v1.1.2.2)裸图编排（HJ-AGI-002）；AgentScope 降 long-term premium。
  • 美术/音乐 = mmx-cli；ComfyUI 退备选。
  • 命名空间 = com.wanxiang.huijing；RocketMQ/Nacos = future-state 未部署；品牌=绘境AI。

风险 + 硬约束

  • Mermaid 重画是唯一高风险（改坏语法→图不渲染）：重画后须语法校验/预览。
  • 事实核查、勿臆造：dify_workflow_id(§5.1 L949) 改名、§3.3/§5.3/§7.8 的 RocketMQ/Nacos "是否真未部署" —— 必须据 contracts/ + DB Flyway + tech-decisions.md 核 MVP 现状后据实改，不可凭口径把 future-state 规划误删成"不存在"。
  • 已核实（2026-06-16，据 contracts/+game-cloud 实测）：
    • ① RocketMQ/Nacos：框架(yudao fork)自带依赖（rocketmq 4 poms / nacos 7 poms）+ 10 处 yaml 配置存在，但 MVP 运行时未部署 broker/registry → 重写一律标 future-state（框架自带、MVP 未启用），勿删、勿写成"不存在"。
    • ② dify_workflow_id：Flyway 0 + 代码/契约 0 = 虚构字段、从未实现 → ER 中直接删（无 schema 影响）。
    • ③ new-api（14 文件）/ SAA spring-ai-alibaba（1 pom）= 后端真接入 → 作现行口径写实有据。
  • 投资人版/护城河话术含同类词，但面向投资人、可能有意保留愿景表述——不在本档范围，单独定。

执行方式（批准后）

  1. 派 1 个 opus 子代理按 5 步顺序执行：顶部横幅 v2 → 4 张 Mermaid 重画 → 3 张选型表翻面 → 枝节单行 → 索引补全。
  2. 主代理负责：事实核查（MQ/Nacos/字段名据 contracts 核实）+ Mermaid 渲染校验 + 终审。
  3. 同步评估其它核心档：开发团队版（48 处废弃词）——是逐节改写还是强化其"别信、看 .agents"降级横幅；Doc B（1 处 AgentScope）顺手改。

待你确认（已答复：全部核心档一起对齐 ✓ 已执行）

  1. 批准"逐节改写、不降级"方向？ → 已批准并执行。
  2. 范围 → 全部核心档（技术决策版/开发团队版/投资人版/护城河话术）已对齐。
  3. 投资人版/护城河 → 已对齐：事实性技术栈改现行，护城河论述/愿景保留。

执行后 · 待创始人定夺（R3 投资人向 flag，均不影响已对齐的技术口径，纯商业指标）

  1. 月成本可能高估：现行无独立自建 AI 推理/GPU 机（生成走 new-api 外部 API、SAA 进程内跑后端 JVM、美术走 mmx-cli 外部）——投资人版 §7.1 服务器档位/月成本实际可能 < ¥4,300。按纪律未改总额，是否下修？
  2. LLM 单次成本：W-G1 实测便宜模型 ¥0.01–0.03/款（经 new-api）< BP 假设的 ¥0.05–0.1，是否下修以强化资本效率叙事？
  3. mmx-cli quota：已替代 ComfyUI 进入美术/音乐线，是否在对外成本表单列一行 mmx API 费（创始人已要求"盯用量=quota 对账入成本台账"）？

验证留痕（2026-06-16）

  • 技术决策版：54 围栏(偶)、18 Mermaid、旧节点 ID(OPENGAME/CANVAS_RT/COMFY) 残留 0、dify_workflow_id 0、participant DIFY 0；MQ/Nacos 25 处保留并标 future-state。
  • 4 张 Mermaid 经结构校验（围栏平衡+标签引号+零旧节点 ID）通过；未在本机真渲染（chrome/mmdc 受限）→ 建议 mini-desktop 或浏览器扫一眼 4 图终确认。