zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
673 Commits 4 Branches 0 Tags
Commit Graph

673 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
lili
9fe50a4fee fix(amodel-gen): 治便宜档生成幻觉 + 补 play-spec 链路(九门基线剩两层根因) 
便宜档九门基线诊断后,治创始人选的剩两层:
- 层1 生成幻觉:M3 对插件参数形状/返回值幻觉(drawButton 返 void 误赋值、
  sceneFsm.define 单对象批量),check 门只查方法名存在 → 带病过 check+build+smoke。修:
  · prompt.mjs + littlejs-game-dev.md 补两条 footgun 正反例(drawButton 返 void、
    命中用 pointInRect;define 逐场景调)
  · tools.mjs check 加形状静态门(拦 drawButton 返回值赋值 + define 单对象批量)
- 层2 链路假绿:stage 不产 play-spec → 裸跑 driven=false → E/H 降 advisory → 假绿。修:
  · tools.mjs ensurePlaySpec 据 _forensicsView 形态自动推 driver(有 targets→tap-targets/否则 key-cycle)
  · play.mjs smokeBoot 抓 _forensicsView().state();gen.mjs done 门 smoke 绿后调用

验证(vf-* 干净重跑):
- check 形状门对 base1/4/5 好游戏零误伤、对 base2/3 幻觉精准命中
- vf-mole 打地鼠(base2 同类):卡menu/E·G·H挂 → 九门全过、进 play(drawButton 幻觉治好)
- vf-2048 合成(base3 同类):define 已写对(幻觉治好);仍卡 menu = 新发现 key-cycle driver
  缺起局点击(menu 用 tap、play 用 key)= 第三层 driver bug、非本两层,下一步小修
- 两款 playspec 自动产、driven=true(假绿终结)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 23:15:42 -07:00
lili
8b491d1330 fix(九门): latch 终态口径修法 — 命名同义 + 限时类有进展降 advisory 
便宜档当前 HEAD 九门真实基线诊断(n=5 收敛环):harness 健康、3/5 真可玩;
0/5 主因 = latch 终态词表 bug(只认 gameover、漏 over/win/lose)+ 限时类
driver 玩不到终局。按创始人 2026-06-25 口径修 play.cdp.cjs:
- latch 认 gameover/over/win/lose 同义(对齐 driver 家族 runTapTargets)
- 未达终态但有真进展的限时/无快速失败态类 → latch 降 advisory(不致命),
  无进展仍致命(不放水)
- 验证:base1-5 重跑 0/5→3/5(base1/4/5 真可玩转绿,base2/3 卡 menu 无进展仍正确挂)

SoT① §5.4 同步 latch 口径演进(文档↔代码兑现)。
附:docs/内网凭据与端点.md 登记 glm-5.2(opus 高级档/512K,作复杂档证路高级档)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 22:26:37 -07:00
lili
f3d4bc1f24 docs(gen+master-plan): ①③ §0 门面图落地 + §6.8 收尾三修(F4/F7/CT1) 
- ① 生成引擎执行计划:补 §0 门面《生成引擎执行总览》SVG(6 工作单元依赖+状态)并 embed;F7 退役映射 06-18-001 行注明两 contract-first 待办随 gameDefinition 声明式路废弃而 moot
- ③ 上线主计划:补 §0 门面《上线主计划 16 周轴》SVG(16 周泳道甘特+日历闸门+55 P0 挂点)并 embed;F4 aigc「GameConfig 生成」加 A-model 写真 src/ 兑现、非声明式 JSON 消歧
- 003 tier2 子计划:CT1 注明子计划有效边界(Phase A U1–U7 有效 runbook / Phase B U8–U10 以 HANDOFF 为准)
- 两图均过 atlas 复验:XML 良构 / 不溢出 viewBox / 脚注全角「：」/ 无裸 &

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:01:15 -07:00
lili
0000ade12d docs(svg): 全域 SVG reframe doc-sync — 配图两线→三档 + 脚注死链 repoint 
- 结构重画:03-两条生成轨边界 / 07-全局两线与tier体系(两泳道→三档统一 AgentScope、引擎随复杂度选 LittleJS/Phaser)。
- 文字/framing(全域 SVG):两线→三档、SAA 廉价线→便宜档、AgentScope premium 独立轨→统一框架、超休闲档→轻量、tier2 远期/待 spike→accept(实线)。
- 脚注死链:自治富游戏引擎.md / agentic集成架构.md / tier2实现详设.md / tier2四层工程架构.md(均已并入 SoT)→ agentic运行时架构图说.md;全域 SVG 零死链。
- 07-泳道 tier2 框 紫虚线→实线现行(accept、核心已落)。
- MD doc-sync:删 4 处"待重绘 mini-desktop"注(图已重画)、①③ §0 / README / SoT 注脚去 mini-desktop(全归本机)。
- atlas house-style 复验:良构 / 界内 / 脚注全角「：」/ 无裸& 全绿;t2-E-04「两线分立(06-23)」已加注 06-25 reframe 取代之、作留痕。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 13:07:49 -07:00
lili
4f7eae5d7a fix(reframe收口): F1=(B) 便宜档 Python 重写三档同构 + 创始人 4 决策 + ①③ 转正式 
- F1=(B)(创始人 2026-06-25 拍板):①WU-A 从「JS 留、只换外层」改为「便宜档 Node amodel-gen
  整条用 Python 重写进 AgentScope agent、三档彻底同构」(Summary / Decision1 / WU-A 拓扑+迁移归属
  +迁移契约 / mermaid / R1 / 吸收映射 / 排期 全口径对齐;Node 旧路灰度兜底、≥80%+对照等价才切默认)。
- §8 双轴:生成引擎 README §8 加 L1/L2/L3(产品 / 创作者轴)↔ Tier0/1/2(技术 AI 深度轴)对应关系表
  (两套保留、不合并、非 1:1)。
- ③ 留存口径笔误:次留 ≥35% / 7留 ≥40% → 次留 ≥40% / 7留 ≥35%(符合 D7<D1)。
- ① canonical:true(reframe 后唯一执行 SoT、受 canonical-uniqueness 门保护)。
- ①③ status 草稿 → 正式(§6.8 双评审过 + 必修已修 + F1/§8/留存 等决策已落)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:31:32 -07:00
lili
4e801d5e8a docs(reframe收口): 生成引擎 reframe 全层 doc-sync + 统一执行 plan + 上线主计划 SoT + §6.8 双评审 
双查一致性(Codex+Opus)→ 修问题 → 出 plan 全链收口。

修问题(reframe 全活层 doc-sync · 框架统一 AgentScope / 三档按 AI 深度 / 去超休闲 /
A-model 写真 src/ / tier2 spike accept · n=5 收敛环 / 预算闸 <¥10·<¥50):
knowledge 三件套 + 顶层图说 00/01/02/05 + 6 域 README + 5 mvp 账本 + skill·workflow +
agent-specs(_index / 演进路线降留痕);系统性死链 自治富游戏引擎.md → 运行时 SoT repoint(7 档)。

AGENTS.md:§2 收敛上线主计划 SoT、§3.1 入口自审 reframe 对齐。

出 plan:① 生成引擎统一执行计划(新建 · 统一三档 · 吸收退役 06-18-001/06-19-001/003);
② 4 份重复 plan 退役/并入/去两线 banner;③ 可行性方案16周 就地升格为项目上线主计划 SoT(canonical)。

§6.8 双评审(Codex+Opus)6 必修已修:WU-A 真实拓扑+JS留+迁移契约 / A11 孤儿接缝(①WU-B↔③阶段三)
/ 三档拆清 / ③ 过度表述 / 人办清单 n≥30→n=5 / 死链。

tier2/HANDOFF.md:n≥30→n=5 + agentscope-runtime→2.0.2 Workspace doc-sync banner。

①③ status=草稿·双评审已过·待创始人确认 F1(WU-A 迁移归属)后转正式。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:14:25 -07:00
lili
f5429b1ada docs(生成引擎): §5.2 配置发布边界 — 重要配置走 yudao 审批=受治理发版(后期阶段) 
创始人 2026-06-25:质量/安全、关键 agent、关键玩法模板等重要配置变更走配置发布流程
审批,通过后发布——即使不重新部署服务代码,因影响生产稳定/质量,本质是受治理的「发版」。
复用 game-cloud 现成 yudao 能力(huijing-module-bpm 工作流 + huijing-module-infra 配置管理),
不自研(build-vs-buy 现货优先),后期阶段做。非关键配置仍即时/热更、零服务发版。
落 §5.2 管理面 + ADR-4 write 路细化 + §配置三类「不发版」口径澄清。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:53:29 -07:00
lili
e3a0c3c661 docs(生成引擎): SoT① reframe 新模型 — 框架收敛 AgentScope·三档按 AI 深度·两引擎实现 
把生成运行时 SoT 校准到 2026-06-25 创始人核心 reframe:游戏生成统一由
AgentScope 一套框架编排,按 AI 参与深度分三档(Tier0/1/2);引擎按表现复杂度
选(轻-中档 LittleJS、最富档 Phaser),引擎是实现、不是分档轴;SAA/dify 降为
最低优先级、留作后期"验证框架可插拔"的适配目标,不再是 co-primary 活线。

扫尾把残留旧框架口径(两条线/两线/两实例/富游戏线/SAA 作 co-primary)校准:
§四标题→生成实例(三档·两引擎)、L66 ASCII 图框架行、§二补②可移植性收益、
§5.2/5.5/5.6/5.7/5.8 各 facet"两条线→各档/两引擎"、SAA 能力面框架定位改远期
适配、trace 契约改多框架 adapter。引擎技术内容(engineBundle/Phaser src/工程/
九门 harness/CDP 探针)、gamedef 废弃史、主会话所写段落原样保留;SAA 裸图技术
描述保留,只改其框架定位。

验证:框架线标签词散文清零(仅余 svg 文件名);品牌门 造梦AI=0;死链门=0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:36:36 -07:00
lili
b31cc37a4f chore(brand): 造梦AI→绘境AI 全活层品牌不变量收口(441 文件) 
把活层退役旧品牌「造梦AI」统一改为现行「绘境AI」,brand-invariant 门红线归零。构成:
~412 Java @author 署名 + game-studio/index.html 浏览器标题 + game-runtime/package.json 描述
+ game-admin/.env VITE_APP_TITLE 运营后台标题 + contracts API title/@Schema 用户协议示例/events 描述
+ docs-design mockup 品牌位 + 各模块注释。全是注释/显示/元数据,零逻辑改动。
zaomeng 拼音持久化标识符按 2026-06-24 评审 GR-05 不动(347 处保留)。
白名单(docs/ip 法律备案 / _archive / 带日期留痕)与 AGENTS.md 门定义自身不动。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:29:11 -07:00
lili
ce7a4850eb docs(gen-engine): 删 18 个已退役 stub + 全部引用直接重指 SoT 
2026-06-20 域化重构留的 18 个「已退役」tombstone(每个~400B 一句重定向)
现已删除:其设计内容早已收敛进 canonical SoT agentic运行时架构图说.md
(17 份)/ README.md(生成引擎图说 1 份)。把全仓 40 条指向这些 stub 的
markdown 链接直接重指到目标、不再绕 tombstone,按各引用文件位置算正确
相对路径。架构 README 索引把 6 个 stub 行合并为单一 SoT 行。

留痕档(brainstorms/agent-specs)只改链接目标、不动叙述。
保留:SoT 本身、tier2细节图说-G-spike-runbook(25KB 真内容)、
其余 canonical 档(README/验收门/prompt治理/数据飞轮/OpenGame对照/WG1基准)。

验证:check-deadlinks.sh = 0 死链;品牌门活层零退役名残留。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:04:07 -07:00
lili
a2a8266416 docs(生成引擎): SoT① 36 张 SVG 改渲染嵌入 ![](…)(原反引号路径不渲染) 
§四/§五 各 facet 末尾的 SVG 引用原写成 `assets/x.svg` 反引号路径(只显示路径、不渲染);
按 md 图片嵌入式 ![图 X·描述](assets/x.svg) 逐张转,每图独立成块。36 张全部对应 assets/
真实文件。图本身仍是 spike 前视角(§5 开头 caveat 已注明,svg 重绘待出图管线)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:02:39 -07:00
lili
374e30805d docs(rules): build-vs-buy 补生命周期/归档硬查 + 仓内 .agents/knowledge grep 前置 
R1「维护健康度」加生命周期状态硬查(归档/deprecated/停更/已并入上游;归档项不得作首选);
R4① 仓内 prior-art 扩到 .agents/knowledge 蒸馏事实 + 候选生命周期核查。教材案例 2:
agentscope-runtime 归档项被荐为首选、漏仓内已记结论,双失。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 03:25:19 -07:00
lili
d4eb4b1197 docs(生成引擎): SoT① 收口定稿 — §二补二 成熟度五列 + §二补三 6 条 build-vs-buy ADR + §三 定级冻结 
§6.8「采纳但修」收口:补标准成熟度五列(操作化 §二补①)+ 6 条 build-vs-buy ADR 决策矩阵
(每条 ≥3 具名候选 + 排除理由)。纠 ADR-5/6:agentscope-runtime 独立仓已归档、能力并入
agentscope 2.0.2(Workspace/app/event),改判走 2.0.2 内置件——沙箱=2.0.2 Workspace(工具
沙箱非 CDP)+ tier2 自家 CDP harness;扩容=2.0.2 Agent Service,跨机 durable-exec future-state。
L247 同步。(c)选型 spike /(e)n=5 收敛环留作执行 plan、不在文档完成范围。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 03:25:19 -07:00
lili
42eafd876a fix(studio): StudioModifyTarget 示例与 studio.yaml 契约镜像对齐(去 gamedef) 
Step6 改了 contracts/api-schemas/studio.yaml 的 path 字段示例(去失效的
/gameDefinition/scenes/2),其 Java VO 镜像 StudioModifyTarget L25 @Schema
示例漏同步。补齐:/gameDefinition/scenes/2 → /files/src/game.js,保契约
yaml↔VO 一致(端点/字段结构不动,仅示例措辞)。

验证:mvn -pl studio-server -am compile = BUILD SUCCESS。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:31:02 -07:00
lili
0fa1cda1b7 feat(studio): inject.ts 去 gamedef 化石注释 + CSP 收紧(撤 unsafe-eval) 
产物沙箱 inject.ts 外科改(两条加载路径主体不碰):
- 删 L69-71 三行 gamedef 专属注释化石(声明式 gameDefinition behaviors/rules
  + gd-runtime new Function 编译执行的理由)
- CSP script-src 由 'unsafe-inline' 'unsafe-eval' 收紧为 'unsafe-inline':
  两条活路径(A-model esbuild iife bundle / SDK Runtime 内联)皆静态打包、
  不含 eval/new Function,'unsafe-eval' 纯属已删 gamedef gd-runtime 遗留需求,
  撤之缩小 XSS 攻击面、不影响活路径

验证:cd game-studio && npm run build = 绿(vue-tsc 类型检查 + vite build
全过,✓ built;CSP/注释改动不引入类型错,无 spec 预警的 vue-i18n 红)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:28:56 -07:00
lili
5661e2015f feat(contracts): source-project schema 挖 gamedef V1 子树(保留文件·收敛单 V2) 
contracts/agent-loop/source-project.schema.json(A-model keystone 契约,
不可整删):
- 删 $defs/sourceProjectV1(schemaVersion "1.0"、含 gameDefinition 声明式表示)
- 删仅 V1 用的 $defs:entity / component / behavior / scene / rule
- oneOf 由 [V1,V2] 收敛为单 [V2];顶层 + profile/assetSpec description
  去 "1.0 gamedef legacy" / "1.0/2.0 共用" 措辞
- 保留:整个 sourceProjectV2(A-model 多文件代码工件)+ 共用 profile/assetSpec

contracts/api-schemas/studio.yaml:StudioModifyTarget 的 path 字段示例
里 /gameDefinition/scenes/2 → /files/src/game.js(端点/字段结构保留,仅
更新失效示例措辞)。

验证:
- source-project.schema.json 仍合法 JSON(python3 -m json.tool 过),无悬空
  $ref(删的 5 个 def 无别处引用)、无 V1/gameDefinition 残留
- studio.yaml 仍合法 YAML
- 经查无任何测试/运行期校验器加载本 JSON schema 做校验(存储层把
  source_json 当不透明 blob),删 V1 纯文档级、不影响运行期/测试

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:27:28 -07:00
lili
94abac1507 feat(aigc): 外科挖 SAA graph 内 gamedef 分支(删分支·保节点/边) 
按 spec 铁律「删 sourceMode==gamedef 分支、绝不删节点/边」,外科切除
SAA 编排里已废 gamedef(声明式 JSON + new Function)路线;factory/amodel
两路与图节点/边/装配全程保留。

main(4 文件):
- SaaPrompts:删 GAMEDEF_SYSTEM 常量、buildGameDefMessages;historySystem/
  historyFirstUser/historyRepairUser 去 boolean gamedef 参数(恒走 iife/factory)。
- SaaGenNodes:删 validateGameDef(唯一调已删 build-from-source.mjs 处)+
  validateNode 的 gamedef 分支;连带删孤儿 helper deleteQuiet。
- SaaStudioNodes:删 K_MSG_HISTORY_GAMEDEF(定义+ALL_KEYS);historyKey/
  readHistory/appendHistory 退化去 gamedef 参数(恒 factory 键);generateNode
  闭包切 gamedef 分支(组 messages/抽产物/历史 append 全退化为 factory);
  modifyNode deterministic 点改恒 fail-loud、modifyRouter deterministic 恒 fail
  (gamedef 是唯一支持确定性点改的形态,删后该路对 factory/amodel 恒 fail);
  清未用 archetype 变量。SaaStudioGraph.assemble 节点/边零改。
- AigcExecutorProperties:saaSourceMode javadoc 删 gamedef 描述(字段保留,
  factory/amodel 仍用)+ 删失效 cutover 门。

test(5 文件):
- SaaHistoryFidelityTest:gamedef 形态→factory(历史保真机制与 sourceMode 无关,
  答案块改 ```js 工厂使 factory 抽产物自洽);
- SaaHistorySerdeTest:K_MSG_HISTORY_GAMEDEF→FACTORY;
- SaaAnthropicAssembleTest:gamedef 形态→amodel(P0-2 多形态回归);
- SaaStudioGraphTopologyTest:删 modify_deterministic_gamedef_unlocks_validate_route、
  改 fail_loud 断言关键词(failureReason 已去 gamedef);
- SaaFullGraphE2eTest:javadoc/注释 gamedef 量测示例→amodel。

DifyCallbackServiceImplTest 的 SOURCE_JSON(含 gameDefinition:{} blob)保留——
源工件 blob 透传测试,不解析内容(spec 铁律:存储层把 source_json 当不透明 blob)。

验证(本机 mvn 真跑·全绿):
- aigc-server Saa*Test + DifyCallback*Test = BUILD SUCCESS, 139 run / 0 fail / 7 skip(skip=系统属性门控的真 LLM/harness e2e)
- studio-server StudioServiceImplTest 27/0 + SourceProjectServiceImplTest 17/0 = BUILD SUCCESS

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:24:08 -07:00
lili
d55030bf4a feat(runtime): 删 gamedef 运行时核心(gd-runtime/build-from-source/2d-api) 
gamedef 声明式 JSON + new Function 解释路线的 game-runtime 核心,随
gamedef 判废一并清除:
- 4 测试:src/host/{gd-runtime.test,gd-archetypes.test,build-from-source.test,gameplay-pitfalls.test}.mjs
- 4 被引文件:src/host/{gd-runtime.js,build-from-source.mjs,runtime-api-2d.d.ts,runtime-api-2d.md}

这 8 文件互相引用闭环、仅被彼此与那 4 个 gamedef 测试引用;A-model 全线
(src/core / src/plugins / host / _template / _generic)不依赖它们。
src/core/game-host.d.ts L25 一句史化石注释提及 gd-runtime(非 import),
属"绝不动"的 A-model 核心,保留,列入残留报告。

验证(必跑·删后绿基线):
- 核心 node --test src/core+src/plugins = 211 pass / 0 fail
- games/_generic 壳 = 5 pass / 0 fail(确认未误伤 _generic 标准插件壳)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:04:46 -07:00
lili
d0626e1f1c feat(aigc): 删 gamedef skeleton 注入(三仓一物·成套清) 
Plan A·Phase 2 的 Template-First gamedef 骨架注入整套删除:
- contracts/agent-loop/skeletons/{breakout,simon,tictactoe}.json(空目录随之消失)
- SaaSkeletons.java(纯 gamedef 专属:forArchetype 返 gamedef JSON 骨架)
- pom.xml(aigc-server)去 agent-loop/skeletons/*.json 的 classpath include
  (templates/*.schema.json 等其它 include 保留)
- SaaPrompts.java 删 appendSkeletonIfAny 定义 + 两处调用(buildGameDefMessages
  firstAttempt 分支翻转为 !firstAttempt 消空块;historyFirstUser gamedef
  分支去骨架追加)

skeleton 是 gamedef 中间表示的"已过门结构参照",随 gamedef 路线废弃一并清。
验证:mvn -pl aigc-server -am compile = BUILD SUCCESS(Java 改动可编译)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:04:02 -07:00
lili
f6ebcb6b63 test(清扫): 删 gamedef 测试产物(13 个 gd-* + 3 brief) 
- game-runtime/games/_wg1-gen/ 下 13 个 gamedef gd-* 测试产物
  (gd-angrybirds/breakout/doodle/flappy/invaders/multiball/pong/
  runner/saolei/simon/tetris/tictactoe/whack,均含 source.json,
  untracked,物理删除);_wg1-gen 本体 + .agent + _goldenpath-probe
  完好(192→179 子目录)。
- game-cloud aigc-server 测试资源 3 个 gamedef brief:
  saa-e2e-briefs-{gamedef,diverse10,holdout}.txt(git rm)。
  仅 SaaFullGraphE2eTest javadoc 示例引用(L71/L79),其读 brief
  走 -Dsaa.e2e.briefFile 动态路径无硬引用、且整测 @EnabledIfSystemProperty
  门控不入常规 mvn test;javadoc 死引用并入 Step5 Java 编辑清理。

验证:game-runtime 核心测试 211/211、_generic 5/5,删除无误伤。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 02:00:16 -07:00
lili
071f44713d docs: 删 4 份纯 gamedef 死设计文档 + 修引发的活层死链 
删除(gamedef=已废错误路线,2026-06-21 创始人判废):
- docs/brainstorms/2026-06-18-生成失败根因分析-requirements.md
- docs/brainstorms/2026-06-19-plan003-phase1验收闭环-requirements.md
- docs/plans/2026-06-19-002-feat-gendone-用对M3生成生死门-plan.md
- docs/plans/2026-06-18-003-feat-gen-quality-converge-and-m0-integration-plan.md

修死链:.agents/skills/saa-graph-orchestration.md 去掉指向被删
根因分析文档的失效指针(保留根因结论本身,SAA 编排史有效经验)。

边界档 docs/plans/2026-06-19-001(status=active、主体即 gd-runtime)
仍引用被删档(origin + 来源段),按 spec 划为"留待人判·别动",
其遗留死链列入收尾报告上报,不在本次授权内处理。

docs/agent-specs/_index.md 经查无指向这 4 份的链接。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:59:01 -07:00
lili
9cc8ab83c1 docs(总账): M2 行补 gamedef 判废终局历史(清扫前置) 
延续 M2 行既有行文,在 gamedef 中间表示段落末尾补史:gamedef 于
2026-06-20 对抗裁决揭穿表达力天花板、2026-06-21 创始人判为错误路线
并删除(设计+代码全清),廉价线现行已切 A-model(LLM 在 LittleJS
增强发行版写真 src/ 多文件+调插件)。为后续删 gamedef 设计文档/代码
提供历史锚点。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:57:19 -07:00
lili
a0a46ae32d docs(架构): gamedef reframe pass-2 — broader/沙箱档 + 残留 mentions 
续上轮(banner+README),把 broader/沙箱档里 gamedef-当现行/迁移中清成「已废错误路线、
A-model 现行」(opus 代理 + 我补漏):
- 00-系统总览:左轨现行 gameDefinition→A-model 写真 src/,无迁移/cutover
- 03/架构产物沙箱:scanLogic(behavior.code/rule.condition 扫描)、new Function/unsafe-eval
  标为已废 gamedef 路 build 段机制,A-model 真 src/ 经 esbuild 无 new Function;
  **沙箱层(iframe/CSP/桥/九门)对两路通用、保留**;装载路 L146 改 A-model 现行
- OpenGame对照:L325「当前实现 gamedef」→已废、L318 smart_edit 注 A-model 文本补丁回归
- 验收门:九门收窄 91.7% 标为 gamedef 路历史实测 + 该验收策略引擎无关对 A-model 适用
- 数据飞轮:去「待 gamedef→src 迁移协调」(无迁移,gamedef 已废)
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:16:26 -07:00
lili
95d34c03f5 docs(生成引擎): gamedef=废弃错误路线 reframe — 8 banner + README §3-6(opus 代理) 
创始人:gamedef 已删除/失效/错误路线。opus 代理 reframe(我核验 banner+README §3-6):
- 8 个 🚧 banner:「gameDefinition→src 终态迁移(plan 2026-06-18-001)」→「gameDefinition
  已废(错误路线),现行=A-model 写真 src/;tier2 建设中」
- README(生成引擎):§3.2 终态硬约束改「gameDefinition 是已废错误路线」+ A-model 取代;
  §4 第三类「factory/gamedef 双轨债」标随 gamedef 废弃消解;§6 cutover 里程碑门标作废
  (✗ cutover 已废 → A-model 单线无双轨可切);线A/线B 能力工作对 A-model 路保留
- OpenGame/WG1/验收门/架构README banner 同改
门:全仓死链 0。(broader/沙箱档残留下一 pass)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:10:48 -07:00
lili
452d13d247 docs(生成引擎): SoT① §4.1 — gamedef=已废错误路线,廉价线现行=A-model 写真 src/ 
创始人:gamedef 已删除、失效、是错误路线。SoT① 实例一(廉价线)reframe:
- 范式:便宜模型直接写真 src/(A-model,2026-06-21 起)+ L2 插件 + 九门,取代已废 gamedef JSON
- 护城河 = 九门 harness(引擎无关、判能不能玩不判怎么写,切到 A-model 一行没动)
- 废弃路线 = gameDefinition(声明式数据壳+自由JS核+色块天花板;2026-06-20 裁决揭穿、
  2026-06-21 判废)——不再「坚持它做 Tier0」,整条路被 A-model 取代
- §5.6 左支装载:「声明式结构化源」改「LittleJS engineBundle 装载(A-model 真 src/ 构建)」
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:59:55 -07:00
lili
770d1ba458 docs(tier2): 验证方式 n≥30 统计批跑 → n=5 收敛环(创始人指令,全档贯通) 
创始人:「n>30 这个设计不希望再看到了。n=5,有错误再追加一次 5」。续 SoT① 后把 tier2
验证语境的 n≥30 统计批跑全改成 n=5 收敛环(并发跑 5、有错读日志/分析/修复、再并发追加
一次 5、收敛即 go、不收敛按收敛失败模式走退路 R1/R2/R3/KEEP):
- 003 plan:Summary/执行现状/KTD B门/mermaid/R11/U7/Open Questions 全 reframe;
  退路树由「过门率<40%/<20% 统计阈值」改「收敛失败模式分流」(opus 代理执行、已核验)
- 01-产品图说:6 处「n≥30 统计待跑」→「收敛环 n=5」;§188 内外口径同改(不写已可对外背书)
- spike-runbook:status/§0 banner/G3 样本量(5×6=30→n=5)/G4/G5 退路树/跑序 全 reframe;
  svg(n≥30/5×6/过门率阈值)经 banner 标为旧法历史、以 003·SoT① 为准
- origin brainstorm:加 supersede banner(留痕保留、标 B门 n≥30 已被 n=5 取代)
范围:只改 tier2;廉价线 SAA gamedef「≥80% n≥30」基线未碰(测成功率本身需统计样本,待创始人定)。
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:43:40 -07:00
lili
1cd3f01983 docs(生成引擎): SoT① 验证方式 n≥30→n=5 收敛环(创始人指令) 
创始人:「n>30 这个设计不希望再看到了。n=5,有错误再追加一次 5」。
SoT① 6 处 n≥30 统计批跑口径改成收敛环:并发跑 5、有错(>1)读日志/分析/修复、再并发
追加一次 5、收敛即 go,不做 n≥30 统计批跑(frontmatter/§4.2/§5 intro/§5.3/§二补⑥e)。
§4.2 原 n≥30 与 n=5 收敛环并存的自相矛盾一并消除。批跑底座件保留(设 n=5)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:34:43 -07:00
lili
441304726b docs(生成引擎): 收尾过时口径 — SoT① svg-caveat + 退役 76KB design(影子 SoT) 
- SoT① §5 引用处加 svg-caveat:25 张 tier2 svg 是 0号 spike 前视角(虚线/「整图状态=建·
  待 spike」是当时标记),现状以各面散文「现/建」为准、不以图虚线为准(svg 重绘待出图管线)
  ——一句覆盖全部,不逐张改(避免 caption 说已落、图画虚线的自相矛盾)
- 退役 76KB design(2026-06-23-接口协议层与可插拔模块-design.md):内容已并入 SoT① §三
  (adapter A1–A13+B类)+§二补(§7 14问题)+003 附段,是同命题影子 SoT,零入链、干净退役;
  完成原整理 plan 漏做的一步(保持同命题唯一设计文档)。其 line 40/42 tier2「待 spike」口径随退役清零。

门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:24:22 -07:00
lili
e4cd505086 docs(架构): broader 档 tier2 状态 doc-sync — 清「待 spike/未落代码」(13模块/系统总览/产品图说/前端) 
4 份架构档把 tier2 写成「待 0 号 spike、未落代码、远期·待建」,已过时。按 tier2/HANDOFF.md
+ SoT① 统一改成现状真相(核心已落 + 0号 spike feie-005 accept,n=1 机制验证、n≥30 统计待跑;
阶段1 Agent Team/控制面/feed 第二装载留 Phase B),未过度纠成「已完成」:
- 13模块:生成轨现状段 + 修 自治富游戏引擎/agentic集成架构 两 tombstone 链→SoT①
- 00-系统总览:图3/图8 散文 5 处(svg 虚线为 spike 前视角不动,散文点明现状以 SoT 为准)
- 01-产品图说:6 处状态口径;§188 内外口径精确改「已过 spike n=1、n≥30 完成确认可对外
  背书后再同步」(非「已可对外背书」);MVP 55 P0/不单列 P-id/Cocos 决策全保留
- 前端README:tier2 承载前提 + 修 引擎与运行时/tier2实现详设 tombstone 链;L229 SLO 链→
  SoT①(装载)+验收门(首局≤2s)

opus 代理执行、逐处核验(无过度纠偏/§188/MVP P0/死链 0/品牌净)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:20:11 -07:00
lili
a026153b4a docs(生成引擎): spike-runbook doc-sync — 0号 spike 已跑 accept,清「待 spike/整体待建」 
tier2细节图说-G:status 与 §0 的「0号 spike 还没跑/代码一行没落/整体待建」是 spike 前口径,
已过时。加 2026-06-24 更新 caveat:feie-005=accept(go),核心生成线/探针/九门+富游戏三门/
观测成本/n≥30 底座/服务化@8200 多数已落(见 SoT① §5、tier2/HANDOFF.md),本 runbook 现作
n≥30 统计批跑执行指南;svg 虚线为 spike 前视角不动,以 SoT① 为现状真相。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:12:48 -07:00
lili
1b97c55ca0 docs(生成引擎): tier2 doc-sync — SoT① §4.2/§5.x 按 HANDOFF 回写真相(§6.8 #1 收口) 
§6.8 评审 #1 阻塞:SoT① 忠实搬运 spike 前源档、把已落 accept 的 tier2 写成「待 spike」。
按 tier2/HANDOFF.md(2026-06-24)+ 内网凭据 P4 回写真相:
- §4.2 headline:翻成「核心已落 + 0号 spike feie-005 accept(n=1 机制验证,n≥30 统计待跑)
  + 服务化@8200,判断=go(留观微调)」
- §5.1-5.8 八面「现/建」全部按 HANDOFF 翻新(已落:Phaser 探针+九门+富游戏三门、
  四道收敛契约机器门、mmx、M3 接法、Tier2TraceMiddleware/成本折¥、L3软检、n≥30底座;
  待:n≥30统计/阶段1 Agent Team/控制面后端/feed第二装载)
- 纠 2 处设计叙述错(spike 实测推翻):① 官方 ReplyBudgetControlMiddleware 2.0.2 不存在
  →自建 on_system_prompt+硬熔断;② 纯内部多轮 ReAct 过早放弃→有界外层 resume(wg1范式回归)
- frontmatter status + §二补⑥(a) 标 doc-sync 已做;003 加「执行现状」块、修「待 spike」全局口径

门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:06:38 -07:00
lili
e7d236197b docs(生成引擎): §6.8 双评审修正 — adopt-standards 提案「采纳但修」 
Codex(web 源验)+ Opus(repo 验真)双评审,总判一致采纳但修。文档内修发现项:
- SoT① §二:修 4 处平实错(「全收进 AAIF」归属纠正/可移植「白得」降为分层/
  K-槽非反模式/microVM→SandboxDriver,后两条消 §6.10 兑现门反例)+ 表格
  A2A cancel·MCP Tasks experimental·Langfuse read-write 三单元精修
- SoT① §二补:新增评审修正块(成熟度分层/可移植分层/扩容沙箱降 future-state+
  ≥3候选选型/慢门 job-poll/cancel contract/TraceLedger/自研域清单/收口 TODO)
- SoT① frontmatter:status 改 tier2 已落 accept(待 doc-sync)+ 双评审已过
- ② prompt治理 §5:热取分 read/write(运行时只拉已批准版本,write 走 GitOps)
- 003 附段:双评审结论(doc-sync 前置最高优先/5待决改 ADR/成熟度分层/沙箱扩容拆选型)

最高优先收口 TODO:tier2「待 spike」doc-sync 回写。门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 23:49:48 -07:00
lili
adfbf7d65f docs(生成引擎): SoT① Step7 — wave-close 门全过(修子树外 3 处改名死链) 
官方 check-deadlinks 抓出 验收门-W-G1→验收门 改名后子树外 3 处死链,修复:
agent-specs/_index、architecture/README、运维/观测体系。
门结果:全仓死链=0 · 品牌「造梦AI」零命中 · canonical 4 topic 各一份 ·
入口卫生(SoT 活档无个人绝对路径/硬编码端口)零命中。
整理 scaffold plan 自退役(内容已落 SoT①/003/memory)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:56:01 -07:00
lili
c633e1abe9 docs(生成引擎): SoT① Step5 — 执行 plan 收敛(adopt-standards 路线并入 003 + 删后续路线图) 
- 003 tier2 plan 收为 1 份「tier2/agentic 生成线执行 plan」:
  · 附段并入 adopt-standards 上层路线(后续路线图 §5 第0-5步 + §6 五 build-vs-buy 待决,
    标提案·待 §6.8 双评审)
  · §Sources 属主设计档链:原 tier2 四份/详设等 → 指向 SoT①;spike runbook → 图说-G
- 图说-G spike-runbook:frontmatter 改为「执行 runbook(非设计 SoT)·配套 003」,
  去掉指向已退役档的 hash 映射,标设计 SoT=SoT①,t2-G svg 在此 home
- 删 docs/mvp/后续路线图.md(未跟踪;设计入 SoT① §二/§三、路线入 003 附段)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:54:01 -07:00
lili
d97c828831 docs(生成引擎): SoT① Step6 — README 域索引归一(并入生成引擎图说 + SoT 导航) 
- README §9 源档导航:加 4 份设计 SoT 导航(生成运行时架构/prompt治理/验收门/数据飞轮);
  设计合理性裁决行 → 指向 SoT①(已并入)
- README §360:tier2 四份 + SAA/引擎/固定架构等 16 份 → 统一指向 SoT①(留 tombstone);
  并入「看图入口」(P0 四电梯图 07-10 + tier2 36 细图 + 子系统图索引)
- 退役 生成引擎图说.md(总入口并入 README,tombstone 指针)
- 全子树相对链接存在性校验:无硬断链

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:48:36 -07:00
lili
fe6a2b4d98 docs(生成引擎): SoT① Step3 — ②prompt治理改热取 + ③验收门收敛 + ④数据飞轮 canonical 
- ② prompt治理:加 canonical frontmatter;§5 新增"目标态:采 Langfuse 式运行时热取"
  (按 id@label 运行时拉取+缓存TTL+后台刷新+回落,替构建期 maven 快照反模式;
  四道闸治理纪律不变;对齐 SoT① A13)
- ③ 验收门:验收门-W-G1.md → 验收门.md(git mv);加 canonical frontmatter
  (topic=对外开闸放行);修 3 处改名断链(生成引擎图说/OpenGame对照/WG1基准)
- ④ 数据飞轮:加 canonical frontmatter(保留)
- SoT① §5.4 指针校准:验收门=开闸放行6门(坐九门之上),九门护城河命题即在 §5.4+A5
- canonical 唯一性:4 topic 各一份,预检通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:43:47 -07:00
lili
bcde9acee2 docs(生成引擎): SoT① Step4 — 退役 17 份被并文档(tombstone 指针)+ 图引用归位 
16 份图说/详设 + 设计合理性裁决,内容已并入 SoT①,替换为 tombstone 指针
(保留路径=保入链,各指向 SoT① 对应章节;原文存 git 历史):
- 并入①:agentic集成架构/自治富游戏引擎/tier2四层工程架构/tier2实现详设/
  tier2细节图说 A-F·H/SAA编排/SAA能力API-dossier/开闸接线/引擎与运行时/固定游戏架构
- 结论并入①后退役:设计合理性裁决
图引用归位:07全局两线→§四、09廉价线端到端→§4.1、08长生命周期→§5.6、
00-06 tier2总览→§4.2(消孤儿);修 typo gamefdef→gamedef。
SoT① 现引用 36 张 svg、全部存在、无 dead 链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:36:27 -07:00
lili
2aa2ffec2f docs(生成引擎): SoT① 补 开闸接线覆盖(§4.1 实例一创作入口开闸) 
一句话直接驱动 + templateId 可选缺省 generic + 玩法模板=品类框架,
补进实例一,使 16 份待并入文档全部被 SoT① 覆盖,可退役。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:33:24 -07:00
lili
27584a1fdb docs(生成引擎): SoT① Step2 — 8 facet 并入(运行时形态/控制面/ReAct/校验九门/能力面/源项目/观测/四层) 
经 4 个非重叠抽取代理浓缩 ~2600 行源文档,亲笔写成散文并入:
- 5.1 运行时形态:Agent Service/session三路/Agent非常驻+AgentState/Workspace双轴/Middleware洋葱
- 5.2 控制面与配置热取:四组件/采Langfuse热取替构建期快照/热改vs GitOps/三层预算强制/管理面三phase
- 5.3 单写ReAct循环:一轮闭环/多轮进Agent内/四熔断+硬闸自建/M3原生接法/承A-model
- 5.4 三层校验与九门:L1/L2/L3+九门逐门+富游戏三门(联动/经济/latch)+advisory分级+自产driver三层隔离
- 5.5 能力面:九工具三类/引擎能力包五件套/prompt两阶段/A-model四插件复用/SAA能力
- 5.6 源项目契约与装载:七要素四组/独立schema不复用/第二装载分支/finish共用schema
- 5.7 观测与成本:统一trace契约(对称核心+扩展段)/采OTel GenAI/成本钉new-api quota
- 5.8 四层职责:职责视角叠真实结构/复用边界二维/六项该删改官方/三类配置

治理:零 file:line/hash/实现代码;九门逐门归本文运行时视角,验收门完整命题指向 ③。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:27:39 -07:00
lili
aad4d8c16c docs(生成引擎): SoT① 骨架 — agentic 运行时架构统一 SoT(采标准+adapter+两实例) 
收敛 16 份图说/详设/接口协议草案为单一 SoT 第一步:写框架。
- 命题:可插拔 agent 平台(adapter + 框架可换 + 两块自研护城河)
- 采标准对标:A1/A2→A2A、A2.5→OTel、A7→MCP、skill→SKILL.md、
  沙箱→microVM、扩容→durable-execution、A13→Langfuse 热取;
  自研只剩 checkpoint/续跑 + 确定性验收门
- adapter 协议层:A1–A13 固定协议目录(数据模型/接口,剥 file:line/hash)
  + B 类可插拔模块(引擎包/探针/框架适配器/渠道/资产/模板/合规原子)
- 两实例:SAA·LittleJS 廉价线(Tier0/1,含裁决结论)/ AgentScope·Phaser 富游戏(tier2)
- 八面 facet:Step 2 待并入区,各给 scope + 来源

治理:零实现代码/行号/hash 进文档;采标准方向为提案待 §6.8 双评审。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:07:42 -07:00
zizi
fdc9ecd50b fix(tier2): 控制面 SSE 等待防永久卡死(read 超时;008 实证) 
cp-smoke-008 实证:控制面在 attempt 0 卡死 60min。根因 = _wait_for_turn_end 的总/空闲超时检查写在
aiter_lines 的 line 循环【体内】,而 httpx read=None;当 SSE 流【完全静默】(008:服务端 3 次 redis
超时打断了事件发布 → 既无 data 也无心跳)时 aiter_lines 永久 await,没 line 进来 → 超时检查永不触发 →
控制面无限挂。修:read=idle_timeout_s(300s),静默超它即 ReadTimeout → except 兜住 → 据 on-disk 评门继续。
不误杀正常回合(agent 内部 run_gates chrome ~60s << 300s)。

注:008 的不收敛是【基建+本 bug】所致,非生成质量——收敛修复(driver)已由 007 现成游戏重跑独立坐实
(accept/九门+富游戏三门全绿)。008 另暴露:工作室设计团队 >240s 超时 degrade 回单 agent(仍产出
design_text);redis 偶发超时(mini-desktop→mini-infra 链路抖动)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 13:53:04 +00:00
zizi
3cd4769f6b docs(agents): 精简 AGENTS/指令体系 + 立功能设计文档规范，删退役 pipeline 
- 新增 feature-design-doc.md：功能设计文档作业手册（WHAT+HOW 合一·图文一式两份：文字+mermaid 给人/AI、svg/html 给人更重要；取代 review/execution 双档）
- 删退役 ai-generation-pipeline.md（Dify/OpenGame 蓝图）；现行红线（回调唯一写入路径/免鉴权身份注入/HMAC 验签）抢救进 security-and-reliability §1.3；8 处引用改指向 agentic-amodel/saa/§1.3/§5.2
- AGENTS.md 226→182：§5 四张资产表删→指针（根治与 README 双维护漂移，补回漏列项）；§3.1 生成线 banner 考古史瘦身；§3.3+§6 接入功能设计文档
- README 索引同步

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 13:46:03 +00:00
zizi
c1bf28f15b fix(tier2): C1 trace 加 workdir 存在守卫(免 scaffold 前刷 FileNotFoundError) 
008 实证:首轮 scaffold_init 之前会有早期 SSE 事件,此时工程 workdir 还没建 → trace 追加写刷
FileNotFoundError(best-effort 已吞、但刷屏)。加守卫:dirname 不存在即静默跳过(不抢先建目录、
免干扰 scaffold 的"已存在不覆盖"逻辑)。scaffold 后正常落 trace。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 12:57:14 +00:00
zizi
3156a2a9db fix(tier2): C1 trace 抓对工具名字段(tool_call_name/tool_call_id/state) 
008 真跑实证:C1 trace 工作(119 行/28 工具调用捕获),但 TOOL_CALL 事件没记到工具名——
_compact_sse_event 误取 tool_name/name/id,而 2.0.2 真实字段是 tool_call_name(START 带)+
tool_call_id + state(TOOL_RESULT_END 的结果态)。修正取这三个真字段:trace 现在能看清
「agent 调了 scaffold_init→write_source→build→run_gates… 哪一步、成没成」——这才是"看见卡在哪"。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 12:54:11 +00:00
zizi
21472811be fix(tier2): run_gates 缺 driver 时默认 business-sim play_spec(修服务态假性不收敛根因) 
★ 收敛根因实证(cp-smoke-006/007 真跑 + 007 现成游戏带 driver 重跑):服务态 play_spec=None →
游戏永不被真玩 → F_wiring(calls=0 expected=[])挂 + 富游戏三门拿不到观测=None(不是 False=没法评估)→
agent 看到 verdict=fix 却在"修一个不存在的问题"→ 反复 thrash 到 budget_exhausted。**游戏本身是好的**
(007 boot/render/live 全绿、暴露 resource.addCoins/consumeIngredient call-ID、latch 终态、bindInput 路由)。

铁证:用默认 business-sim play_spec 对 007 现成游戏重跑门 → decision=accept / L1.passed=True /
九门全绿 / 富游戏三门(tripleLink/economy/latch)全绿。即 M3 单写 + 设计阶段【已经】产出过门富游戏,
"不收敛"纯是控制面没传 driver 的假象。

修:run_gates 在 play_spec 缺 driver 时 setdefault DEFAULT_BUSINESS_SIM_PLAY_SPEC(driver 按参数驱动、
不靠逐像素坐标,对任何契约合规 business-sim 游戏通用;bakery feie-005 / coffee 007 同款过门),显式
play_spec 仍优先。一处修复同时惠及 agent 自己的 run_gates 工具(thrash 根)与控制面评门。richGame 仍据数据表自派生。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 12:43:27 +00:00
zizi
99a6afe08c docs(review): 非后端四模块代码评审收口 + _index 登记 
game-runtime / game-studio / tier2 / wg1 四个非后端源码模块的跨模块代码评审：
4 个并行后台 workflow × 三阶段（静态分析在 mini-desktop / 接口协议+大厂规范+项目铁律深审 / 逐条 file:line 对抗证伪）。
结果 0 P0、9 P1、7 P2、9 P3（另 1 条候选证伪）。核心代码语言规范达大厂基线、无 error 级问题；
真风险 = 生成 worker 成本与幂等闸、活层 3 处旧品牌+品牌门覆盖洞、契约真空/v1→v2 漂移、game-studio 构建门。
逐模块明细嵌于评审档 §七，_index §6 已登记。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 12:41:33 +00:00
zizi
ffd22f22c2 feat(tier2): C1 trace 中间件接 with_studio(开 Studio 即旁路推 OTLP span) 
C1 此前建了 observability.with_studio + studio_sink(OTLP→Studio),但没 wire 进真正跑的
Tier2TraceMiddleware(它在 worker/middleware.py、C1 没动)。本提交把中间件新建 adapter 的路径从
TraceAdapter(...) 换成 with_studio(...):drop-in——TIER2_STUDIO_URL/infra_config[studio] 取不到时
studio sink 自动 no-op,行为与原 TraceAdapter 完全一致(CLI/服务两线不开 Studio 即无感);取到地址则
每步在原 sink 外旁路推一份 OTLP span 给 AgentScope Studio(observe-only,best-effort,不阻塞主链)。
存 _studio_sink 句柄供收口 flush。配合 mini-desktop 起 Studio(创始人:now)即得真跑可视化。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 11:49:03 +00:00
zizi
b1217301c8 feat(tier2): C1 轻量观测——控制面把 SSE 事件记成每局可读 trace 
C1 观测的轻量兑现(创始人:没有完整的 C,B 迭代很慢)。不起 Node Studio(它在 6c6g 非 mini-desktop、
是 Node monorepo,重)——而是在控制面客户端侧顺手把逐帧消费的 SSE 结构性事件(跳过 *_DELTA 逐 token 噪声)
记成 per-run JSONL 时间线:模型调用/工具调用(带工具名)/工具结果/推理/reply 边界/卡死信号
(REQUIRE_USER_CONFIRM/REQUIRE_EXTERNAL_EXECUTION)。落工程 workdir/control-plane-trace.jsonl,跨 attempt
追加=整局多轮时间线。零服务改动、零 Studio 依赖、best-effort(写失败只告警不中断)。

迭代时一眼看清「agent 调了哪些工具、按什么序、卡在哪」——这正是这轮 debug 反复要的可见性。
observability/studio_sink.py 的 OTLP/Studio 全量 UI 路仍在、是将来可选(待 mini-desktop 起 Studio)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 11:01:06 +00:00
zizi
34336d3204 feat(tier2): C3 证路基线接 deepseek-v4-pro 跨族 cross-check(创始人 2026-06-24 裁定) 
网关现实(实测):new-api 只有 MiniMax + deepseek-v4-pro,无 Opus/Fable/Claude/GPT;
build_baseline_model('Opus') 真调返 503 model_not_found。创始人裁定证路当前用 deepseek-v4-pro
跨族 cross-check(不比 M3 明显强、证路力偏弱,但能跑;真强模型证路待网关开 Opus/Fable 渠道、
改 generation.yaml 即接,代码已就绪)。

加 BASELINE_CROSSCHECK + _BASELINE_NAME_BY_KEY 的 crosscheck/deepseek 聚合 key + generation.yaml
model.baseline_crosscheck=deepseek-v4-pro。实测 deepseek-v4-pro 在 new-api 上 Anthropic 原生路可用,
build_baseline_model('deepseek-v4-pro') 真调返「跨族已通」——证路走 Anthropic 路与 M3 同协议同线对照。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 10:56:55 +00:00
zizi
d0b30ddace feat(tier2): 设计阶段接进服务路径(修服务态不收敛根因) 
006 真跑实证:服务态 writer 拿空 design_text → 富游戏三门(tripleLink/economy/latch)全挂、
4 次 resume 不收敛(产物结构合法能渲染,但三系统联动没接对)。CLI 线 run_studio 先跑工作室设计
阶段再写、故更易过门;服务路径此前整段跳过设计(app.py 文件头标的 followup)。

修:bootstrap 加 _run_design_phase——在控制面进程内(有 agentscope+模型)复用 studio._design_stage
(工作室星形多 agent 团队 + 失败 degrade 回单 agent)产出 design_text,喂进 AgentRecord.system_prompt
(roles.writer_system 第二参)。每局建 agent 时跑一次,不随 resume 重跑。best-effort:设计失败返 ""
不阻断生成。do_design 经 drive_generation 透传(control_plane --no-design 可关,对照用)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 10:53:38 +00:00