diff --git a/docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md b/docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md index 9ec1ec92..a38037bf 100644 --- a/docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md +++ b/docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md @@ -20,6 +20,31 @@ canonical: docs/agent-specs/2026-06-17-固定游戏架构与SAA-agentic-studio-{ --- +## 执行状态(2026-06-18 收口 · Mac 全开发线交付 · 分支 `feat/mac-saa-gen-lifecycle` 已推 origin 供 6c6g 审) + +> 执行收口快照(决策正文 U1-U5 / KTD / HTD 不动)。状态轴 = 交付 / 验证 / 待办。 + +**U1–U4 已交付 + 本机验证 + 推送:** +- **U1(引擎线·含正式化)**:`game-runtime/src/host/gd-runtime.js`(createRuntime/rt) + 单测 + 4 品类收敛证(gd-archetypes) + 约定文 `runtime-api-2d.md` + **`runtime-api-2d.d.ts`(TS 契约·第10类 additive·正式化产物)** + **clickable 声明式点击基元**(治便宜模型 tap-handler 顽疾)。`node --test` 60/60。 +- **U2(接缝·零改下游)**:`build-from-source.mjs`(装配器+CLI) + 后端接缝(`SaaGenNodes.validateNode` gamedef 经 CLI 子进程校验+装配 → factorySrc,**scaffold/build/harness/build.mjs 全零改**) + 确定性点改解锁(`modifyNode`/`modifyRouter` gamedef→validate)。 +- **U3**:`SaaPrompts.GAMEDEF_SYSTEM`(2 few-shot:realtime + tap-targets 声明式 clickable) + `buildGameDefMessages` + `generateNode` gamedef 分支产 `K_SOURCE_PROJECT`;flag `saaSourceMode`(默认 `factory` 字节不变,灰度 opt-in)。 +- **U4**:`generateNode` 多模型回退链(`GenModels` record,主 deepseek-v4-flash → stage2 救场升档)。 +- **双评审整改**:ce-correctness × ce-adversarial 18 条全核证整改(driver 命名路径投影 / 校验边界静态扫描治死循环+沙箱+确定性逃逸 / rt 冻结 / addScore 守 num)。 +- **后端验收**:`mvn test-compile` 过 + 模型无关单测 Topology 30/30 + Regression 8/8(含 gamedef deterministic→validate 路由证)。 + +**gamedef 路实证(lili-mac 快走查 `wg1/gen-worker/gamedef_quickcheck.py`):** +- **范式端到端真成立·路径证正确**:声明式 gameDefinition → 装配 → 构建 → 真九门;手写金样两品类(realtime/physics + tap-targets)均**过 harness 9/9**;**repair 回环真抬率**(runner 7/9→9/9)。 +- **success rate = 引擎生成能力(非本计划完成项)**:便宜模型单管线产出**高方差**(同 brief 8/9~5/9),N=1~2 本机小样信噪比不足。**正式 cutover ≥60% 量测 authoritative = mini-desktop `SaaFullGraphE2eTest -Dsaa.e2e=1`**(多 brief + 5+3 repair + stage2)。 + +**U5(ReAct · 接法B)= 正式延期**:项目 pom 明示「ReactAgent/asNode 延 Phase1.5」+ 本计划「地基稳后」门 + R4 便宜模型 tool-use 待实测;本期只做 dependency 前置核版,未写不可验代码。 + +**待 6c6g(本计划「不动现 8 契约」/ 共享 DESIGN_SYSTEM / 评审 域):** +- `source-project.schema.json` 的 component `kind` 枚举增 `clickable`(additive contract-first 补正;现经宽松校验功能可用)。 +- design↔gamedef 的 `assertAfterPlay` 字段词汇契约(design 常造 `moves`/`totalRound` 等取证读不到字段 → 应约束到 `score`/`remaining`)。 +- 每单元 codex 一轮评审(分支已推)。 + +--- + ## 摘要 把已双证的 PoC **产线化进 SAA**,让"改源不改包 / 可维护结构化源项目 / LLM as 工作室"真正上产线:运行时访问约定(2D 适配器契约)→ build-from-source 产线化 → generate 真产 gameDefinition(替现 iife 空壳)→ 模型可靠性兜底 → 地基稳后 **ReAct 演进**(接法B)。**接法A(裸图 16 节点 studio,已建七成、已合 dev/2.0.0)是接法B 的躯干,evolve 增量不返工。** 架构 SoT 见 canonical(固定架构与SAA-agentic-studio),本档是其**产线化执行计划**,不重复架构。