docs: 玩法模板优先级全局纠偏——非最高优先级(最高=Tier0生成可靠)

创始人裁定:玩法模板(品类引导框架)非最高优先级待建。普查总账(bd93c35c)
已写对(高价值但非#1,排在Tier0生成可靠之后),但 HJ-DEMO-AUDIT-001 的
propagation 在 7 个 LIVE 档/工具里仍写"当前最高优先级待建",产生漂移。
本次全局对齐到总账已批口径。

改(LIVE,~11处/7文件):
- docs/architecture/系统概要设计-技术决策版(3处)
- docs/agent-specs/{引擎与运行时,战略与合规,文档整理-plan(3处)}
- .agents/knowledge/{tech-decisions,product-and-architecture}
- .agents/tools/doc-organizer-analyze.mjs(真相基线串,防再传播)
留:_archive 3 档历史记录不改正文(现行 canonical 纠正后即权威)。
memory 另在 ~/.claude 改(不入仓)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
zizi 2026-06-17 14:51:40 +00:00
parent ebb994b155
commit be468b6b2c
7 changed files with 11 additions and 11 deletions

View File

@ -45,7 +45,7 @@
> **⚠️ 现行口径回填2026-06-12单源已 commit `1272383` 清毒;本蒸馏同步纠偏)**下方分层图的「AI 引擎层 / 运行时栈 / 中间件层」为 1.x 蓝图态,部分组件已非现行主线,按下列裁决读:
> - **AI 引擎层**:生成主线 = **new-api 网关 → 便宜模型直连**agent 写码于插件库HJ-GEN-001 终审);**Dify/OpenGame = 降级远期、从未部署**C2 / HJ-GEN-001。agentic 编排基建 = **SAA(Spring AI Alibaba v1.1.2.2)裸图编排 (HJ-AGI-002short-term SAA-onlyAgentScope 降 long-term premium 独立轨)**,「自研编排/DAG 工作流引擎」表述作废。
> - **运行时栈 Tier1**= **LittleJS 增强发行版 + Runner v2**2026-06-12 创始人终裁);「自研 Canvas Runtime<15KB废除;「模板双层/游戏模板填参式整局代码)」废除 W-CLEAN )→模板=LittleJS 能力插件/二次开发件玩法/美术/关卡/UI=agent 生成域:「玩法模板」(品类框架·引导生成·非填参代码未废当前最高优先级待建generic 桥接 7534bdf9 暂解 limboHJ-DEMO-AUDIT-001)。Tier2/3 = Cocos+MCP 不变详见 [`tech-decisions.md`](./tech-decisions.md) §1.1
> - **运行时栈 Tier1**= **LittleJS 增强发行版 + Runner v2**2026-06-12 创始人终裁);「自研 Canvas Runtime<15KB废除;「模板双层/游戏模板填参式整局代码)」废除 W-CLEAN )→模板=LittleJS 能力插件/二次开发件玩法/美术/关卡/UI=agent 生成域:「玩法模板」(品类框架·引导生成·非填参代码未废有效·待建但非最高优先级最高=Tier 0 生成可靠玩法模板排其后generic 桥接 7534bdf9 暂解 limboHJ-DEMO-AUDIT-001 创始人 06-17)。Tier2/3 = Cocos+MCP 不变详见 [`tech-decisions.md`](./tech-decisions.md) §1.1
> - **中间件层****RocketMQ / Nacos = future-stateMVP 未部署**(异步走 Spring 内事件/同步链路)。
```

View File

@ -10,7 +10,7 @@
## 1. 关键决策表ADR
> **⚠️ 回填2026-06-10HJ-AUDIT-001;再回填 2026-06-12三回填 2026-06-15 HJ-AGI-002**下表「AI 生成引擎」行已被取代两轮——~~C2 裁定后 MVP 主线=模板驱动LLM 直出 GameConfig+固定模板)~~ → **现行主线=agent 写码于插件库**HJ-GEN-001 终审 2026-06-12游戏模板/填参线随 W-CLEAN 清除退役;**「玩法模板」(品类框架·引导生成·非 pre-built 代码)未废=当前最高优先级待建(HJ-DEMO-AUDIT-001 创始人 06-17 纠正)**;生产生成=便宜模型经 new-api+harness 门agentic 基建=SAA(Spring AI Alibaba v1.1.2.2)裸图编排 (HJ-AGI-002short-term SAA-onlyAgentScope 降 long-term premium 独立轨)。Dify/OpenGame 均未部署、降级远期。§1.1 Tier1 行的「OpenGame 文生代码」同此。
> **⚠️ 回填2026-06-10HJ-AUDIT-001;再回填 2026-06-12三回填 2026-06-15 HJ-AGI-002**下表「AI 生成引擎」行已被取代两轮——~~C2 裁定后 MVP 主线=模板驱动LLM 直出 GameConfig+固定模板)~~ → **现行主线=agent 写码于插件库**HJ-GEN-001 终审 2026-06-12游戏模板/填参线随 W-CLEAN 清除退役;**「玩法模板」(品类框架·引导生成·非 pre-built 代码)未废=有效·待建但非最高优先级(最高=Tier 0 生成可靠,玩法模板排其后;HJ-DEMO-AUDIT-001 创始人 06-17见完成度与优先级总账)**;生产生成=便宜模型经 new-api+harness 门agentic 基建=SAA(Spring AI Alibaba v1.1.2.2)裸图编排 (HJ-AGI-002short-term SAA-onlyAgentScope 降 long-term premium 独立轨)。Dify/OpenGame 均未部署、降级远期。§1.1 Tier1 行的「OpenGame 文生代码」同此。
> **⚠️ 回填2026-06-11Tier1 重设计·创始人专门会话)**:下表「游戏运行时」行的 **Tier1「自研 Canvas<15KB」被二次质疑裁定取代**——自研壳实为机制演示(资产载而不绘/零 juice/只胜不败),手搓引擎=critical risk**15KB 红线废除**(系 srcdoc 内联架构的衍生约束前提已失效改为三层约束框架SLO 地板@千元机+4G P75 / 预算入场券 B1 gz≤350KB·raw≤1.5MB / 工程增强层 E1-E6引擎=契约下可换的实现,**终裁待 LittleJS vs Phaser eval-spike**。单一事实源:`docs/brainstorms/2026-06-11-tier1-runtime-constraints-requirements.md` + `docs/agent-specs/_archive/2026-06-11-Tier1运行时重设计-review.md`
| 决策点 | 选择 | 理由 | 放弃的备选why-not | 风险 |

View File

@ -18,7 +18,7 @@ const staleDocs = Array.isArray(A.staleDocs) ? A.staleDocs : []
const TRUTH =
'现行真相:生成主线=模板驱动 via new-api 网关(Dify/OpenGame 降 long-term·MVP 从不部署);' +
'引擎=LittleJS 增强发行版(55KB gz,勿写13/15KB)+Runner v2(game-host.d.ts),自研 Canvas<15KB 已废;' +
'模板=LittleJS 插件;游戏模板/填参线已废(W-CLEAN),玩法模板(品类框架·引导生成·非pre-built代码)未废=最高优先级待建(HJ-DEMO-AUDIT-001 创始人06-17纠正);agentic=SAA(Spring AI Alibaba GA v1.1.2.2)裸图(HJ-AGI-002),AgentScope 降 long-term;' +
'模板=LittleJS 插件;游戏模板/填参线已废(W-CLEAN),玩法模板(品类框架·引导生成·非pre-built代码)未废=有效待建但非最高优先级(最高=Tier0生成可靠,玩法模板排其后;HJ-DEMO-AUDIT-001 创始人06-17);agentic=SAA(Spring AI Alibaba GA v1.1.2.2)裸图(HJ-AGI-002),AgentScope 降 long-term;' +
'美术/音乐=mmx-cli,ComfyUI 退备选;RocketMQ/Nacos=框架自带但 MVP 未部署=future-state(勿删);命名空间=com.wanxiang.huijing;品牌=绘境AI'
const CLS = {

View File

@ -11,7 +11,7 @@
1. **窗口口径**06-16 已做首轮全量治理21M→4M·64 档归档),故 06-10→06-15 的 13 顶层档昨天刚判 ACTIVE 并保留。本轮**真增量 = 06-16 那批 20 档**昨天「今日在飞不动」、今天已可裁。06-17 的 9 档 = 今天在飞,**红线不碰**。
2. **过期分类20 档)****KEEP 16 / COMPRESS 2 / ARCHIVE 2**。需动手的只有 4 档——压 2 桩(被 06-17 同线 supersede、归 2 档(已执行/已否决留痕)。
3. **核心档措辞****Dify/OpenGame 家族零真改**(采样全是已标作废/决策史/future-state证实 06-16 对齐可信);**真问题 = 玩法模板术语漂移 16 处 + 关联生成口径 1 处,跨 4 核心档 + 工具 1 处**——按 **HJ-DEMO-AUDIT-001创始人 06-17 纠正)** 须正名「游戏模板/填参线已废」并补「玩法模板(品类框架)未废=最高优先级待建」。**这是本轮"核心档更新到最新"的头号项**。
3. **核心档措辞****Dify/OpenGame 家族零真改**(采样全是已标作废/决策史/future-state证实 06-16 对齐可信);**真问题 = 玩法模板术语漂移 16 处 + 关联生成口径 1 处,跨 4 核心档 + 工具 1 处**——按 **HJ-DEMO-AUDIT-001创始人 06-17 纠正)** 须正名「游戏模板/填参线已废」并补「玩法模板(品类框架)未废=有效待建但非最高优先级(最高=Tier 0 生成可靠)」。**这是本轮"核心档更新到最新"的头号项**。
4. **进度总账**:①**M2「现在时漂移」**(仍写"四模板可生成",但 W-CLEAN 已清旧模板、generic 桥接接棒)= demo 审计 C6 已核实,须改;②**06-17 工作回填**SAA trace 真库收口 / generic 一句话入口 / crypto.subtle 整款加载修 / 完成度 census
5. **工具新鲜度**`doc-organizer.sh` 硬编码「最新日在飞=2026-06-16」已过期今天 06-17致 06-16 档被误当在飞拒归档、而真在飞的 06-17 档反没保护 → 须改。
6. **量化收益**:热目录顶层 dated 档 42→40归 2、2 巨档压桩、4 核心档术语对齐现行、总账消除 1 处现在时漂移 + 回填 06-17 一日工作、工具止 1 处过期。
@ -86,9 +86,9 @@
## 4. 措辞修订清单 — 轴②(B) 玩法模板术语漂移 = **16 处真改**(头号项)
**依据**HJ-DEMO-AUDIT-001创始人 06-17权威已入 MEMORY+_index——**废的是「游戏模板」**pre-built 整局游戏代码/填参线/旧 4 模板W-CLEAN 已清);**「玩法模板」**(品类/玩法框架·引导 AI 生成·非 pre-built 代码)**未废 = 当前最高优先级待建**。核心档却普遍写「玩法模板层废除」substance 对、术语错)。
**依据**HJ-DEMO-AUDIT-001创始人 06-17权威已入 MEMORY+_index——**废的是「游戏模板」**pre-built 整局游戏代码/填参线/旧 4 模板W-CLEAN 已清);**「玩法模板」**(品类/玩法框架·引导 AI 生成·非 pre-built 代码)**未废 = 有效待建但非最高优先级**(最高=Tier 0 生成可靠,玩法模板排其后)。核心档却普遍写「玩法模板层废除」substance 对、术语错)。
**统一修法**(外科 Edit不重排把「玩法模板层废除/已废」→「**游戏模板/填参式模板已废W-CLEAN旧4模板+存量已清)**」,并就近补「**『玩法模板』=品类框架·引导生成·未废·当前最高优先级待建**」。
**统一修法**(外科 Edit不重排把「玩法模板层废除/已废」→「**游戏模板/填参式模板已废W-CLEAN旧4模板+存量已清)**」,并就近补「**『玩法模板』=品类框架·引导生成·未废·有效待建但非最高优先级(最高=Tier 0 生成可靠)**」。
| 档 | 改处 | 定位(行) |
|---|---|---|

View File

@ -24,7 +24,7 @@
## 2. 模板哲学(★术语纠偏 · 载入误判防火墙)
- **宪法级定义**:模板 = **LittleJS 能力插件/二次开发件**——每插件=一项引擎能力(碰撞/粒子/物理/手感…),即插即用、可组合、版本化、只经公开 API 暴露、禁玩法假设;**不含玩法、不含美术成品、不含关卡、不含 UI——四者 = agent 造游戏时的生成域**。
- **★HJ-DEMO-AUDIT-0012026-06-17 创始人纠偏,本档现行口径)**:废的是「**游戏模板**」(填参式整局代码 / 旧 4 模板W-CLEAN 已清场删除);「**玩法模板**」(品类框架·引导 AI 生成·**非 pre-built 代码****未废 = 当前最高优先级待建**generic 桥接 commit `7534bdf9` 暂解 limbo。历史 spec 中「玩法模板永久废除」措辞为 06-12 旧记录,以本节为准。
- **★HJ-DEMO-AUDIT-0012026-06-17 创始人纠偏,本档现行口径)**:废的是「**游戏模板**」(填参式整局代码 / 旧 4 模板W-CLEAN 已清场删除);「**玩法模板**」(品类框架·引导 AI 生成·**非 pre-built 代码****未废 = 有效功能·待建,但非最高优先级**(最高=Tier 0 生成可靠,玩法模板排其后,创始人 2026-06-17generic 桥接 commit `7534bdf9` 暂解 limbo。历史 spec 中「玩法模板永久废除」措辞为 06-12 旧记录,以本节为准。
- **可测性红线(硬门)**agent 生成的游戏**必须导出取证清单**(可交互几何/锚点接线/胜败可达断言)——不可机测的游戏不许过评估门(把 spike 取证范式固化为生成约束)。**好玩基线 v2 五要素**(手感/美术统一/音乐/结构深度/角色壳)从模板层迁出、**挂评估门**判结果值。
- 能力插件库 v1 逐件清单P1-P10 字节预算)见 `add-game-template.md`
- 来源W-T1b-Runner 与双层模板 review §0+模板哲学段+§2/§4 + MEMORY tiered-engine。

View File

@ -52,7 +52,7 @@
**术语纠正(中心活结论)**
- **废的是「游戏模板」**=pre-built 整游戏代码/填参即得整局(旧 4 模板 clicker/merge/idle/tycoonW-CLEAN 已清,`template/list` 返空=设计态)→ 现行 agent 写码于 LittleJS 插件库取代。
- **「玩法模板」未废**=经营/剧情/解谜/TRPG/非遗 这类**品类/玩法框架**(选型后引导 AI 生成、非 pre-built 代码)→ 是**有效产品功能**,且是**当前最高开发优先级·待建**
- **「玩法模板」未废**=经营/剧情/解谜/TRPG/非遗 这类**品类/玩法框架**(选型后引导 AI 生成、非 pre-built 代码)→ 是**有效产品功能·待建**,但**非最高优先级**(最高=Tier 0 生成可靠,玩法模板排其后,创始人 2026-06-17见完成度与优先级总账
- **过渡 limbo 已解**旧审计中心病灶「P0 创作流不可完成」(建草稿硬要 templateId、删模板后空屏「玩法模板体系升级中」已由 generic 桥接 `7534bdf9` 解(缺省 templateId 归一 generic创作流先通玩法模板将在其上增强
**仍成立的轴**demo=愿景原型(`huijing-ai-demo.html` 3713 行营销原型卖相超前真实建设·结构骨架≈70%·真实可验收 P0 个位数);真 e2e 只有「创作→生成→预览→发布→审核→feed→试玩→互动→数据回路」主链 + b2b/profile9 视图中真正端到端可验收=feed/发布弹窗/b2b/profile 4 个,工作坊与创作者中心半真,素材中心/玩法模板中心/广场/六资产工作坊均未建或纯桩)。

View File

@ -13,7 +13,7 @@
> 1. **生成主线已转向「模板驱动 via new-api 网关」→ 再演进为「agent 写码于插件库」**C2 裁定 2026-06-09 spike 52/52 结构层 100%HJ-GEN-001 终审 2026-06-12 游戏模板/填参线退役LLM 经 **new-api 网关**直连便宜模型直出可玩游戏,经 harness 九门兜底;**Dify / OpenGame 均从未部署、降级为远期增强**,非现行生成引擎。后端实测 14 文件接 new-api`game-module-aigc-server`)。
> 2. **agentic 编排基建 = SAA(Spring AI Alibaba GA v1.1.2.2)裸 `StateGraph` 编排**HJ-AGI-0022026-06-15short-term SAA-onlyAgentScope 降 long-term premium 独立轨;后端实测 `spring-ai-alibaba` 已接入(`SaaStudioGraph` 等)。旧「自研编排/DAG 工作流引擎/Dify 可视化编排」表述全部作废。
> 3. **Tier1 引擎 = LittleJS 增强发行版55KB gz+ Runner v2 装载契约 `game-host.d.ts`**2026-06-12 终裁spike 85/82本档「自研 Canvas Runtime <15KB相关描述全部被取代——**15KB 红线废除** srcdoc 内联架构的衍生约束前提已失效改三层约束框架SLO@千元机+4G P75 / 预算入场券 gz350KB·raw1.5MB / 工程增强层沙箱/SDK/三容器控制点不变
> 4. **模板 = LittleJS 能力插件/二次开发件;游戏模板/填参式模板已废除W-CLEAN旧4模板+存量已清)**:玩法/美术/关卡/UI = agent 生成域;旧 4 模板 + 存量数据已清除。Tier2/3 复杂 2D/3D/原生仍用 Cocos Creator 3.8.8 + MCP不变。**注:「玩法模板」(品类/玩法框架·引导 AI 生成·非 pre-built 代码)未废 = 当前最高优先级待建HJ-DEMO-AUDIT-001创始人 2026-06-17 纠正)。**
> 4. **模板 = LittleJS 能力插件/二次开发件;游戏模板/填参式模板已废除W-CLEAN旧4模板+存量已清)**:玩法/美术/关卡/UI = agent 生成域;旧 4 模板 + 存量数据已清除。Tier2/3 复杂 2D/3D/原生仍用 Cocos Creator 3.8.8 + MCP不变。**注:「玩法模板」(品类/玩法框架·引导 AI 生成·非 pre-built 代码)未废 = 有效功能·待建,但非最高优先级(最高=Tier 0 生成可靠玩法模板排其后HJ-DEMO-AUDIT-001 创始人 2026-06-17见完成度与优先级总账)。**
> 5. **AI 素材/音乐工具链 = mmx-cliMiniMax2026-06-12 创始人亲验拍板默认)**agent 造游戏直接 CLI 调用、免 GPU/免训练;**ComfyUI 退备选**Stability Audio 等亦降级。
> 6. **代码命名空间整体改名为 `com.wanxiang.huijing`**(公司 Wanxiang / 项目 Huijing2026-06-15 合 dev/2.0.0);对外品牌 = **绘境AI**
> 7. **执行排期以 `mvp-execution-spec` + `docs/mvp/MVP作战清单.md` 为准**§9 甘特仅作蓝图参考2026-06-08 业务决策已将 MVP 验收改为「staging/内网种子灰度走通真闭环」,公网上线 = MVP 后并行长周期任务(受日历闸门约束)。
@ -1084,7 +1084,7 @@ Cocos Creator 3.8.8 + MCP → 官方一键导出小游戏包
微信=引擎官方格式;抖音=自有导出接口;快手=经"微信格式兼容转换"快手开发者工具无专用接口Tier1LittleJS渠道 adapter 走 W-CH-α 竞标
```
> **模板哲学2026-06-12 W-CLEAN****游戏模板/填参式模板已废除W-CLEAN旧4模板+存量已清)**——模板 = LittleJS 能力插件/二次开发件,玩法/美术/关卡/UI 全是 agent 生成域;旧 4 模板clicker/dodge/runner/match+ 存量数据已清除。好玩基线 v2 改挂评估门。**注:「玩法模板」(品类/玩法框架·引导 AI 生成·非 pre-built 代码)未废 = 当前最高优先级待建HJ-DEMO-AUDIT-001创始人 2026-06-17 纠正)。**
> **模板哲学2026-06-12 W-CLEAN****游戏模板/填参式模板已废除W-CLEAN旧4模板+存量已清)**——模板 = LittleJS 能力插件/二次开发件,玩法/美术/关卡/UI 全是 agent 生成域;旧 4 模板clicker/dodge/runner/match+ 存量数据已清除。好玩基线 v2 改挂评估门。**注:「玩法模板」(品类/玩法框架·引导 AI 生成·非 pre-built 代码)未废 = 有效功能·待建,但非最高优先级(最高=Tier 0 生成可靠玩法模板排其后HJ-DEMO-AUDIT-001 创始人 2026-06-17见完成度与优先级总账)。**
为什么分层:
- Web 预览和游戏流需要**极快加载**P75 < 3sTier1 LittleJS 增强发行版 + Runner v2 满足MVP 仅交付此层
@ -1544,7 +1544,7 @@ gantt
| **生成主线 = 模板驱动 via new-api 网关 → agent 写码于插件库MVP 现行)** | C2 裁定:`docs/agent-specs/2026-06-09-generation-spike/spike-summary.md`HJ-GEN-001 + `.agents/skills/cheap-model-game-generation.md` |
| **agentic 编排基建 = SAA(Spring AI Alibaba GA v1.1.2.2)裸 `StateGraph` 编排HJ-AGI-002现行AgentScope 降 long-term premium** | `docs/agent-specs/2026-06-15-SAA-*` + `.agents/skills/saa-graph-orchestration.md` + `.agents/knowledge/tech-decisions.md` §1/§4 |
| **Tier1 引擎 = LittleJS 增强发行版55KB gz+ Runner v2 装载契约 `game-host.d.ts`2026-06-12 终裁,自研 Canvas<15KB 已废除、15KB 红线废除)** | `docs/agent-specs/_archive/2026-06-11-T1引擎终裁包.md` + `.agents/knowledge/tech-decisions.md` §1.1 |
| **模板 = LittleJS 能力插件;游戏模板/填参式模板已废除W-CLEAN玩法/美术/关卡/UI=agent 生成域;「玩法模板」(品类/玩法框架·引导 AI 生成·非 pre-built 代码)未废=当前最高优先级待建HJ-DEMO-AUDIT-001创始人 2026-06-17 纠正** | HJ-GEN-001 + `.agents/knowledge/tech-decisions.md` §1.1 |
| **模板 = LittleJS 能力插件;游戏模板/填参式模板已废除W-CLEAN玩法/美术/关卡/UI=agent 生成域;「玩法模板」(品类/玩法框架·引导 AI 生成·非 pre-built 代码)未废=有效功能·待建,但非最高优先级(最高=Tier 0 生成可靠玩法模板排其后HJ-DEMO-AUDIT-001 创始人 2026-06-17见完成度与优先级总账** | HJ-GEN-001 + `.agents/knowledge/tech-decisions.md` §1.1 |
| **AI 素材/音乐工具链 = mmx-cliMiniMax2026-06-12 创始人亲验拍板默认ComfyUI 退备选** | `.agents/knowledge/tech-decisions.md` §1AI 素材工具链行)|
| **代码命名空间 = com.wanxiang.huijing公司 Wanxiang/项目 Huijing2026-06-15 合 dev/2.0.0);对外品牌 = 绘境AI** | `docs/memorys` brand-rename + `.agents/knowledge/product-and-architecture.md` |
| **RocketMQ / Nacos = future-stateyudao 框架自带依赖+yaml 配置存在MVP 未部署 broker/registry** | 本文 §3.1/§3.3/§5.2/§7.2`.agents/knowledge/tech-decisions.md` |