games-development-ai/docs/agent-specs/_archive/2026-06-16-生成引擎主线-传承与演进-review.md

生成引擎主线 · 传承与演进 · 评审版

状态：review 版 · 2026-06-16 · 给创始人决策（结论先行、Mermaid、降认知负荷）。 触发：换框架（Python AgentScope → SAA 裸图，HJ-AGI-002）后核验"原任务没丢"，并在新框架上做得更全/更稳/更可能出爆款。 底稿（逐行已读）：2026-06-15-python-to-SAA-migration-design.md（§1 原系统画像 + §2 Python→SAA 映射表 = 保全权威账）｜.agents/skills/cheap-model-game-generation.md（§7-9 质量/能力画像）。

---

0. 结论先行

1. 原主线 = "便宜模型 + 九门确定性真玩 harness"的游戏工厂（HJ-GEN-001）——质量由 harness 门保证、非模型自觉。换的是"躯体"（编排框架 AgentScope→SAA），没换"骨架"（九门 harness / 装载契约 / job-callback 契约 / prompt / 自产 gatespec / 三层质量）。
2. 保全已核验：迁移设计 §2 映射表逐构件标了去向；九门 harness/build = 子进程复用·禁重写（一字未动）；design/code/fix/validate/scaffold/play/player/repair/emit 节点逐字移植；本会话还把 SAA 净增项 checkpoint + observation 真接落地。无任务丢失。
3. 真正要"做更好"的不是框架，是生成质量主线——而数据已指出靶心：85% 失败栽在 H_progress（game loop 到不了终态），且 skill §7/§9 证实其主因是 harness driver 覆盖缺口 + latch 终态，不是模型能力。这正是 moat「一句话现生成」的临门一脚。
4. "爆款"分两步、别跳级：① 先补可玩地板（H_progress 漏水→让一句话生成稳定产出"真能玩"的游戏）；② 再抬好玩天花板（三层质量 / fun / 留存）。85% 到不了终态时，先修地板。
5. SAA 不只是"保全"，给了新武器：刚接的 observation 让我们第一次能逐节点看清 H_progress 卡在哪类游戏/哪个 driver（旧 Python 只有 print），把质量攻坚从"猜"变"数据驱动"。

---

1. 原主线任务清单（生成引擎主干，grounded）

flowchart LR
  B[一句话 brief] --> D[design<br/>设计+自产 gatespec]
  D --> C[code/fix 循环<br/>出工厂源码]
  C --> V[静态校验门<br/>契约+禁用词+node--check]
  V --> S[scaffold+esbuild<br/>__GameBundle]
  S --> P[九门真玩 harness<br/>A-I 确定性硬地板]
  P -->|pass| PL[player 软门<br/>M3视觉+flash文本]
  P -->|fail| C
  PL --> E[emit→engineBundle→feed]

核心资产（真 moat 腿，非框架）：

资产	是什么	证据
九门真玩 harness（A–I）	确定性硬地板：装载/未捕获/掌帧/真渲染/活性/真接线/输入有效/机制进展+latch/控制跟手	migration §1.5；harness skill §7
适配性真玩 driver（8 类）	读 state 自动出招，解"盲打打不中技巧游戏"假阴性	migration §1.5；skill §9
design-agent 自产 gatespec	确定性门随游戏自产、适任意游戏（harness 复利）	skill §7
prompt 契约	模块形状+6 受控面+12 禁用词+P0 latch 终态硬约束+few-shot	migration §1.7
三层质量	门=地板 / M3=主观过滤+fun 信号 / 创始人=人锚	skill §8
job/callback 契约	job-in → engineBundle → DifyCallbackReqVO 落库入 feed	migration §1.6
成本面	便宜模型经 new-api、¥0.15/款闸、per-model 拆账	skill §2

§9 战略判定（关键）：便宜模型其实相当能干（自写 CCD/文本HUD/网格状态机/match 全对）；真难点 = harness driver 覆盖 + 宿主门面完备。"模型造不出"是最大伪报源——单件失败必重生成区分"实例 bug / 可测性缺口 / 模型短板"。

2. SAA 迁移保全核验（"没丢东西"的账）

原任务	SAA 去向	状态
九门 harness / build.mjs / serve-and-play	子进程复用·禁重写	✅ 一字未动
design/code/fix/validate/scaffold/play/player/repair/emit	SAA 节点逐字移植	✅ 保全（本会话核）
自产 gatespec 抽取归一	design 节点内纯 Java（宽松解析替 json_repair）	✅ 保全
prompt / 12 禁用词 / latch 终态	SaaPrompts 逐字移植	✅ 保全
模型路由 / new-api / 成本	共用 OpenAiApi 多模型 + new-api 单一成本面	✅ 保全
job/callback 契约	form① 进程内直调 handleCallback	✅ 保全（消灭 HTTP+HMAC）
checkpoint（SAA 净增）	MysqlSaver 真接	🆕 本会话已落
observation（SAA 净增）	GraphObservationLifecycleListener	🆕 本会话已落
streaming 进度（SAA 强项）	§6.2 step6	⏸️ deferred·勿忘（前端创作页进度条）
player 子图 + vision‖text 并行	§2 #11 SAA 更强	⏸️ 未利用（现仍单节点串行）

结论：无任务丢失；两处 SAA 强项被推迟（streaming 进度、player 子图并行），列入演进线 A 防遗忘。

3. 做得更好的演进（三条线）

flowchart TD
  subgraph A[线A 补回 SAA 强项·防遗忘]
    A1[streaming SSE 进度→创作页进度条]
    A2[player 子图 + vision‖text 并行→顾问提速]
  end
  subgraph B[线B 可玩地板·数据驱动·优先]
    B1[H_progress 85% 诊断<br/>driver覆盖 vs 真终态缺口]
    B2[强化 design-agent 自产 driver<br/>尤 tap-targets + safe-oracle]
    B3[latch 终态健壮性<br/>用 observation 逐节点定位]
  end
  subgraph C[线C 好玩天花板·爆款]
    C1[三层质量校准<br/>门/M3/人锚 calibrate.py]
    C2[scale-20 补全 + 四模型横比]
    C3[fun/留存/可分享<br/>门之上的主观层]
  end
  B -->|地板稳了再抬| C

• 线 B = 当前最高回报（数据背书）：H_progress 85% 是 moat「一句话现生成」漏水点。第一步 = 免费诊断——把现有 H_progress 失败按根因分类（harness driver 盲打打不中 = 可测性缺口 / 游戏真到不了终态 = 生成缺口 / 实例 bug）。skill §7 强烈提示 tap/离散点击类的自产 driver 缺口是主犯。诊断完才知道是改 DESIGN_SYSTEM（强制产 tap-targets driver + exportState）还是收紧 latch 约束。
• 线 A = 防遗忘：migration §6.2 step6（streaming）+ §2#11（子图并行）是迁移自己列的待办，别随框架切换被忘掉；SSE 进度条直接提升创作者体验。
• 线 C = 爆款：九门只证"可玩"，爆款要"好玩/留存"。先沿用 calibrate.py 人锚把 M3 主观层校准好、补 scale-20 + 四模型横比，再谈 fun/留存/可分享的主观层（留人锚兜底）。别在 85% 到不了终态时先优化 fun。

4. 待确认

1. 线 B 先行：是否先做 H_progress 85% 免费诊断（读现有 verdict.json + 失败款源码/driver 分类根因）？建议待 #1 批跑完（样本更全、含 SAA 臂）再跑，~免费。
2. 线 A 时机：streaming 进度 / player 子图并行何时补（创作页进度条是产品可感项）？
3. 线 C 立项：爆款"好玩层"（fun/留存）现在立项，还是等可玩地板稳了再启？
4. 本稿是否提交存档为生成引擎主线的"传承+演进"基线。

---

一句话：原任务一件没丢（§2 账可查）；换框架反而净增了 checkpoint/observation 两件武器。下一步真正的杠杆不是任何"新花活"，是拿数据（H_progress 85%）+ observation 把可玩地板焊死——让"一句话现生成"稳定产出真能玩的游戏，这才是离爆款最近的一步。