zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
games-development-ai/docs/plans/2026-06-25-生成引擎统一执行计划-AgentScope三档-plan.md
lili 4d220e77da
Some checks failed
docs-gate / docs-gate (push) Has been cancelled
Details
docs(轨2+板): 质量模型与回流环两设计档(双评审已修·决策包⑦已批定稿)+ 工单板对账(阶段一②收口/决策②⑥⑦落账/R6+rubric落库前置工单/在飞板/06-29§7) 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 19:31:53 -07:00

45 KiB
Raw Blame History

title, status, topic, date, updated, canonical, 上级, supersedes, absorbs, design_sot
title status topic date updated canonical 上级 supersedes absorbs design_sot
feat: 生成引擎统一执行计划 — 执行序列(纵切成果切片 · 执行 SoT) 正式 · 2026-06-26 换轴重构(关注面横切 WU-A..F → 成果纵切三切片;WU 降为设计面对账)· 换轴版已过 Codex + Opus 双评审(plan 双评审门,必修已修;Opus 四维度专项 + Codex 四维度专项末轮重连完整产出、10 项发现已采纳修复)· WU-A 便宜档框架对照已坐实(三品类 equivalent) 生成引擎执行计划 2026-06-25 2026-06-26 true docs/mvp/可行性方案16周-波次映射.md
自身 2026-06-25 横切 WU 主轴版(本次换轴为纵切执行序列;WU-A..F 全部内容保留为 §7 设计面对账,git 留演进痕)
docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md(SAA 主线骨架退役;有效项入切片一与基建线)
docs/plans/2026-06-19-001-feat-coredone-验收闭环执行-plan.md(验收闭环入切片一的达标门与各切片九门)
docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md(复杂档整体入切片二;U1–U10 作子计划保留引用)
docs/architecture/架构/生成引擎/agentic运行时架构图说.md

生成引擎统一执行计划(执行序列)

§0 · 生成引擎执行总览

顶部 SVG 是 2026-06-26 换轴前的横切 WU 版,纵切执行序列以 §5 的切片依赖图与 §4 各节为准;SVG 待 redraw 成切片序列图(列入 §11 收口 TODO)。

Summary

这条生成线的执行此前按关注面横切成六个工作单元(框架 WU-A、实例 WU-B、八面 WU-C、采标准 WU-D、控制面 WU-E、验收门 WU-F)。这套切分把设计 SoT 的八个关注面与六条 build-vs-buy 决策落地管得很清楚,却不是一条能照着走的执行序列:一个真实成果——“便宜档能达标上线”“tier2 富游戏走不走定了”——纵向穿过这几个关注面,要框架、实例、校验、标准、门一起到位才算交付。按 WU 横向一个面一个面推进,就会在纵向成果上反复回头补前一个面没做够的部分。

2026-06-26 换轴:执行主轴改成按可交付成果纵切的切片。当前剩余工作是三条相对独立的成果线——便宜档达标上线、tier2 富游戏 go/no-go、A11 对话式调整回路,外加一条按需生长的基建线;协议定级与 6 ADR 已冻,作采标准落地的基线。每个切片自带它需要的框架、实例、校验、标准、门,做完就是一个能验收的成果,不回头。WU-A..F 不丢,降为 §7 的设计面对账——它仍是把设计 SoT 八面与六 ADR 落地的结构索引,后续每个切片细化时按它下钻设计。

§1 本文定位:三层文档,各管一层

生成线的文档分三层,职责不重叠:

层 文档 回答什么 粒度
设计 SoT agentic运行时架构图说.md 引擎长什么样、为什么这么设计(§一命题 / §二补三 6 ADR / §三 A1–A13 协议 / §四三档 / §五八面) 架构关注面
执行序列 SoT(本文) 本文件 按什么顺序一步步推到上线 切片 / 里程碑
切片细化 plan docs/plans/ 下各切片细化档(如 002 multi-genre(git show git show 8ea97234:docs/plans/2026-06-26-002-feat-cheap-worker-multi-genre-plan.md) 之于 WU-A) 某个切片具体怎么实现(实现单元 / 文件 / 测试场景) 代码级

后续每个切片开工前,据设计 SoT 产一份它的细化 plan,再交付执行。

§2 执行现状

三档逐档的“已落 vs 待办”,是切片划分的事实基础。

便宜档(轻-中 AI 深度 · LittleJS · A-model · Tier0/1)

已落:A-model 写真 src/ 多文件范式现行(取代已废的 gameDefinition 与 new Function 路),落点 game-runtime/tools/amodel-gen/ 加 game-runtime/games/_wg1-gen/;12 插件能力库(8 基元 + 4 编排:scene-fsm / hud-ui / session-score / timer-scheduler)加 sim-business 配方;九门 harness 引擎无关、生产已跑、判过大量游戏。WU-A 框架收敛已坐实:便宜档生成核心已从 Node/SAA-Java 双轨整条用 Python 重写进 AgentScope,三个 tap-targets 品类(点击得分 / 打地鼠 / 经营点客)金标 play-spec 对照 Python ≈ Node 全部 equivalent,无回退品类——框架等价成立,这是切片一头号风险 R1 三道闸的第一道。

待办:减摩擦(阶段一B)已落——15 处 L2 API 母语化,代码质量明显提升(创始人 2026-06-29 确认),治住了一批生成幻觉;但 ≥80% 达标门仍未跑(跨品类过门率未复测)。〔2026-07-02 校正:达标门已跑绿——丰富两步(sim-business 设计指导接入 + LLM 丰富度验证 agent)落地后,bake-off-M1-rich 三品类各 5/5、overallMeets=true(lab 口径,详见 §4 切片一起点校正);剩余质量项 = 生产真实分布复验,归 M3 cutover plan S5。〕这几轮还浮现一条新主缺口:生成丰富度——游戏能跑能过九门却偏薄,玩法/美术/音乐深度不足;按架构红线,丰富的「生成」归生成 agent(据 sim-business-game-design 设计 + 组合插件)、「校验」归纯 LLM 验证 agent(非阻塞),代码 / 脚手架 / 九门都不碰。per-gen < ¥10 硬闸已接线(熔断真跑可见);Node 旧路退役机制部件已落,但退役门(达标 + 对照等价)未达。这些是切片一的内容(详见 §4 切片一里程碑 2026-06-29 修正 + 下方完成度快照)。

复杂档(最高 AI 深度 · Phaser · tier2 · Tier2)

已落(基准 = tier2/HANDOFF.md):U1–U7 核心生成线(种子 fork + 有界外层 resume + Phaser validate/run/prompt/roles 重写)、Phaser CDP 探针加九门加富游戏三门(三联动 / 经济 / latch)、四道收敛契约机器门、mmx 资产工具、M3 Anthropic 接法加成本取证、Tier2TraceMiddleware→TraceAdapter(真跑 647 事件 dropped=0、cost_rmb ¥1.29)、n=5 收敛环批跑底座、服务化部署 mini-desktop:8200(Agent Service 加落库 MySQL + MinIO)。0 号 spike feie-005 = decision accept(n=1 机制验证)。

待办:n=5 收敛环 go/no-go 未定;DockerWorkspace 托管 CDP harness 小验(收敛环前置阻断项)未做;偏脆的文本契约门未做成结构化校验。这些是切片二的内容。〔2026-07-02 校正:三项均已于 06-28/29 由 runbook 06-28-002 执行——小验裁定收敛环走 in-process(DockerWorkspace 转 Phase B);validate_play_scene 已 AST 结构化;收敛环真跑判 go/no-go = conditional(瓶颈 = M3 自调「赢的条件 / 经济平衡」不稳,创始人纠正退路在 agent 层非工具层;confound = live 资源争用未除)。剩余 follow-up = verdict 反馈质量改进 + 干净复跑 + 强档对照(待网关)+ 平衡门判法重审,工单见 runbook「后续工单」节。〕

横切(控制面 · 观测 · 采标准)

已落:D12 运行治理门现行(默认关闭,在 SAA Java 后端);tier2 侧 OTel 映射全部已落并真跑;contracts/trace/ additive 事件契约位已立。

待办:配置注册表运行时热取、推广到 skill/tool/mcp、配置审计日志、管理面 phase-1;6 条 build-vs-buy ADR 分批落地;统一 trace 公共核心子集契约定稿。这些是基建线与采标准落地的内容。

A11 对话式调整回路(确定性覆写 + 模块重生成)代码已全落地、本机逐段验证通过,只剩受计费真后端 e2e 等部署窗口,是切片三的内容。

切片完成度快照(2026-06-29)

按三切片成果纵切看:切片三近完成;切片一与切片二的地基都在,但各自的核心成果(M1 达标门 / n=5 go-no-go)还没交付。切片一在这几轮还浮现出一条新的主缺口——生成出来的游戏能跑能过九门,却偏薄、不够丰富(玩法/美术/音乐深度不足)。

切片 状态 已落 剩
一 · 便宜档达标 M1 lab达标 ✅ · M2 授权 ✅ · M3 路由 go-live ✅ WU-A 框架对照坐实(三品类 equivalent)· 减摩擦阶段一B(15 处 L2 API 母语化、代码质量提升、创始人确认)· Node→Python 退役机制部件(route seam / trace parity) M3 对外开闸放量(control-plane 6 门 default false 未开)+ 生产真实分布 ≥80% 复验(质量轨 WU-B/C/F)+ live worker 更新到本轮 M1 富化代码;M3 路由 cutover 已 2026-06-28 go-live(创始人批,live :48080 退 Node/gamedef、上 Python M3 路 dispatcher=http),细化见 2026-06-30 M3 cutover plan
二 · tier2 go/no-go 地基 ✅ · 收敛环已跑 → conditional(06-28/29) U1–U7 核心 + 服务化 @8200 + 观测 + 落库 · 0 号 spike accept(n=1)· runbook U1–U4(harness 小验 / 批级护栏 / 退路树 n5 / AST 结构化门)· U5 收敛环真跑 verdict 反馈质量改进(agent 层 win-balance)· 干净复跑(待窗口)· 强档对照(待网关)· 平衡门判法重审
三 · A11 调整回路 🟢 ~90% M1–M5 代码全完成 + 本机逐段验证 + 6 提交(dev/2.0.0) 受计费真后端 e2e(排部署窗口、不动 live)
基建线 部分 部分 trace / 配置 配置热取三件 + 公共 trace 五字段 + 管理面 phase-1,按需生长未全铺

「便宜档达标上线」三步 M1(达标 + 丰富)→ M2(退役门)→ M3(真上线):M1 lab达标 ✅ · M2 退役授权 ✅ · M3 路由 cutover 已 2026-06-28 go-live ✅;剩 = M3 对外开闸放量 + 生产真实分布 ≥80% 复验(见 2026-06-30 M3 cutover plan);真上线另卡 16 周日历闸门(备案 / ICP / 渠道审核)。

§3 为什么纵切:关注面横切会返工

WU-A..F 是六个关注面,不是六个时间阶段。把它们当执行序列串行推进,会在三个地方反复返工,根源都是“一个成果的目标和它的实现手段被切到了不同的 WU”:

  1. 便宜档达验收。目标挂在 WU-B(实例就位),但实现手段——生成质量护栏、生产自验 play-spec 自动生成——在 WU-C 5.4,达标判定在 WU-F。做 WU-B 这块时手里没有任何实现工具,要回头做 C 和 F 才能推进。
  2. tier2 收敛环。同一件事被切成四块:跑收敛环(WU-B)、DockerWorkspace harness 前置(WU-D 的 ADR-6 子项)、结构化契约门(WU-C 5.4)、go/no-go 判定(WU-F)。要四个 WU 的零件同时在手才跑得动一次收敛环。
  3. 控制面与采标准。控制面切成 WU-C 5.2 加 WU-E 两段(WU-E 自己定义为“WU-C 5.2 的后期深化”);六条 ADR(WU-D)又交织进 WU-C 的四个面(5.2 配置热取、5.5 工具协议、5.6 任务协议、5.7 观测)。

纵切消解这三处返工:每个切片把它要的全部关注面一次性纳进来,做完即交付。横切的 WU 结构不作废——它换个角色,作 §7 的设计面对账,保证纵切切片在落地时仍能按八面下钻设计 SoT、不丢架构一致性。

§4 执行序列(主轴)

三切片按价值排序串行:便宜档达标先(阶段一主力、本机可跑、无前置、直接接 WU-A 刚坐实的框架等价),tier2 go/no-go 次(决断价值最高,但有 harness 与机器前置),A11 调整回路后(接产品对话式创作出口)。切片一与切片二之间无强依赖;切片三依赖切片一已就位的便宜档实例与 A2A/D12 配额基础设施(切片一 M2/M3 建成),故排在其后。基建线横穿三切片、按需生长;A1–A13 定级与 6 ADR 已冻、供采标准落地(非待拍阻塞),切片二的技术前置是 harness 小验。

切片一 · 便宜档达标上线

目标:便宜档(Tier0/1 · LittleJS · A-model)从框架已迁、九门 3/5,推到稳定 ≥80% 达标并端到端上线,Node 旧路退役。

起点:WU-A 已把生成核心重写进 Python/AgentScope,三品类金标对照 Python ≈ Node 全 equivalent(框架等价坐实,R1 第一道闸过)。〔2026-06-30 校正:早期"五款 3/5、卡两类品类生成幻觉"已被 sim-business 设计指导 + LLM 丰富度验证 agent(切片一 2026-06-29/30 落地)超越——本会话 M1-rich 全 3 品类各 5/5=100% 过九门、整体达标(cheap-worker/results/bake-off-M1-rich.json overallMeets=True,richnessByGenre 佐证为 richness 正路、非已废 reskin);M2 退役授权据此 authorized=True。〕

里程碑(降 AI 参与质量地基 → 三步上线递进):

  • 降 AI 参与 · 减摩擦 + 扩模板覆盖(生成质量地基 → 喂 M1 达标门 · 细化设计 2026-06-29-便宜档降AI参与-减摩擦与扩模板覆盖-设计,Codex+Opus 双评审)。把便宜档 3/5 推向 ≥80% 的质量杠杆有两条(证据驱动、量级不对等):减摩擦(小头,点击得分已验现状方言产同款要 ~26× token、含学 API 税)——L2 插件 API 直接改签名向模型母语直觉对齐(不为 live 保兼容、存量重生成)+ 清掉教错的学习材料(collision.pointInRect 不存在 / 漂移范例 / 11-12 口径)+ 重写形状门判据(不退役);扩模板覆盖(大头但难品类零数据,须先取数据点)——五品类玩法模板实体化为 per-genre 脚手架 + 品类路由兜底,缩 AI 自由写的面。执行序列:✅ 阶段一 A 清脏数据(a6a37b1c,三文件双源 + 锚)→ ✅ 阶段一 B 改签名全完成(附 A 15 处可改签名 #1-#15 全落 + 正交泛型门修复,2a20e5e7→2be7b718 共 13 提交;每处单元 + 确定性验、各插件测试绿、双源一致;前置核查证 L2 插件与 tier2 物理隔离 = 无 tier2 回归)→ ✅ 存量重生成九门复验(一次过 ¥0.64)→ ✅ 难品类数据点取得(修正了假设):建经营黄金脚手架 game-runtime/games/_template-shop/(蒸馏过门实证 pattern + 母语化 + 多样性参数空间,独立过九门)+ 品类路由接入(scaffold_template/scaffold_desc);经营品类三路对照证 扩模板降工作面只在「强制换皮 reskin」模式(write_whitelist 锁 game-logic.js 循环、只换主题 = 696 行 / ¥0.34 / 成本 -51% / 仍过门仍 distinct),软脚手架不降本(AI 把预算填进增富化 combo/VIP、892≈基线 890)→ ✅ 经营 reskin n=5 收敛环确认(5 不同店主题 5/5 过门 · 成本均 ¥0.252/-64% · game-logic 全 0-diff · 多款不雷同)→ 🔴 创始人纠正(2026-06-29,推翻 reskin / 丰富脚手架策略框):reskin「锁循环换皮」与「重做丰富脚手架」越线已废(成本数据留痕、机制为真,作策略废)。便宜 = LLM 低参与度 ≠ 游戏低质量;底线 = 2D 丰富游戏(进货/解锁/成长/音乐/丰富玩法)。架构红线:项目代码只做机械确定的事;玩法/美术/音乐的「丰富生成」= 生成 agent 设计创作职责(靠 sim-business-game-design + 组合插件)、「丰富校验」= 纯 LLM 验证 agent(非阻塞),代码绝不碰、不进九门、不进脚手架。「扩模板覆盖 = per-genre 脚手架」的框随之改为 per-genre 设计 skill + agent 实现 + LLM 验证(脚手架保持轻起点)。修正后下一步:① 接 sim-business 设计指导到便宜档生成 agent(现 prompt 只指 littlejs-game-dev/怎么写代码、漏了设计什么才好玩)→ 让 agent 设计丰富玩法再实现;② 建 LLM 丰富度/好玩验证 agent(非阻塞)。两步喂 M1 达标门(标 = 过九门 + 丰富)。并行 C 补密度。〔2026-07-02 校正:两步已于 06-29/30 落地并把 M1 达标门跑绿(bake-off-M1-rich 三品类各 5/5,见本切片起点校正);品类资产扩产(per-genre 设计 skill 四件套)转入 06-29 设计 §7 工单,解锁待《游戏质量与爆火能力》SoT 定稿。〕红线:九门内核不降、L2 插件库保留(降参与核心载体非税)、不动 tier2(阶段一 B 前核 L2/tier2 物理隔离定回归范围)。WU-B 实例达标 / WU-C 5.4 能力面契约变更(改 22 处 L2 API + 同改 api.d.ts/prompt/skill/_template + 重写 tools.mjs 形状门) / WU-F 达标门。
  • M1 达标门绿(本机 / 实验室口径)。治生成幻觉护栏(oracle 静态扫描:drawButton 返 void 被误赋值、define 形状误判、check 只查方法名的盲区),把卡住的品类救回;便宜档生产自验 play-spec 自动生成,脱离金标 spec、生产里自动产 spec 驱动九门(达标门的前置——达标门由自动 spec 驱动);≥80% 达标门 bake-off(20 款核心品类代表样本 + 四模型横比 + 不依赖 Claude 的判定门),按品类判 ≥80%、核心品类全覆盖——防好品类拉高总体、当前卡死的两类被平均掉的假绿(对齐 002 的按品类口径);预算闸 < ¥10 接线 fail-closed。交付定义 = 便宜档按品类稳定出 ≥80% 达标游戏(本机 / 实验室口径,20 款作生产 prompt 分布的代表样本;生产真实分布达标在 M3 复验)。
  • M2 上线就绪(到 Node 退役条件齐)。auto-vs-golden delta 核对——生产自动 spec 要达到金标 spec 同等过门率(“同等”须钉死 delta 阈值——按品类 / 按关键门列最低通过率或最大允许差值,菜单 / H_progress / G_input 等关键门不得低于金标基线;阈值数值留 M2 细化 plan,未填不得授权 Node 退役),这是面向生产的 Node 退役授权前置(WU-A 对照证据是金标 spec 下采的,生产用自动 spec,两者要核平);切换基础设施设计(路由 flag 整体翻转、A2A 任务状态、幂等 key、在途任务处理、D12 配额扣退语义,设计加本地可验部分;2026-07-02 按 D3 扫净原「灰度」措辞);Node 退役门(达标 + 对照等价 + auto-vs-golden 三条齐,才把默认路由切到 Python)。交付定义 = 便宜档具备把默认路由切到 Python 的全部条件。
  • M3 真上线(后端集成)。✅ 路由 cutover 已 2026-06-28 go-live(创始人批:live :48080 退 6-21 旧 gamedef jar、上 6-28 M3 jar + dispatcher=http→worker:9501 + trace,Node/gamedef 旧路在 live 退役;拆 iso :48090 避 split-brain,留 revert 备),其余(开闸放量 + 生产复验)= 剩,细化见 2026-06-30 M3 cutover plan。game-cloud 后端路由 flag 与 D12 记账骨架接线(真扣退 / 补偿留 M4——new-api UserId 阻塞、MVP 无真支付;2026-07-02 按 cutover plan §2.2/§8 更正原「扣退真接线」措辞);创作页一句话 → 生成 → 九门 → 可发布预览包,生成线交付到此为止,publish → feed → 种子用户真人试玩归产品 / 审核台轨(接收方见 cutover plan §2.2;2026-07-02 更正原「端到端打通」措辞)(preview / review / interact / ads / revenue / telemetry / recommendation 等顶层闭环其余环节属非生成模块,由 16 周主计划对应模块承接,不在生成线 M3 范围);对外开闸放行 6 门(独立 SoT 验收门.md)验过。移交边界:生成线交付 = Python 生成核心 + 后端路由 flag / D12 接缝;后端 studio 模块的创作会话 / 资产模块化 / 进度流 / 重生成编排归后端线(game-cloud studio 模块,非生成线)。交付定义 = 便宜档真上线跑在生产、生产真实 prompt 分布下达标门复验 ≥80%,Node 旧路退役。

依赖与顺序:M1 → M2 → M3。M1 本机可跑、无前置(WU-A 已就位)。M3 需后端协同。

验收口径:九门机制地板 + L2 设计符合 + ≥80% 达标门(统计批跑,与 tier2 的 n=5 收敛环是两套口径,别混);对外开闸放行 6 门在 M3。

跨设计面:WU-B 便宜档实例 · WU-C 5.4(护栏 / 自动 spec / 三层校验 / 降AI参与 L2 API 母语化契约变更——改 22 处 L2 插件 API,细化设计见 2026-06-29-便宜档降AI参与…设计)· WU-C 5.6(engineBundle 装载)· WU-F(达标门 / 预算闸 / 灰度 / 退役);设计 SoT §4.1 / §5.4 / §5.6。

迁移安全契约(M2/M3 Node→Python 迁移 · R1 回滚与切换门的对账依据):〔2026-06-30 校正:路由切换据创始人 D3 = 整体翻转、非按比例灰度(见下方 flag 条目);下文残留的"灰度放量 / 灰度期"措辞属换轴前框架,以 flag 条目的整体翻转口径为准。〕便宜档 Node→Python 迁移逐项钉死,是执行约束、不是设计 HOW,切片一细化 plan 据此展开(承接源 = 换轴前 WU-A 迁移契约段 git f084018f + 002 对账表(git show git show 8ea97234:docs/plans/2026-06-26-002-feat-cheap-worker-multi-genre-plan.md))。

  • 当前链路(Node 旧路):创作页一句话 → D12 配额 + 提交侧合规两道入口门 → SAA Java 外层 → shell-out Node amodel-gen 多轮 ReAct → done 门 → 九门 play → verdict → 发布门入 feed。
  • 目标链路(Python 新路):同两道入口门 → AgentScope/Python 跑同套多轮 ReAct → 同套 done 门 → 九门 play → verdict → 发布门;产物形态(真 src/)与验收口径(九门)两路一致。
  • 路由 feature flag:Node / Python 由全局 dispatcher flag 控(创始人 D3:整体翻转、非按比例灰度;generationDispatcher 构造期单选、重启级生效);任何时刻可翻 flag + 重启切回 Node。〔2026-06-30 校正:原"按比例灰度放量"措辞与 D3 冲突,据 D3 + 6-28 已执行的整体翻转 cutover 更正。〕
  • 对照验证:Python 与 Node 同输入逐项比产物与过门率,不达标不切默认路由(WU-A 已对三品类坐实 equivalent)。
  • A2A 任务状态:两路产同一组状态(submitted/working/input-required/completed/failed/canceled),前端轮询不感知底层换实现。
  • 幂等 key:创作请求维度稳定 key,切换期同一 key 只一条路认领、产一份产物,防双跑双扣。
  • 超时重试:Python 移植双层超时 / 重试退避 / JSON 容错;done 门与墙钟上限语义随范式搬过去。
  • D12 配额扣退:入口先扣,失败 / 取消按补偿退还;两路同一配额门,切换不改扣退语义。
  • 在途任务:切换 / 回滚瞬间在途的不强杀,原路跑完落 verdict;新进任务才按当前 flag 路由。
  • 切换门槛:Python ≥80% 达标 + 对照等价 + auto-vs-golden 同等,才切默认路由(对应 M2 Node 退役门)。
  • 回滚触发:成功率回退 / 九门通过率掉 / Python 框架级稳定性问题 → flag 切回 Node 旧路(保留它活跑到 Python 达标)。

后续细化:M1 一份细化 plan(护栏 + 自动 spec + 达标门,接 002 的 harness 范式),M2 与 M3 各一份。

切片二 · tier2 富游戏 go/no-go

目标:复杂档(Phaser · tier2)用 n=5 收敛环定 go/no-go,拆掉“便宜或中等模型自治写约 56% 表现层能否稳定收敛”这个全线最大的悬念。

起点:U1–U7 核心、服务化 @8200、观测、落库已落(tier2/HANDOFF.md);0 号 spike feie-005 accept,是首跑 n=1 机制验证、不是结论。

〔2026-07-02 校正:下列序列已由 runbook 06-28-002 于 06-28/29 执行完毕——U1 小验(收敛环走 in-process,DockerWorkspace 转 Phase B)、U2 批级护栏、U3 退路树 n=5 适配、U4 结构化契约门(AST)全交付;U5 收敛环真跑判 go/no-go = conditional(M3 能写出过全门的多系统富游戏,但自调「赢的条件 / 经济平衡」不稳 ~1-2/5、且带 live 争用 confound;退路按创始人 06-29 纠正定在 agent 层,非工具层模板化 / 补骨架)。剩余 follow-up 工单(verdict 反馈质量 / 干净复跑 / 强档对照 / 平衡门判法重审)见 runbook「后续工单」节。〕

序列:

  • 前置阻断小验:DockerWorkspace 托管 CDP harness。验 agentscope 2.0.2 DockerWorkspace 能否托管 CDP 九门 harness(对比自建 Docker)。harness 跑不起来,收敛环无从批量取证,所以它前置于收敛环、先于其余运行时选型。
  • 结构化契约门(与 harness 小验可并行——它是 build 段静态校验、不依赖 CDP / mini-desktop)。把偏脆的文本契约门(play-scene 工厂结构)做成结构化校验。收敛强依赖机器门把每类契约违规变成响亮可修的反馈,纯放开 ReAct 加软约束 prompt 不行。
  • n=5 收敛环。并发跑 5,有错(超过 1)就读日志分析修复再追加一次 5,收敛即 go;给收敛环钉死显式上限:最多追加 3 轮(累计 n ≤ 20,超过即说明非小修可收敛、转退路树,不滑向 n≥30 统计批跑);单轮墙钟与预算上限留切片二细化 plan,细化 plan 未填上限不得开跑。超上限按退路树走、不无限调。
  • go/no-go 判定 + 退路树。装不出 → 补骨架;表现层崩 → 更模板化;便宜档全线不收敛而强档能过 → 换档;收敛需微调 → 留观。

前置外部条件:mini-desktop 可达(服务态 @8200 与真玩门都在 mini-desktop)。

验收口径:九门 + 富游戏三门(三联动 / 经济 / latch)+ 四收敛契约门;n=5 收敛环 go/no-go,不走 n≥30 统计批跑。

跨设计面:WU-B 复杂档 · WU-D 的 DockerWorkspace harness 小验(ADR-6 子项)· WU-C 5.1 运行时 / 5.3 单写 ReAct / 5.4 结构化门 / 5.5 能力面九工具 / 5.6(tier2 源项目契约七要素 schema + feed→play 第二装载分支,go/no-go 后交后端)· WU-F 判定;设计 SoT §4.2 / §5.1 / §5.3 / §5.4 / §5.5 / §5.6 / §二补⑥。

后续细化:06-22-003 的 U1–U10 作复杂档子计划保留引用(主体已落);收敛环跑作一份细化执行,不重排其可跑 runbook。

切片三 · A11 对话式调整回路

目标:用户试玩生成的游戏后回头调整,这条调整回路在生成实例侧有工程承接,落地产品阶段三承诺的对话式创作出口。首次生成不是终点,没有这条回路,对话式创作就是个无入口的孤儿。

两档起步 + 一档后期:

  • 确定性覆写(起步必落)。参数级调整(数值、配色、文案、节奏等可被结构化捕获的改动)不重跑生成,对源工程那一处做确定性覆写再重新构建。覆写这一步零 LLM、最快、可控性最高,是对话式微调的主路。

    精化(切片三落地后回写,创始人 2026-06-29):覆写执行仍零 LLM,但 A11 不是"用户直接给结构化覆写"——它经判意图(LLM 把自然语言改话分类成 mode/target/payload)+ 前端范围确认两段式到达确定性执行(评审收敛的 A 两段式,绕开"NL 进不了已结构化 /modify"与"input-required 暂停态无承载"两阻断)。落点对齐生成侧工程规范性(资产统一 assets.js / 数值集中 core.js)使"改一处"。详见 git show 8ea97234:docs/plans/2026-06-28-003-feat-studio-A11-对话式调整回路-plan.md(KTD1/KTD2)。

  • 模块重生成(起步必落)。调整落在某个模块(某个关卡、某条规则、某个场景),只对该模块走一次有界重生成,复用既有外层 resume 与三层校验,不动其余已验证模块,改完仍过九门。
  • 整体重设计(后期)。改动伤筋动骨(换玩法骨架、换品类),退化为一次新的整体生成。

依赖与顺序:坐在切片一的便宜档实例之上;两档都接 A2A 任务状态与 D12 配额(一次调整是一次受计费、受配额的生成任务)。切片一只提供已上线的便宜档实例与通用 A2A 任务 / D12 配额骨架;A11 专属的 StudioModify(baseVersionId / mode / target / payload)修改入口、修改任务状态机与版本血缘,由本切片首个里程碑自建、不在切片一范围——别误认为切片一已交付的前置。

验收口径:九门 + 三层校验;确定性覆写额外要求重构建后产物仍过九门。仅过九门不够——九门只验“仍能玩”,验不出“改对了没、有没有误伤”,故 A11 完成判据补三条结构断言:① 请求的结构化改动可断言真实生效(改了的就是改了,不是 no-op 重构);② 非目标模块的 hash / 白名单 diff 稳定(没顺手改坏别的模块);③ 新版本与 baseVersionId 血缘可查。三条结构断言 + 九门 + 三层校验全过才算改成。

交付定义:确定性覆写 + 模块重生成两档落地、改后产物过九门与上述三条结构断言,且接入 A2A 任务状态与 D12 配额、跑通一次受计费的真实调整任务(整体重设计留后期、不计入本切片完成)。

跨设计面:WU-B 的 A11 反馈回路 · WU-C 5.4 · WU-F 配额;设计 SoT §三 A11。

后续细化(已执行):细化 plan = git show 8ea97234:docs/plans/2026-06-28-003-feat-studio-A11-对话式调整回路-plan.md(过双评审 + 创始人批);M1–M5 代码全完成、本机逐段一手验证、6 里程碑提交(dev/2.0.0);唯一剩项 = 受计费真后端 e2e(创始人 2026-06-29 定排部署窗口、不动 live)。关键收敛:A11 后端骨架已大面积落地,真活在便宜档接入 + 判意图/执行/三断言;架构 = A 两段式(判意图 /modify/plan → 前端确认 → 执行 /modify)。

基建线 · 控制面 / 观测 / 配置热取

内容:配置注册表运行时热取(Langfuse 式 id@label 取、缓存 TTL、回落内置默认)、统一 trace 公共核心子集契约定稿(traceId / step / cost / verdict / timestamp 五字段对称,各轨不对称扩展段)、管理面 phase-1 只读最小切片(看各角色当前用什么模型、回放任意一次生成全轨迹、按 new-api 口径对账成本)。

最小验收判据(防“做了一些配置 / 页面”却无法验收):配置热取——TTL + 默认回落 + 一致性 CI 三件齐、改 label 不重启即生效;公共 trace——五字段 schema 定稿 + 至少一条真实生成 trace 落表可查;管理面 phase-1——只读页能展示各角色当前模型、回放一次真实生成全轨迹、按 new-api 口径对出一次生成成本。

生长纪律:这条线不预先全铺,按切片二 / 三的可观测、可调试、可治理需要长出来。硬约束两条:别在裂的地基(prompt 构建期快照这个反模式)上盖更大的注册表,先补一致性 CI 再推广;只有 Phaser 一个真实现时不抽能力面五件套通用接口,等第二引擎落地有两个实现再抽(rule-of-three)。

现状:D12 治理门已落(默认关、SAA Java 后端);tier2 侧 OTel 全落真跑;prompt 构建期快照是待治的反模式。2026-06-30 起,本线的控制面主体由配置控制面设计细化认领(生产基建 SCA 三件套 → 生成归并 Service + 护城河 middleware → 配置中心 yudao⊕Nacos → 配置编辑 UI → 观测,五阶段串行;2026-07-01 反转采 Nacos/RocketMQ/Sentinel 生产现货,取代本节早先"配置热取自建注册表"的口径):阶段〇与阶段一①已落地 push,阶段一②(cheap 归并 Service)在飞。

跨设计面:WU-C 5.2 / 5.5(仅 skill·tool·mcp 注册到 A13 子项;能力面主体在切片二)/ 5.7 / 5.8 · WU-E phase-1 · WU-D 第一批(ADR-3 trace、ADR-4 配置热取);设计 SoT §5.2 / 5.5 / 5.7 / 5.8。

后续细化:配置热取一份、公共 trace 契约一份、管理面 phase-1 一份,各自在被切片二 / 三拉动时产。

基线项 · A1–A13 协议定级与 6 ADR(设计已冻)

状态:A1–A13 的“现 / 建”定级与 §二补三 6 条 build-vs-buy ADR,已于 2026-06-24 §6.8 双评审(采纳但修)后收口定稿、定级已冻(设计 SoT §三、§二补二/三)。76KB 接口协议设计已并入设计 SoT、原档退役。这一项不是待拍的阻塞,是后续采标准落地的已冻基线。

WU-D 采标准三批据已冻定级落地:第一批观测治理(ADR-3/4)进基建线、第二批协议、第三批运行时 future-state,排期与依赖见基建线与切片二,不再有“等采纳拍板”这一步。

剩余两项是执行验证、不是设计批准(设计 SoT §二补⑥ 收口 TODO 明确):① DockerWorkspace 托管 CDP harness 小验——切片二收敛环的技术前置,不依赖任何待拍决策(见切片二);② durable-execution / 跨机扩容选型 spike——future-state。

§5 High-Level Design:纵切切片依赖图

flowchart TB
  subgraph DEC["基线:A1–A13 定级 + 6 ADR(设计已冻)"]
    D["已冻定级供 WU-D 采标准落地"]
  end
  subgraph SLICES["执行序列:三切片(按价值串行)"]
    direction TB
    S1["切片一 便宜档达标上线<br/>M1 达标门绿 → M2 上线就绪 → M3 真上线<br/>跨 WU-B / C5.4 / C5.6 / F"]
    S2["切片二 tier2 go/no-go<br/>harness 前置 → 结构化门 → n=5 收敛环 → 判定<br/>跨 WU-B / D / C5.4 / F"]
    S3["切片三 A11 调整回路<br/>确定性覆写 → 模块重生成<br/>跨 WU-B / C5.4 / F"]
  end
  subgraph INFRA["基建线(按需长出 · 不预铺)"]
    I["控制面 / 观测 / 配置热取<br/>跨 WU-C5.2/5.5/5.7/5.8 / E / D 第一批"]
  end

  S1 -.①价值排序·非阻塞.-> S2
  S2 -.②价值排序·非阻塞.-> S3
  S1 -->|硬前置:便宜档实例·A2A·D12| S3
  D -.已冻定级供给.-> S2
  D -.已冻定级供给.-> I
  I -.可观测 / 治理供给.-> S2
  I -.可观测 / 治理供给.-> S3

图例:实线箭头 = 硬前置依赖(切片三的便宜档实例 / A2A / D12 必须切片一先建成),虚线箭头 = 价值排序与供给关系、不阻塞可并行准备。三切片按价值串行(一 → 二 → 三):切片一、二无强依赖,切片三依赖切片一的便宜档实例与 A2A/D12 配额基础设施;基建线横穿、被切片二 / 三拉动时长出;A1–A13 定级与 6 ADR 已冻、供 WU-D 采标准落地(非待拍阻塞),切片二的技术前置是 harness 小验。每个切片纵向跨多个关注面,做完即交付。

§6 排期(挂 16 周波次轴)

挂 docs/mvp/可行性方案16周-波次映射.md 的波次轴,状态以 docs/mvp/MVP进度总账.md 为准。

切片 / 线 波次锚点(16 周) 说明
切片一 便宜档达标上线 阶段一尾(M1)→ 阶段二(M2 / M3) 阶段一主力,本机可跑起步,无前置
切片二 tier2 go/no-go 阶段二(5–8 周) 前置 = DockerWorkspace harness 小验 + mini-desktop 可达
切片三 A11 调整回路 阶段二尾 → 阶段三(9–12 周) 接对话式创作出口
基建线 控制面 / 观测 随切片二 / 三长出 不预铺;phase-1 只读优先(立刻能给创始人看见)
基线 A1–A13 定级 + 6 ADR 设计已冻 2026-06-24 §6.8 双评审收口;供 WU-D 采标准落地

16 周的真约束是日历闸门(IP 授权 / 软著 / ICP / 备案 / 渠道审核),工程切片按 agent 产能并行、不是瓶颈。生成线本身无日历闸门,但发布门入 feed 受备案约束(灰测红线不超 2 万人、不接广告、报备删档,备案须在外测前完成),这条落在切片一 M3 与切片二上线侧。

生成线在 55 P0 里承接的子集 = aigc 生成链 + studio 生成任务编排 + runtime 打包装载 + project 发布接缝 + feed 播放接缝;其余 P0(社区 / 变现 / 合规 / 推荐等)由 16 周主计划对应模块承接,回填 MVP进度总账.md 时据此反查、不重复计入。

§7 设计面对账(WU-A..F → 切片映射)

横切的六个工作单元在换轴后不作废,降为这张对账表。它有两个用途:保证纵切切片落地时能按八面下钻设计 SoT、不丢架构一致性;给后续切片细化提供“这个切片碰哪些设计面、对应设计 SoT 哪一节”的索引。WU-ID 在引用与回溯里继续有效。

WU(设计关注面) 落到哪个切片 / 线 设计 SoT 下钻
WU-A 框架收敛 切片一起点(✅ 已坐实:便宜档 Python/AgentScope 对照三品类 equivalent) §一 / §三 / §5.3
WU-B 三档实例就位 切片一(便宜档)+ 切片二(tier2)+ 切片三(A11 反馈回路) §四
WU-C 八面落地 切片一(5.4 / 5.6 便宜档装载)+ 切片二(5.1 运行时 / 5.3 单写 ReAct / 5.4 / 5.5 能力面 / 5.6 tier2 源项目契约)+ 切片三(5.4 A11 覆写 / 重生成后的三层校验与九门)+ 基建线(5.2 / 5.5 注册子项 / 5.7 / 5.8);5.3 范式亦由 WU-A 行承接 §五
WU-D 采标准 6 ADR 已冻定级(基线)→ 第一批观测治理 ADR-3/4 进基建线 → 第二批协议:ADR-1 A2A 接切片一 M2/M3 与切片三任务入口、ADR-2 MCP 接切片二工具 / 结构化门、ADR-5 Agent Service 接 tier2 服务化现状与基建线 future-state → 切片二 ADR-6 harness 小验 → 第三批运行时 future-state §二补三
WU-E 控制面 / 审批 基建线(phase-1 只读)+ 后期深化(配置发布审批 future) §5.2 / 5.8
WU-F 验收与预算门 切片一(达标门 / 预算闸 / 灰度 / 退役)+ 切片二(n=5 go/no-go)+ 切片三(配额 + 修改任务发布前的九门 / 三层校验 / 结构断言判定) §三 A5 / §5.2 预算 / §5.7 成本 / §二补⑥

每个切片细化时,据这张表找到它跨的关注面,再到设计 SoT 对应节取设计、到对应的 WU 历史描述取上下文。横切的一致性(同口径同契约)由设计 SoT 与机器门保证。

§8 Key Decisions(reframe 权威口径)

reframe 的七条口径(创始人 2026-06-25),换轴不改其一字,逐切片执行据此:

  1. 框架收敛 AgentScope,三档彻底同构。生产编排只押 AgentScope 一套,三档同语言同框架。便宜档的多轮 ReAct 生成核心已从 Node/M3 的 amodel-gen 整条用 Python 重写成 AgentScope agent(切片一 WU-A,已坐实);A1–A13 适配协议骨架不变。SAA / dify / coze 降最低优先级,留作远期适配验证可插拔——它们被适配进来这件事本身,就是对 §一可插拔原则的验证。
  2. 三档按 AI 参与深度切分(Tier0/1/2),不是按引擎。级别越高,AI 写进游戏的内容与代码越多。引擎按表现复杂度选(轻-中档 LittleJS、最高档 Phaser),引擎是实现、不是分档轴。
  3. 全模板化、去超休闲。三档都在玩法模板加工程脚手架上生成,没有一档从零写;最低档也得能商业闭环,无法闭环的超休闲玩具不做。玩法模板退化为可选的品类引导框架(经营 / 剧情 / 解谜 / TRPG / 非遗五品类),不是可执行的游戏壳。
  4. gameDefinition 已废,A-model 写真 src/ 是便宜档现行形态。无 factory/gamedef 双轨、无 cutover,产物终态都是 src/ 多文件源工程(改源不改包、重新构建)。
  5. per-gen 预算硬闸按 AI 深度档分级:便宜档一次生成 < ¥10、复杂档 < ¥50;图像与音乐生成各走独立预算线、不计入这两个上限。这是“拉高、给足探索空间”的口径(对比 tier2 spike 实测仅 ¥1.29)。单位经济或模型单价大变即复审。
  6. tier2 验证走 n=5 收敛环,不是 n≥30。并发跑 5、有错(超过 1)就读日志修复再追加一次 5、收敛即 go;退路树按收敛失败模式分流。便宜档 ≥80% 达标门是另一回事——测成功率需统计样本,走 bake-off 批跑(切片一),不在 n=5 收敛环口径内。
  7. 采标准、自研只留两块护城河。adapter 退化成三个标准端点(A2A 任务 / MCP 工具 / OTel trace)加两块自研(确定性验收门 + 生成专属 checkpoint/续跑)。采标准把“换框架”从推倒重来降到“重写 B 类实现、A 类协议不动”,不降到零(业务语义层仍 net-new)。修正已收口为 6 条 build-vs-buy ADR(设计 SoT §二补三、定级已冻),基建线与切片二据已冻定级分批落它。

§9 风险与回滚(按切片重挂)

  • R1 便宜档框架收敛迁移(切片一 · 头号)。把 amodel-gen 这条在产主力整条用 Python 重写并重新验证,等于推倒一条在产链路重做。三道闸:对照验证(已坐实,三品类 equivalent,第一道闸过)+ Node 旧路灰度兜底(活跑到 Python 版 ≥80% 达标)+ ≥80% 达标门把关才切默认(M1/M2)。回滚 = 路由 flag 切回 Node amodel-gen 旧路(它与 SAA Java 外层壳保留活跑、代码在,可瞬切回)。
  • R2 tier2 收敛环 go/no-go 未定(切片二)。feie-005 accept 是 n=1 机制验证、不是结论;便宜或中等模型自治写约 56% 表现层能否稳定收敛,是全线 go/no-go 所系。回滚 = 退路树按收敛失败模式分流(不再调参,转退路);收敛强依赖机器门把契约违规变成响亮可修反馈。
  • R3 采标准成熟度参差(基建线 / 切片二)。MCP Tasks(experimental)、durable-execution(范式非标准)、microVM / Langfuse 热取须标 maturity gate,不当“已收敛生产底座”。DockerWorkspace 托管 CDP harness 小验是切片二的技术前置(设计已冻、直接跑、先于收敛环,不依赖待拍决策),durable-engine 选型随运行时第三批 future-state。
  • R4 配置发布审批边界(基建线后期)。重要配置走 yudao 审批是后期阶段、复用现货;若集成不顺,回滚 = GitOps config-as-code 兜底,read 侧热取先补一致性 CI 再推广。别在裂的地基(prompt 构建期快照)上盖更大注册表。
  • R5 文档口径漂移 + 换轴双账(横切)。tier2/HANDOFF.md 的 n≥30 字面、06-22-003 的 U8–U10 纲要口径仍是过时留痕,以本文 + 设计 SoT + git 为准。换轴新增一条:执行序列(本文 §4)与设计面对账(§7)是同一批工作的两个视图,切片细化或关注面变更时两侧要同步改,单改一侧即漂移——同步责任在横切一致性主人(创始人 + 6c6g 文档/设计线)。
  • R6 过门不等于好玩(所有切片)。九门是机制地板、不是设计完整性;L3 视觉软检防 Goodhart,只评分不阻塞,好不好玩最终归人工终审。回滚 = rubric 补九门测不到的设计完整性层(资产对位一票否决)。

§10 吸收退役映射

三份旧 plan 的去向(换轴后归到切片,不再归到 WU):

旧 plan 处置 有效项去向 被退役 / 推翻的
06-18-001(SAA 真结构化生成主线) 退役 SAA 主线骨架 地基产线化、策略外置(多模型回退 / JSON 容错 / 重试)→ 切片一(随 Python 重写移植)；oracle 加固 → 切片一 M1 护栏 SAA 裸图 16 节点 studio 主线 + gameDefinition 声明式源(被 reframe + A-model 写真 src/ 推翻)
06-19-001(core-done 验收闭环) 整体入验收门 三层校验 / 九门划界 / rubric → 各切片九门;smoke 5 链路 / 8 页走查 / 广度抽检 / feed 真玩 → 切片一 M3 对外开闸放行 core-done ∧ gen-done 双线拆分(SAA gen-done 随 06-18-001 退役)
06-22-003(tier2 富游戏自治生成线) 复杂档整体入切片二 U1–U7 核心 + 服务化 + 观测 + 落库(主体已落)→ 切片二;U1–U10 作复杂档子计划保留引用 U8–U10「B 门后才投·纲要」字面口径(部分被既成事实推翻,以 HANDOFF 为准);n≥30 字面(改 n=5)

退役不删档:三份旧 plan 留档、frontmatter 标 supersedes/absorbs 指回本文,决策史可追。

§11 Sources、换轴依据与收口 TODO

设计 SoT(本文要落它):agentic运行时架构图说.md(§一命题 / §二补三 6 ADR / §三 A1–A13 / §四三档 / §五八面)。相邻 SoT:prompt 治理、验收门.md(对外开闸放行 6 门)、数据飞轮、OpenGame 对照(同目录)。

现状盘点源:tier2/HANDOFF.md(复杂档现状 + feie-005)、002 multi-genre(git show git show 8ea97234:docs/plans/2026-06-26-002-feat-cheap-worker-multi-genre-plan.md) 与 001 spike(git show git show 8ea97234:docs/plans/2026-06-26-001-feat-cheap-worker-python-spike-plan.md)(便宜档 WU-A 框架对照坐实)、cheap-worker/(Python 重写落点)、game-runtime/tools/amodel-gen/ 与 game-runtime/games/_wg1-gen/(A-model 便宜档现状)。

换轴依据(2026-06-26):本次重构把执行主轴从关注面横切(WU-A..F)换成成果纵切(三切片),依据是 §3 的三个返工点——关注面横切下,一个交付成果的目标与实现手段被切到不同 WU,串行执行必返工。换轴遵守 canonical 唯一性门:不新建第二份同 topic canonical,在 plan① 原地重构,WU-A..F 内容全部保留为 §7 设计面对账,文件名不变(8 个活档引用其路径不死链)。WU 横切作设计落地结构仍有效,只是不再充当执行序列。换轴核查:被压缩的 WU 内容分两类——设计 HOW(八面 5.x / 三档矩阵 / A2A·cancel·幂等协议 / 6 ADR)归位设计 SoT、§7 对账可下钻,执行 plan 不重复;执行契约(WU-A 便宜档灰度迁移 11 项:链路 / 灰度 flag / 对照 / 幂等 / 在途 / 切换门槛 / 回滚等)是按计划执行必须遵守的约束、不是设计,已补回切片一,不随设计细节一起移交。

收口 TODO:① assets/00-生成引擎执行总览.svg 待 redraw 成纵切切片序列图(当前是横切 WU 版);② tier2/HANDOFF.md 的 n≥30 字面改 n=5(随切片二);③ ✅ MVP进度总账.md 回填执行序列三切片现状(2026-07-02 账本对真已回填);④ 换轴版已过 Codex + Opus 双评审(Opus 四维度专项 + Codex 四维度专项末轮重连完整产出),两评必修与发现项已在档内修(2026-06-26);⑤ 设计 SoT §269「十一插件」与代码实际 12 个(8 基元 + 4 编排)不符,交横切一致性主人核正;⑥ A11 在设计 SoT 仅 §三协议表一行、无 §5.x facet 专节,切片三细化前请横切一致性主人补 A11 设计面。