docs(t1-close): W-T1a 七步收口——引擎终裁LittleJS+模板双层架构拍板全量回填

七步对账(wave-close-checklist):
1.总账:表头2026-06-12+对账c514d60;§5 runtime口径改Runner v2;§6 新增W-T1a执行记录行
2.作战清单:W-T1a完成移归档⑪;登记W-T1b(双spec编制中);§0完成线建议候选更新(拔高样板过创始人判)提请重锁
3.回填(裁定类):终裁包落锤横幅/重设计spec v1.2/tech-decisions §1.1+技术栈行(LittleJS终裁+双层架构)/glossary词条/记忆双档
4..agent:game-studio横幅更新(引擎已终裁,W-T1b建设中)——结构性状态变化
5.蒸馏:staging-ops新增mini-desktop长驻serve配方(systemd-run首选/setsid双脱离+探活门/heredoc竞态红线);Phaser侧专有配方(切形态/净增量取差)不蒸馏——败选侧低复用,证据留lane REPORT可溯
6.索引:无结构性变更(纯内容追加),README/AGENTS导航不动
7.编排资产:spike全部脚本已随lane/phase2入库;终裁包v1.2兼本波收口报告

创始人拍板记录:引擎=LittleJS;模板双层架构(核心代码模板=平台核心层类高级引擎固定核心留LLM灵活面/玩法模板=品类层带质量底线生成须高于底线);美术=程序化系统+像素资产包混合;亲玩判词「玩法简单缺艺术气息」(engine-neutral)→好玩基线v2五要素;拔高样板=W-T1b首件

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
zizi 2026-06-12 00:26:16 +00:00
parent c514d600db
commit 13b8a51e47
9 changed files with 17 additions and 10 deletions

View File

@ -46,7 +46,7 @@
| **Golden Config 回归** | 用模板标准配置样例做比对回归,确保模型/模板迭代后生成质量不退化。 |
| **trace_id** | Gateway 入口注入、全链路透传(含 Dify/OpenGame 调用与运行时 SDK的追踪 ID是调试与可观测的主线。 |
| **DAU** | 日活跃用户MVP 目标 1,000 DAU正式目标 100,000 DAU。 |
| **分层运行时Tier1/2/3** | 游戏产物三层Tier1 极轻量H5/2DMVP 唯一交付层;2026-06-11 重设计中:自研 Canvas 壳→成品轻引擎+Runner v215KB 红线废除、改三层约束框架,见 `docs/brainstorms/2026-06-11-tier1-runtime-constraints-requirements.md`Tier2 复杂2D+3D / Tier3 独立App=Cocos Creator 3.8.8+MCP。详见 tech-decisions §1.1。 |
| **分层运行时Tier1/2/3** | 游戏产物三层Tier1 极轻量H5/2DMVP 唯一交付层;**引擎=LittleJS2026-06-12 终裁**+Runner v2+模板双层架构〔核心代码模板/玩法模板15KB 红线已废除、改三层约束框架,见 `docs/brainstorms/2026-06-11-tier1-runtime-constraints-requirements.md`Tier2 复杂2D+3D / Tier3 独立App=Cocos Creator 3.8.8+MCP。详见 tech-decisions §1.1。 |
| **Cocos-MCP** | 用 MCP 协议(158 工具)让 AI 驱动 Cocos Creator 3.8.8 编辑器做复杂2D/3D/原生游戏;属有状态 agentic 编排、归 studio区别于 OpenGame 单次文生代码归 aigc。 |
| **Prompt RegistryPrompt 即契约)** | git `contracts/prompts/` 为全生命周期 prompt 的单一事实源(第 8 类契约):版本化 + 输入输出 Schema 绑定 + 约束块 + Golden 集 + owner运行时按 `id@version` 加载注入、不内嵌引擎内核。 |
| **Prompt 轻量门禁** | prompt 改动 PR 触发的效果验证Schema 通过率 + 生成成功率≥80% + Golden 回归 + 成本/延迟不劣化 + 人工抽检;可玩性靠行为指标反哺、不做结构化自动评分。 |

View File

@ -35,7 +35,7 @@
| 层 | 定位 | 选型 | 生成路径 | 状态 |
|---|---|---|---|---|
| **Tier1 极轻量H5/2D** | 游戏流即点即玩,首屏 P75<3s + 点卡可玩 S2常态2s | ~~自研轻量 Canvas Runtime(<15KB)~~ **成品轻引擎 + Runner v22026-06-11 二次质疑裁定回填**引擎 URL 化交付享 HTTP+编译双缓存B1 入场券 gz350KB/raw1.5MB**终裁待 LittleJS vs Phaser spike**iframe 沙箱 + SDK 注入不变 | **模板驱动C2 裁定)**LLM 填参 + 固定模板模板改为 Runner 内置模块 | 🔄 重设计中**MVP 唯一交付层**。真护城河=沙箱/SDK/契约/三容器(全保留),渲染壳非护城河;存量 1.x 双轨冻结 |
| **Tier1 极轻量H5/2D** | 游戏流即点即玩,首屏 P75<3s + 点卡可玩 S2常态2s | ~~自研轻量 Canvas Runtime(<15KB)~~ **LittleJS + Runner v22026-06-12 创始人终裁spike 85/82冷开 0.54s vs 2.86s=4.8~5.3×/引擎 15.9KB gz/敏感性分析裁量分拉平 S2 硬差仍定向,终裁包 `docs/agent-specs/2026-06-11-T1引擎终裁包.md`**引擎 URL 化交付享 HTTP+编译双缓存**模板双层架构**=核心代码模板平台核心层手感/调色板/音乐/后处理/资产框架+ 玩法模板品类层带质量底线好玩基线 v2 五要素iframe 沙箱 + SDK 注入不变 | **模板驱动C2 裁定)**LLM 填参美术=程序化系统+像素资产包混合LLM palette/资产变体 | 🔄 W-T1b 建设中首件=拔高样板过创始人判),**MVP 唯一交付层**。真护城河=沙箱/SDK/契约/三容器(全保留);存量 1.x 双轨冻结引擎复议权=拔高暴露引擎级阻塞(终裁包 §4.5-3 |
| **Tier2 复杂2D+3D** | 中重度含 3D渠道分发 | **Cocos Creator 3.8.8 + MCP**(备选 PlayCanvas | **Cocos-MCP** agentic 工具编排studio 编排) | ✅ 锁定。MCP 158 工具可 AI 驱动MVP 至多 1 个探针 demo |
| **Tier3 独立App** | 打包为原生应用 | **Cocos 原生导出**(同 Tier2 引擎) | 同 Tier2 + 打包 | ✅ 锁定引擎。否决 UnityAI 适配差、启动重MVP 后投入 |
@ -74,7 +74,7 @@
| 口径点 | 权威结论 |
|---|---|
| **运行时技术栈** | Tier1=成品轻引擎+Runner v22026-06-11 回填:原自研<15KB 壳退役存量 1.x 冻结终裁待 LittleJS vs Phaser spikeTier2/3=Cocos Creator 3.8.8+MCP §1.1)。Three.js/LayaAir/Unity 仍否决**Phaser 的旧否决仅针对全栈通吃语境不约束 Tier1 单层竞标** |
| **运行时技术栈** | Tier1=**LittleJS2026-06-12 终裁)**+Runner v2原自研<15KB 壳退役存量 1.x 冻结Tier2/3=Cocos Creator 3.8.8+MCP §1.1)。Three.js/LayaAir/Unity 仍否决Phaser spike 竞标落选败于冷开/交付形态工程质量合格证据留 spike 目录 |
| **生成成功率指标** | MVP 验收按 **≥80%** 判定;**≥85%** 为远期蓝图目标,勿用 85% 卡 MVP |
| **时间线** | 双路线并存:投资人版 5 人/11 周、执行 spec 10 人/3 周;执行排期以 mvp-execution-spec 为准(含逐日计划与里程碑) |
| **MVP 范围/口径** | MVP 验收以 Doc A 的 **55 项 P0 产品功能**为准;技术实现范围经 Doc C 反查 Doc B工作量 ≈137 技术项)。详见 [`mvp-scope-and-milestones.md`](./mvp-scope-and-milestones.md) §3 |

View File

@ -32,6 +32,7 @@
- mini-desktop 构建 game-studio **必须 `npm run build -- --mode staging`**vite preview 直接 serve 工作树 dist默认 build = 事实上改部署、mock 中间件接管且无 warn
- yudao 前端game-admin稳定配方**pnpm9**`corepack prepare pnpm@9.15.4 --activate`,一举绕开 pnpm10+ 的 lockfile 镜像校验与构建脚本审批两道坎)+ 前端目录 `.npmrc` 设 npmmirror → `node --max_old_space_size=4096 ./node_modules/vite/bin/vite.js build`(绕 pnpm-run 预检。node_modules 腐化(如混入 vite8 / 杂散 `pnpm-workspace.yaml` 报 packages 缺失)→ 移开杂散文件 → 清装精确回钉版本。
- yudao-module-system 测试:**`SPRING_DATA_REDIS_PORT=26379 mvn test ...`**(宿主 16379 被 staging redis 占用带密码,嵌入式 RedisServer 失败被吞 → NOAUTH 假红)。
- **mini-desktop 长驻 serve/后台进程**2026-06-11 T1-spike 双 lane 实证ssh 会话内 `nohup &`/`setsid` 仍可能随会话 teardown 被 SIGHUP 连带杀(症状=稍后访问 ERR_CONNECTION_REFUSED。稳定配方**首选 `systemd-run --unit=<name>` 起 durable 单元**;次选独立 launcher `setsid bash -c 'exec node serve.cjs'` 双脱离 + **起服后 5×6s 探活门**curl 200 连续过)确认常驻再继续。另:长任务后台进程严禁与 `pkill`/`curl` 写进同一 heredoc 串行(竞态留孤儿进程占 pid 不占端口)。
## 5. 冒烟门

View File

@ -9,6 +9,8 @@
## 0. 一页结论
> **🔨 终裁落锤2026-06-12创始人****Tier1 引擎 = LittleJS**。拔高样板(好玩基线 v2 五要素拉满一包)列为 W-T1b 首件,过创始人判;引擎复议权按 §4.5-3 保留拔高若暴露引擎级阻塞可复议Runner/契约层不受影响)。同场拍板:**模板双层架构**——核心代码模板(平台核心层:手感/调色板/音乐/后处理/资产框架,固定核心、给 LLM 留灵活面)+ 玩法模板(品类层,带质量底线,生成结果须高于底线);美术=程序化系统+像素资产包混合。§6 下一步即刻生效。
**计分LittleJS 85 / Phaser 82满分 100实测数字全可溯源分值含裁量分——规则与敏感性见 §1 注。我的裁决建议LittleJS。**
决定性理由不是总分差 3 分,而是**主考 S2 的结构性差异**
@ -70,7 +72,8 @@
| `http://100.64.0.7:4311/host.html?game=catcher` / `?game=shop` | LittleJS 月光捕手 / 王蓝莓小卖部 |
| `http://100.64.0.7:4312/?game=catcher` / `?game=shop` | Phaser 月光捕手 / 王蓝莓小卖部 |
> 判词维度建议:跟手度(拖动/点按延迟体感、juice 成色(粒子/音效/屏震——音效需首次点击后解锁)、中文 UI 观感、整体「想再来一局」感。**判词栏(待填)**:____。计分表之外你有否决权。
> 判词维度建议:跟手度(拖动/点按延迟体感、juice 成色(粒子/音效/屏震——音效需首次点击后解锁)、中文 UI 观感、整体「想再来一局」感。计分表之外你有否决权。
> **判词2026-06-11 创始人首轮)**:「玩法仍过于简单,缺乏艺术气息」——并附 js13k/PICO-8 历年杰作清单Witchcat/Celeste Classic/Q1K3 等)为质量标杆。**判读该反馈对两引擎无差别engine-neutral不构成 §4.5-1 亲玩否决的引擎翻盘),落差判给模板工艺层**——现行好玩基线juice 清单)天花板不足,触发「好玩基线 v2五要素手感/美术统一性/音乐/结构深度/角色壳)+ 拔高样板试验」spike 按执行单"不镀金"纪律刻意最小化,质量上限未代表生产态。
## 6. 终裁后的下一步

View File

@ -1,6 +1,6 @@
# Tier1 运行时重设计 · 评审版HJ-T1-REDESIGN-001
> **状态v1.1四路尽调回填 + 约束框架定稿落账)→ 待创始人 §9 三项拍板。**
> **状态v1.2 —— 🔨 引擎已终裁 LittleJS2026-06-12spike 85/82终裁包 `2026-06-11-T1引擎终裁包.md`D3 模板架构升级为创始人拍板的双层制(核心代码模板/玩法模板,好玩基线 v2 五要素W-T1b 双 spec 接续。**
> **约束框架单一事实源**`docs/brainstorms/2026-06-11-tier1-runtime-constraints-requirements.md`2026-06-11 创始人拍板15KB 红线废除 → SLO 地板@千元机+4G P75 / 预算入场券 / 工程增强层三层框架)。
> 本文件产自「Tier1 栈由创始人亲自设计的专门会话」2026-06-11 拍板,见记忆 `tiered-engine-cocos-decision`)。主会话已完成诊断+给候选;本会话职责 = 设计 + 创始人裁决。
> 日期2026-06-11 分支:`dev/2.0.0` 上游:`.agents/knowledge/tech-decisions.md` §1.1(裁决后须回填)

View File

@ -63,4 +63,6 @@
## 后续归档
- 🤖 **我**:⑪ **Tier1 重设计 W-T1a ✅ 2026-06-12 收口**约束框架定稿15KB 废除→三层框架,创始人逐项拍板:参考环境=千元机+4G P75 / B1 放宽档 / 预算=入场券·S2=主考〕→ 四路引擎尽调+查漏 → 双游戏×双引擎 4 包 spike 五门全过〔月光捕手+王蓝莓小卖部CDP 真输入三重实证Codex Xhigh 评审通道×3→ Phase2 节流测量〔冷开 4.8~5.3× 差〕→ 终裁包 v1.185/82+敏感性分析〕→ **创始人终裁=LittleJS** + 亲玩判词「玩法简单缺艺术气息」→ 好玩基线 v2 五要素 + **模板双层架构拍板**〔核心代码模板/玩法模板,美术混合〕;副产:「每游戏=小增量」实测 2.2-2.5KB gz/款、Phaser unsafe-eval 钉子拆除存档、serve 常驻配方蒸馏;详 `2026-06-11-T1引擎终裁包.md`+总账 §6
(每轮收口后追加于此)

View File

@ -7,11 +7,11 @@
## 0. 本轮完成线(⚠️ 待你拍板重锁)
**建议候选**:五条链路全部真 UI 走查闭合(③⑤ 收尾)+ M4 变现真实化开工(链路④从骨架转真实的第一片)。你拍板后改写本节并注明锁定日。
**建议候选2026-06-12 更新)****W-T1b 拔高样板过创始人判**(好玩基线 v2 立标Tier1 重设计的质量锚点)+ 链路③⑤真 UI 走查闭合。你拍板后改写本节并注明锁定日。
## 队列〔🤖 我〕
- [ ] **Tier1 引擎 eval-spikeW-T1ain flight 2026-06-11**LittleJS vs Phaser **双游戏×双引擎=4 包**「月光捕手」action 镜头+「王蓝莓小卖部」经营/CJK 镜头)实测终裁 + **创始人亲玩 4 包**约束框架已定稿15KB 废除→三层框架S2 主考;执行单 `2026-06-11-T1引擎spike-execution.md` v1.2);终裁后重锁本轮完成线
- [ ] **W-T1bRunner v2 + 核心代码模板 + 拔高样板(双 spec 编制中)**:引擎已终裁 **LittleJS**2026-06-12终裁包 `2026-06-11-T1引擎终裁包.md`);模板双层架构已拍(核心代码模板/玩法模板+美术混合);**首件=拔高样板(五要素拉满一包)过创始人判** → 四模板重做W-T1c随后
- [ ] **studio 链路③⑤ UI 走查闭合**A2 recon 已逮 5 bug修复+重走查)
- [ ] **feed 翻页桩必修**(鉴权波遗留债 §4内容池已 50 款 > 30 触发线)
- [ ] **W4 单位经济埋点·后端段**(按 [`单位经济敏感性模型.md`](./单位经济敏感性模型.md) §7 测量计划扩 B2 回路)

View File

@ -3,7 +3,7 @@
> **本文件是项目管理唯一活账**:把「计划 ↔ 完成 ↔ 待办 ↔ 执行记录」对在一起。
> **铁律**:每次波次收口、每次里程碑状态变化,**必须按 [`wave-close-checklist`](../../.agents/skills/wave-close-checklist.md) 七步收口**(本表+表头日期、作战清单+归档、回填、蒸馏、索引;`.agent` 仅结构变化时),否则视为未收口。
> 计划权威来源:`.agents/knowledge/mvp-scope-and-milestones.md`55 P0 / 137 技术项 / M0-M5`docs/architecture/{产品需求清单,技术架构与模块,需求模块映射}.md`Doc A/B/C`docs/superpowers/specs/mvp-execution-spec-design.md`
> 维护:主 agent 最近更新:**2026-06-11**Wave4 community+biz 收口转真实〔`f403d11`+ harness 体检纠偏——表头日期曾停在 06-09 漂移两日,自此随 checklist 第 1 步强制同步;对账至 commit `f403d11`+本次)。
> 维护:主 agent 最近更新:**2026-06-12**Tier1 重设计 W-T1a 收口约束框架定稿15KB 废除→三层框架〕+引擎 eval-spike 终裁=**LittleJS**+模板双层架构拍板;对账至 commit `c514d60`+本次收口)。
---
@ -96,7 +96,7 @@
### P0-真实化(决定 M2-M5 能否达成,是 MVP 的真正大头)
- [x] **aigc真实生成M2 攻坚点)✅ M2 整体收口2026-06-10两段证据分别引用**——①成功率口径达标 = batch-001 实测 **80.0%**20 创意全自动/零 infra/双锚复核,产物 `agent-loop-v1/runs/batch-001/`)∧ ②生成链路贯通 = M-b 薄轮询执行器上线42d3237部署 #3.1 实证HTTP 18s/UI 27s succeeded + dodge 正确失败 + watchdog 收尸5 独立样本全自动达终态、审计列 '0' 落库)。**真实用户在 UI 一句话→18-27s 拿到可玩游戏。** 渲染面已扩M-b② theme/scoreLabel 入画布。Dify 暂不部署,回调契约兼容后接零改
- [ ] **runtime真实编译打包**Canvas Runtime 产物 + GamePackage 真实产出
- [ ] **runtime真实编译打包**——口径已随 Tier1 重设计改写为 **Runner v2 产物**(引擎已终裁 LittleJSGamePackage 真实产出随 W-T1b/β 落地,见 `docs/agent-specs/2026-06-11-T1引擎终裁包.md` §6
- [ ] **OSSMinIO bucket 级隔离 + 真实存取**(本波跳过,桩)
- [ ] **telemetryMQ 消费聚合 + quality_score + feed 反哺**M5 数据回路)
- [ ] **ad/trade真实广告联盟 + pay 模块接线**M4
@ -139,6 +139,7 @@
> 各波次详细 spec`docs/agent-specs/`review + execution 双 spec
---
| **Tier1 重设计 W-T1a约束框架+引擎 eval-spike 终裁)** | 2026-06-11~12 创始人专门会话Fable Max①**15KB 红线废除→三层约束框架**SLO@千元机+4G P75 / B1 入场券 gz≤350KB·raw≤1.5MB / 工程增强层 E1-E6拍板落 `docs/brainstorms/2026-06-11-tier1-runtime-constraints-requirements.md`,文档回填 A/B/C 三类 11 档②四路引擎尽调KAPLAY「LLM friendly」证伪淘汰/自研+微库淘汰)→ **双游戏×双引擎=4 包 spike**(月光捕手 action+王蓝莓小卖部 经营/CJK五门×4 全过零假绿CDP 真实输入三重实证Codex 5.5 Xhigh 评审通道首跑×3 全成功)→ Phase2 节流测量(**冷开 LittleJS 0.54-0.59s vs Phaser 2.82-2.86s=4.8~5.3×**,编译缓存省 2.1s 仅救二开起fps/内存/CSP 全过)→ 终裁包 v1.1**85/82**+裁量分敏感性分析:拉平后 S2 硬差+8 仍定向);③**创始人终裁=LittleJS**2026-06-12+ 亲玩判词「玩法简单缺艺术气息」engine-neutral**好玩基线 v2 五要素**(手感/美术统一性/音乐/结构深度/角色壳)+ **模板双层架构拍板**(核心代码模板=平台核心层 / 玩法模板=品类层带质量底线;美术=程序化系统+像素资产包混合)→ 拔高样板列 W-T1b 首件;副产=「每游戏=小增量」实测成立(游戏②净增量 2.2/2.5KB gz | 提交链 `75d01f0``c514d60`10 提交spike 证据 `2026-06-11-tier1-engine-spike/{lane-littlejs,lane-phaser,phase2}/`;终裁包 `2026-06-11-T1引擎终裁包.md`(兼本波收口报告) | 4 包五门证据三重实证(真输入轨迹+host 单时钟七锚点+递进截图Phase2 三遍中位+不稳定项声明;终裁包经 Codex 对抗复核 P0×3 整改spike 代码隔离 spike 目录零碰生产路径 |
## 7. 风险与口径提醒

View File

@ -1,7 +1,7 @@
# game-studio产品端前端 · 创作者 + 玩家)
> **状态:双区建成并接 staging 真后端2026-06-11 对账)。** 创作链路①与发布段 UI 走查全绿、真人试玩链路③ e2e 闭环HJ-FE-WALK-001mock 仅作离线兜底。**进度一律以 `docs/mvp/MVP进度总账.md` 为准,本文件只随结构变化更新。**
> **⚠️ Tier1 重设计立项2026-06-11**`src/host/runtime/` 自研壳(<15KB将由「成品轻引擎 + Runner v2」取代15KB 红线废除、改三层约束框架(`docs/brainstorms/2026-06-11-tier1-runtime-constraints-requirements.md`);引擎终裁待 LittleJS vs Phaser spike存量 1.x 路径双轨冻结
> **⚠️ Tier1 重设计2026-06-12 引擎已终裁)**`src/host/runtime/` 自研壳(<15KB将由「**LittleJS** + Runner v2 + 模板双层架构〔核心代码模板/玩法模板〕」取代(终裁包 `docs/agent-specs/2026-06-11-T1引擎终裁包.md`;约束=三层框架15KB 红线已废除W-T1b 建设中,存量 1.x 路径双轨冻结只修 P0
> 上游契约:仓根 `contracts/`5 API YAML + sdk-interface.d.ts#3 + game-package.schema.json#4单一事实源
> 建设过程与验收详见 `docs/agent-specs/2026-06-08-前端game-studio建设-{review,execution}.md`。