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

411 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
zizi
39c16630ed merge(saa): 真结构化生成地基 feat→dev/2.0.0——U1-U4(运行时约定/build-from-source/真产gameDefinition/多模型回退)+6c6g评审整改(P1 K_STATUS清零/P2 fallback注释);flag默认factory灰度opt-in,生产零行为变更 2026-06-18 16:46:19 +00:00
zizi
8ccb5c7c7e docs: 内网凭据档(NEWAPI_KEY 等)+ AGENTS §6 条款9——内网阶段 keys/decisions 进文档、禁 env var(创始人定) 
创始人 2026-06-18:内网阶段所有决策+密钥进项目文档,不靠环境变量(内网 key 允许入仓)。新建 docs/内网凭据与端点.md 作密钥/端点单一事实源(NEWAPI_KEY=sk-84GA…/base http://100.64.0.8:3000/四机/Gitea);AGENTS §6 加条款9立为硬约束——需 key 查该档,别再反复找创始人要(已给几十次)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 16:33:22 +00:00
lili
6a9bd4d349 fix(saa): 6c6g 评审整改——P1 K_STATUS 清零 + P2 stage2 fallback 注释 
P1(真修):renderNode 起手 out.put(K_STATUS,"") 清 stale 状态——checkpoint/saver 跨 run 复用 state 时,
  上轮 giveup 写的 K_STATUS="failed" 会残留,下次 modify 进来 modifyRouter 首检 K_STATUS 误判失败、
  把 gamedef 确定性点改错误路由到 END。
P2(语义·仅注释):generateNode fallback 处加注,说明 stage2 升档后回退档仍取廉价档(MiniMax-M3)是
  「可用性优先于本次升档边际质量」的有意取舍(强档超时也要出包),非疏漏。

验证:mvn -Dtest=SaaStudioGraphTopologyTest,SaaStudioNodesRegressionTest → Topology 30/30 + Regression 8/8 全绿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 09:20:49 -07:00
zizi
a5c453f7c4 docs: 根因分析改进落地——003-U1 补改进杠杆(c1命门/a2/a3 等) + 修 saa skill 过时'天花板'口径 
据 docs/brainstorms/2026-06-18-生成失败根因分析:① 003-U1 补可执行改进杠杆(序=c零成本先→a升档+b ReAct;c1换few-shot含_forensicsView=命门/c2 I_control判据/c3 F_wiring接线/c4 H终局语义/a2 failCount重置/a3回喂源码),先单验c1;② saa skill 把'难门=生成质量天花板'(已被根因分析+Codex证伪)改为'主因=喂不全+救场不足+门判据偏'。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 15:16:06 +00:00
zizi
a0af0f658c docs(brainstorm): 生成 60% 失败根因分析——喂不全为主(命门=few-shot 缺 _forensicsView)非天花板 + 改进清单 
创始人 2026-06-18 指派。Opus 取证 + Codex 验证(双视角):① 命门=注入的 few-shot 探针 _goldenpath-probe/factory.js 缺 _forensicsView/latch,而 prompt 硬要求它→模型抄没见过的东西(代码直证 SaaPrompts:63/108 vs probe:77);② I_control 平滑跟手 harness 查、prompt 零提及;③ 真模型硬天花板无样本实证、非主因(scale-20 无'人工介入后仍不过'的款,Codex 同此);④ 救场两弱点:failCount 跨档不重置(强档只剩3次)+ 普通 repair 不回喂源码。改进序=c(零成本 prompt/few-shot 先)→ a 升档+b ReAct 并行;首步=mini-desktop 重跑取真 dump(两机现无 per-game dump,占比是推断)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 14:42:33 +00:00
zizi
7d4a77c36b docs(plan): 003 落创始人拍板——质量门优先 + 达标主杠杆=升模型档+ReAct(待拍→已定) 
创始人 2026-06-18:① 质量门 ≥80% 优先于成本 ¥0.15/款(临时破价 Phase-3 压回);② 达标主杠杆 = 升默认模型档 + ReAct(两者都上,ReAct 从'备选退路'提为主路,001-U5);(ii)降判据/(iv)改门为备选。③ 配套:Claude 做生成失败根因分析(另出)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 14:20:42 +00:00
zizi
0b8b968292 docs(plan): P1 按并行/串行拆两档(创始人定)—— 002 并行线 + 003 串行线,过 Codex+Opus 双评审 
创始人定:P1 = 001(生成机制线,执行中不改)+ 002(并行线:广度后端 U1-U7 + 前端 U8-U10 + 引擎收尾 U11 + 2 孤儿 P-OPN-08/P-ACC-03)+ 003(串行线:质量收口→flip→M0→最终验收 003-U4 + 退路)。按'能否并行'拆,解掉命运耦合(合并版的 P0)。拟 plan 004(引擎)并入 002-U11。

双评审(AGENTS §6 条款8):Codex 揪 1 阻断(P-OPN-08 需后端公开聚合 API、原误当纯前端)+ 4 重要(U11 先差分勿重造〔runtime 已有 drawText/SpatialHash/MTV〕/ P-ACC-03 验收面拓 feed/play/主页 / 003-U4 补 M1-M3 明细 / 跨档引用 + compliance 标注)全修;Opus 收敛复核确认 001+002+003=P1 全集无真孤儿、轴切自洽、无 P0、可收口。留 2 待拍(质量门≥80% vs 成本¥0.15 优先级 / 80% 不可达退路)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 14:09:20 +00:00
lili
cb0a273d43 docs(plan): plan-001 加执行状态收口快照(U1-U4 交付/验证 + gamedef 实证 + U5 延期 + 待 6c6g) 
应创始人「update plan 001」：在 plan 2026-06-18-001 进展结论后加「执行状态」节(决策正文 U1-U5/KTD/HTD 不动)：
- U1-U4 已交付+本机验证+推送(引擎 node --test 60/60;后端 mvn test-compile + Topology 30/30+Regression 8/8;双评审 18 条整改)；U1 含正式化 runtime-api-2d.d.ts + clickable 基元。
- gamedef 路实证:路径两品类均过 harness 9/9、repair 真抬率;success rate=引擎生成能力(高方差,正式 cutover authoritative=mini-desktop)。
- U5 正式延期(pom Phase1.5 + 地基稳后门)。
- 待 6c6g:schema clickable 枚举(不动现8契约)/ assertAfterPlay 字段词汇(共享 DESIGN_SYSTEM)/ 评审。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 06:44:26 -07:00
lili
95b2572e65 docs(game-runtime): U1 约定正式化 runtime-api-2d.d.ts(rt 接口 TS 契约 · 第10类契约 additive) 
plan 2026-06-18-001 U1 正式化产物(plan「1-2 轮后正式化」已满足:4 轮迭代+跨品类 9/9 实证+clickable 基元,约定已稳)。
手写 TS 契约(同 api.d.ts/game-host.d.ts 范式),与 gd-runtime.js 同形:
- gameDefinition 声明式模型:Render/Physics/Clickable/Marker 组件 + EntityDef/BehaviorDef(code)/RuleDef/SceneDef。
- rt 面(behavior 侧):实体 getEntity/entities/query/spawn/destroy + Entity 实例形 + input(轮询)/time(确定性,无 nowMs)/
  dt/random/score-win-lose(latch)/clamp-dist-overlap/fx/view。
- ForensicsState:固定取证键 + 逐实体 id 投影命名位(ball.x…)+ tag=target → targets[]。
- createRuntime(boot,gameDefinition)→Runtime(init/update/render/state/destroy/errors)签名。

落 game-runtime/src/host/(同 game-host.d.ts 之理:内部宿主↔behavior 接线面,非跨仓 SSOT);
additive 第 10 类契约,**不动现 8 契约**(故未改 source-project.schema.json;clickable 入其 kind 枚举=additive,
留 6c6g/创始人 决,contract-first 补正)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 06:38:50 -07:00
lili
80aaa116ab feat(game-runtime): clickable 声明式点击基元(harness 探针证 9/9)+ tap-targets prompt 迭代——治便宜模型 tap-handler 顽疾 
plan 2026-06-18-001 U3 迭代3-4轮(据快走查根因)。

根因(全budget+stage2 都不解,3轮prompt不解):便宜/强模型均**顽固把 tap 命中门控在分离 state 实体/计时器/turn 上**
  → 盲点驱动点不中 → tap-targets 类系统性 E_live/F_wiring/G_input/H 挂。即「让模型写 tap-handler」这条路便宜模型走不通。

引擎线根治(gd-runtime.js):新增 **clickable 声明式基元** `{kind:'clickable',score?,mark?:{shape,color,r},hitW?,hitH?}`——
  运行时内置:本帧点中带此组件且 !occupied 的实体 → 自动翻 occupied+spawn 标记(可见)+计分+fx。**离散点击类声明它即可、免写 handler**。
  验证:gd-runtime 单测 16(含 clickable 派发) + 全套 60/60;**手写纯声明式(behaviors:[])clickable tap-targets gamedef 过 harness 9/9**(E_live distinct=8/F_wiring/G_input/H 全过)——证基元+管线正确。
GAMEDEF_SYSTEM:教 clickable(替「写 tap-handler」)+ 参照2 改纯声明式 clickable few-shot(经探针证 9/9)。
runtime-api-2d.md:补 clickable 组件文档。

**关键测量定论(终结本机迭代)**:便宜模型 tap-targets 单管线生成**高方差**(同 brief 一轮 8/9 一轮 5/9)——
  N=1~2 小样 lili-mac 早读**信噪比不足**,无法可靠优化「模型产出过门率」(我前几轮在追噪声)。
  **管线/运行时/约定已证正确(手写金样两品类均 9/9)+ 引擎补了 clickable 基元**;**模型产出 cutover 率是统计量**,
  需大样+全 repair 预算 → **authoritative=mini-desktop SaaFullGraphE2eTest -Dsaa.e2e=1**(多 brief+5+3 repair+stage2)。
快走查工具:加 stage2 救场升档(QC_STAGE*)+ gamedef assert 字段 coerce 到 score(治 design 造 moves/totalRound 等取证读不到字段)。

设计决策待 6c6g:design↔gamedef 的 assertAfterPlay 字段词汇契约(design 应约束到 gamedef 暴露集 score/remaining,
  或运行时暴露更多)——触共享 DESIGN_SYSTEM。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 06:13:18 -07:00
lili
c24b7fb4d2 fix(saa): GAMEDEF_SYSTEM 加 tap-targets few-shot(harness 探针证 9/9 正确)+ 快走查 repair 可配 
plan 2026-06-18-001 U3 迭代2轮:据 cutover 早读「tap-targets 类系统性 5/9(E_live/F_wiring)」根因诊断+整改。

根因决断(harness 受控探针,无 LLM):把**手写 known-correct tap-targets gameDefinition**直接过全 harness
  → **9/9 真过**(E_live distinct=8/8、F_wiring 12 引擎调用)。**故运行时+装配器+tap-targets driver+约定全正确**;
  whack/tictactoe 失败 = **便宜模型生成质量**(tap-handling 写错:点击未判中→无 spawn/fx/计分→画面恒定),非基建/集成 bug。

GAMEDEF_SYSTEM 加 tap-targets few-shot(SaaPrompts.java):tile 网格每格 tags:["target"]+idx+occupied,
  justTapped→pointer overlap 判中→occupied 翻+spawn 标记(可见)+addScore+fx;win=score>=N。
  few-shot 本身经探针证 9/9 正确(教对 idiom);实测使模型确给 target 打标(gd-whack 9/10 tagged)。
  残留 tap-handling 精度=R3 便宜模型质量,靠 **repair 回环(真图 5+3 轮,本机只跑 3)+ stage2 升档(强档)** 解。

快走查:MAX_RETRIES 改 QC_MAX_RETRIES 环境可配(真图 maxRepairs=5,本机早读取 3 平衡时延)。

结论:**gamedef 路两大品类(realtime/physics + tap-targets)路径均证正确**;首攻便宜模型质量随品类波动,
  cutover 率 = repair 预算 + 模型档 的函数(二者在 mini-desktop 全图满配)。≥60% authoritative=mini-desktop。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 02:42:41 -07:00
zizi
16467157c1 docs(plan): 新建 003 Phase-1 生死门(质量达产线门+flip+M0验收)—— Codex+Opus 双评审整改 3 P0 
立项=双评审 P1-3(生死门无家)。新建后按 AGENTS.md §6 条款8 过 Codex+Opus 双评审,Opus 揪 3 P0 全整改:P0-1 60→80% 跨路径错配(60%=iife旧路/80%门所在 gameDefinition 路零行已建)→改'先实测真基线再收敛';P0-2 stage2救场已计入基线=空头退路→增'80%不可达退路分支'(升档/降判据/ReAct/改判门);P0-3 质量门 vs ¥0.15 成本门无优先级→列待拍(推荐质量优先)。+2 P1(M0机制归001本档只补验收gate/gating链显式追踪表)+2 P2(80%门测试加minSuccessRate硬断言/M0口径收窄不混M1/flip两步+回退/术语)。剩2项待创始人拍。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 08:28:04 +00:00
lili
099fb8106d test(wg1): gamedef 快走查加 repair 回环——证 repair 抬升率(runner 7/9→9/9 真过) 
plan 2026-06-18-001 U3 capstone:快走查加 repair 回环(mirror 真图:验证/真玩失败→verdict 回喂→重生成,≤2 重试),
证 ≥60% cutover 的真机制(repair)在本机可抬首攻失败到过门。

with-repair 早读(design+gamedef 全图镜像,deepseek-v4-flash):
- gd-runner ✅ 9/9 真过(att=3)——首攻 7/9,repair 回喂后重生成补齐 → 满九门。**repair 回环端到端证实有效。**
- gd-breakout 8/9(att=3)——H_progress(砖 remaining 未降):paddle-intercept 接球清砖精度,3 轮便宜模型 repair 未完全攻克
  (R3「九门是机制地板」难类;仍真渲染/构建/玩、挡板接指针)。
- 1/2 小样硬类:与 ≥60%(全图+更大样, authoritative=mini-desktop)目标一致——runner 类过、paddle 精度类待更多 repair/更强档。

总:gamedef 路本机已证 ①端到端可玩(pong/runner 满门)②repair 回环真抬率。≥60% cutover 量化门 authoritative=
  mini-desktop SaaFullGraphE2eTest -Dsaa.e2e=1(全图+repair+大样)。密钥经 _client 读 .env 不入码;throwaway 已清。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 01:18:33 -07:00
zizi
6c9c1bd2ad docs(agents): §6 条款8 去掉 Harness 触发——只保留 plan/brainstorm 文档双评审要求(创始人定) 
创始人 06-18:AGENTS.md 只写'新建 brainstorm/plan 文档须 Codex+Opus 双评审(Codex 挂回落 Opus)'这条要求;'写入 Harness'触发不入 SoT 条款。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 08:03:21 +00:00
lili
da4801828d fix(saa): GAMEDEF_SYSTEM driver 对齐加固 + 快走查升级全图镜像(design+gamedef)——据 U3 早读根因 
plan 2026-06-18-001 U3 迭代1轮:据 lili-mac gamedef 快走查根因诊断,加固 GAMEDEF_SYSTEM 与九门 driver 的对齐。

快走查根因(design+gamedef 全图镜像, deepseek-v4-flash 单发无 repair):
- 路径端到端真成立:声明式 gameDefinition→装配→构建→真九门;pong 9/9(无 design 简版)、breakout 8/9。
- 单发首攻失败模式根因:① I_control——挡板命名变体(paddlePlayer≠gatespec 的 paddle)/ 只接键盘不接指针(driver 靠点指针位驱动)
  / 控制体 clamp 范围窄于 driver 边缘 tapX(340)；② H_progress——设计稿 assertAfterPlay 引用取证读不到的自定义字段(totalRound)。

GAMEDEF_SYSTEM 加固(SaaPrompts.java,gamedef 路专属,不动现 SYSTEM):
- 命名逐字对齐 gatespec(挡板=paddle、球=ball,别用变体——读到 undefined=挂)。
- 可控体必须响应指针(`if(rt.input.pointer.down) paddle.x=rt.input.pointer.x`——driver 靠点指针位驱动,只接键盘=I_control 挂)。
- 进展落在可取证字段(score/remaining/实体位置;assertAfterPlay 别用读不到的自定义字段)。
验证:再跑 breakout 模型确按指令接指针控制(`if(pointer.down) paddle.x 追 pointer`)+ I_control tapX:50 已过;
  残留 tapX:340 未过=首攻 clamp 范围精度,属**repair 回环**(已建:验收失败→verdict 回喂→重生成)territory。

快走查工具升级(gamedef_quickcheck.py):加 design 步(抽 DESIGN_SYSTEM+复刻 extractGatespec)→ 全图镜像
  (classify 略/design→gamedef→装配→九门),getter truer 早读;prompt 抽自 SaaPrompts.java drift-free。

定位:单发快走查=首攻质量早读(非 cutover 门)。**≥60% cutover 门=全图含 repair 回环, authoritative=mini-desktop
  SaaFullGraphE2eTest -Dsaa.e2e=1**(单发 0/6≠失败:repair 回环抬升率,本机不跑 repap 多轮)。密钥经 _client 读 .env 不入码。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 00:58:01 -07:00
zizi
aefffb889d docs(agents): §6 加硬约束条款8——plan/brainstorm 文档及写入 Harness 必 Codex+Opus 双评审 
创始人 2026-06-18 定:新建 brainstorm/plan 文档(含就地扩活计划补 units)或写入 Harness(九门 e2e 评测 harness=生成质量裁决器)→ 收口前必过 Codex+Opus 双评审,Codex 不可用回落 Opus 单评;并行跑+喂设计前提+在档修+跨档列待办。本会话立证(对 plan 002 增量揪 2 P0)。放 SoT 入口档而非 .agents/rules(创始人指定)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 07:54:50 +00:00
zizi
e6cd1a2cd0 docs(plan): 002 双评审整改(P0-2 创作页归属/P1-1 分批验收门/P0-1 命名空间/P2) 
按创始人新评审门(brainstorm/plan 必 Codex+Opus 双评审)对 b53d2152 增量补评审,Opus 对抗式揪 2 P0,本提交修在档内的:P0-2 U8↔U9 创作页前端归属切清(owner=U8、U9 不重复)/ P1-1 U9 验收门拆子门A(已可接 feed/钱包/账号)·子门B(gated 社区/素材/模板)防8页伪完成 / P0-1 加 002 编号命名空间声明(喂Mac带 002-Ux,与 001 U1-U5 两套)/ P2 校准 P-CRT-13(壳已在非替mock)·摘要七域注·U10三跨联合验·U9八页映射。跨档项(001 加80%flip+M0 unit·前端线残迹sweep·总账回填)列收口待办待创始人点头。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 07:43:33 +00:00
lili
d8df5f27ec test(wg1): gamedef 路 lili-mac 快走查驱动 + U3 cutover 门早读(pong 9/9 真过) 
plan 2026-06-18-001 U3 验证：run.py 的 gamedef 版——generate(GAMEDEF_SYSTEM,从 SaaPrompts.java 抽取 drift-free)
→ build-from-source.mjs(校验 schema/引用/静态扫描+装配)→ scaffold/build/play 九门(harness 复用零改)。

早读(deepseek-v4-flash 便宜档,lili-mac 小样)：
- gd-pong 9/9 真过门（声明式 gameDefinition→可玩→满九门,范式端到端证实）。
- gd-runner/whack 8/9、gd-flappy 7/9，共性缺口 G_input——本快走查跳了 design 步、多数 brief 的 play_spec
  无 controlCheck/driver（gatespec），故 G_input 无控制驱动可施=快走查 harness 工件,非 gamedef 生成缺陷
  （游戏真渲染/真构建/输入真接线:runner justTapped→jump 在；pong 满过）。
- authoritative ≥60% cutover 门(全图含 design 产 gatespec) = mini-desktop SaaFullGraphE2eTest -Dsaa.e2e=1。

密钥经 _client 读 .env(gitignored)、绝不入码;throwaway 生成游戏(gd-*)已清,不入仓。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 00:25:13 -07:00
zizi
b53d215257 docs(plan): Tier-1 计划 002 并入前端接线+创作可用性骨架(U8-U10) 
按创始人拍板(a):不新建 plan 文件,就地把缺口当 units 补进现有 Tier-1 活计划(遵一题一活档·禁一 pivot 一文件)。新增 U8 创作可用性(P-CRT-10/11/13·Tier-0 优先)/ U9 studio 前端接线(8页去mock+素材/玩法模板两新页)/ U10 admin 运营台前端接线;骨架级=只定目标/范围/验收门,file 级实证细节留 Mac 在活代码树补。删过时的「前端接线=前端线」scope-out(新分工 Mac 全包前后端,域切已废)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 07:14:29 +00:00
lili
fd5b245baa feat(saa): U2 接缝 + U3 真产 gameDefinition + U4 多模型回退（gamedef 路 additive 灰度） 
plan 2026-06-18-001 U2(后端接缝)/U3/U4 · 后端线 · 真结构化生成上产线（saaSourceMode=gamedef，默认 factory 字节不变）。

U3 真产 gameDefinition：
- SaaPrompts 新增 GAMEDEF_SYSTEM（与现 SYSTEM 物理隔离，公平性铁律）+ buildGameDefMessages；内容=runtime-api-2d.md
  约定提炼（schema/rt 面/命名约定/硬约束）+ 内联 scan-clean few-shot；硬约束由 build-from-source 静态扫描兜底。
- SaaStudioNodes.generateNode gamedef 分支：产结构化 gameDefinition（looseParse 脏 JSON 容错）落 K_SOURCE_PROJECT；
  factory 路（含 regenerate 消费 base 源）字节不变。

U2 后端接缝（gamedef→可玩，scaffold/build/play/harness/build.mjs 全零改）：
- build-from-source.mjs 加 CLI（node build-from-source.mjs <src> <out> / --validate；被 import 不执行）。
- SaaGenNodes.validateNode(gameRuntimeRoot,sourceMode) gamedef 分支：经 build-from-source.mjs 子进程校验+装配
  sourceProject→factorySrc（下游 scaffold/build 零改消费）；CLI 失败回喂 repair。
- 确定性点改解锁：modifyNode(sourceMode) gamedef 路真改源不 fail-loud；modifyRouter(sourceMode) gamedef
  deterministic→validate（装配 patched 源重验）/ factory→fail-loud；assetNode 幂等（已有 assets 跳过，不覆盖点改）。

U4 多模型回退链：generateNode 主模型（含 stage1/stage2）耗尽 180s×3 重试后，回退同 role 跨家档（M_CODE/FIX_FALLBACK
  =MiniMax-M3）再试；接现 callWithTimeoutAndRetry/looseParse/救场阶梯不另起限次。GenModels record 收敛入参。

线程：AigcExecutorProperties.saaSourceMode（默认 factory）→ SaaGraphDispatcher → SaaStudioGraph.build 9 参重载 →
  assemble → generate/validate/modify/modifyRouter；8/7/5 参 build 旧重载 delegate "factory" 不破现调用。
worker prompt.py 不动（gamedef 为 SAA 路专属、http worker 仍 iife，无 shared prompt 漂移=无 split-brain）。

验收（lili-mac 快走查）：mvn test-compile 过（main+test）；模型无关单测 SaaStudioGraphTopologyTest 30/30
（含新增 gamedef deterministic→validate 路由证）+ SaaStudioNodesRegressionTest 8/8，零失败；build-from-source CLI
  实证（--validate exit0/2、assemble 产正确 import 路径工厂）。**gamedef 全链过门率≥60% cutover 门需 NEWAPI_KEY+
  mini-desktop（authoritative，未在本机跑）**。默认 factory 路行为字节不变（灰度 opt-in）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 00:05:18 -07:00
lili
160d9bc3e0 fix(game-runtime): U1/U2 双评审整改(correctness×adversarial)——driver 命名路径 + 边界静态扫描 + rt 加固 
子代理双评审(ce-correctness + ce-adversarial)对引擎线 9+9 条发现,逐条核证为真后整改:

gd-runtime.js:
- [HIGH] state() 派生九门 harness driver 命名路径:逐实体按 id 投影顶层位(ball.x/paddle.x/bird.vy…
  +w/h/r/angle)+ tag='target' → targets[{x,y,idx,occupied,safe}](对齐 gatespec driver 契约)。
  此前 driver 读 undefined→无法驱动→机制门必挂(plan U1 step5 要求,原缺)。
- [High] addScore 守 num(NaN/字符串不污染 score 共享契约);[High] 冻结 rt 纯 API 面
  (input/fx/time/view+本体,防 behavior 改写共享 API 串味全局,实体仍可变)。
- [Med] 重复实体 id:addEntity 保先到者可寻址+记信号,reap 仅删 byId 指向的死亡实例(不误删存活者)
  + 实体上限 5000(防失控 spawn 静默膨胀)。
- 移除 rt.time.nowMs(墙钟=非确定性逃逸口);elapsed 帧末推进(首帧 now()=0);输入沿恒帧末清
  (含 latch 后,杜绝滞留);overlap 显式 0 被尊重(不被 truthy 误当默认)。

build-from-source.mjs:
- [keystone] 校验边界静态扫描 behavior.code/rule.condition:拦死循环(while(true)/for(;;))、沙箱逃逸
  (process/require/eval/.constructor/Function/globalThis)、确定性逃逸(Math.random/Date)、DOM/网络、
  condition 副作用(;/赋值/win-lose-spawn-destroy)→ 转 validationErrors 回灌 repair。同步 JS 不可进程内
  硬中断+new Function 不沙箱,故在边界拦截(模型代码只在浏览器执行,esbuild 仅静态打包);信任模型写进 header。
- [Med] 非数组 components/entities 强制数组化(不抛裸 TypeError);behavior code 须非空字符串;
  id 唯一性+null/undefined id 不入引用集(杜绝 'null'/'undefined' 假命中);循环引用 JSON fail-loud
  (带 validationErrors);`<`→< 转义(inline-injection 安全,防 </script> 提前闭合宿主内联 script)。

runtime-api-2d.md:补「边界硬拦截」「取证/driver 命名约定」(实体命名 ball/paddle、目标打 target 标)——交 U3 prompt 教模型。

验收:node --test 全 runtime 套件 59/59(原 50 + 9 条修复验证:命名路径/addScore守卫/rt冻结/重复id/
nowMs移除/非数组/非串code/静态扫描/循环引用+</script>转义);archetype few-shot 经核证 scan-clean(不教被拒模式)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 23:39:57 -07:00
lili
c8526f1dd6 docs(game-runtime): U1 运行时约定文本 runtime-api-2d.md(交 U3 prompt 嵌入) 
plan 2026-06-18-001 U1 交付物「约定文字同步喂进 prompt → 交 U3 落 SaaPrompts 新 SYSTEM」。

新增 game-runtime/src/host/runtime-api-2d.md——写 gameDefinition behavior 逻辑时能用的全部 rt 面
的人/模型可读契约:gameDefinition 结构 / behavior 代码契约(new Function('rt','self','dt',code)+
trigger 语义+四条硬约束)/ rules / rt 面全 API 参考 / 组件 / 4 原型 few-shot / 常见坑(治真实模型
漂移:禁约定外 helper、禁 Math.random、终态置 latch、behavior 不画图、关键事件挂 fx)。

U3 的 GAMEDEF_SYSTEM prompt 直接嵌入本文。状态 v0(已过 4 类原型表达力证),保留补 idiom 余量。
落点同 game-host.d.ts 之理(内部宿主↔behavior 接线面 → game-runtime/src/host/);
是否升格 contracts/ 跨仓契约由 6c6g(contracts owner)定。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 23:11:14 -07:00
zizi
2937886a47 docs(skills): 远程驱动 Mac Claude Code 方案(ssh+tmux)——多设备复用 playbook 
创始人 2026-06-18 拍板:6c6g 经 ssh+tmux 双向驱动跑在 tmux 里的交互式
Claude Code(send-keys 派活 / capture-pane 读屏),不走 ACP、不走
claude -p headless;采用 option 1=独立 worktree 专用会话,要求多设备复用。

- 新增 .agents/skills/drive-remote-claude-tmux.md:每设备配置块 + onboarding
  侦察配方 + 通道原语(已实测)+ 专用会话(防撞树)+ bypass-perms + 安全红线;
  完成判据=git push 非读屏;screen hardcopy 坏不用、PATH 假阴性坑均记录。
- README skills 索引补一行。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 06:10:49 +00:00
lili
4292f4e793 test(game-runtime): U1 收敛判据——rt 约定跨 4 品类表达力覆盖(并作 U3 few-shot 库) 
plan 2026-06-18-001 U1 验收「3-5 类游戏 behaviors 用约定全跑通、零约定外 helper 漂移」。

新增 game-runtime/src/host/gd-archetypes.test.mjs——4 类原型 gameDefinition 经 createRuntime 真驱动:
- ① paddle-intercept(realtime+连续输入键/指针 + overlap 反弹 + lose latch)
- ② event-clicker(event+离散 justTapped + addScore + rule 胜)
- ③ dodge-spawn(realtime + rt.spawn/query/destroy + rt.random + overlap lose)
- ④ runner(realtime + physics 组件重力积分 + justTapped/justPressed 跳 + spawn 障碍 + 碰撞 lose)

headline 断言 = runtime.errors() 为空(零约定外 helper 漂移/零抛错)+ 各原型出合理状态转移
(移动/计分/终态 latch + 输入响应 + physics 重力 + spawn 真生成)。证 rt 面够表达目标品类谱。

定位:此为「约定表达力」证(手写金样,非真实模型输出)——真实模型 idiom 漂移收集随 U3
(GAMEDEF_SYSTEM prompt + NEWAPI_KEY)落;这 4 份金样并作 U3 prompt few-shot 库源。
验收:node --test src/host/gd-archetypes.test.mjs 4/4;全 runtime 套件 50/50 无回归。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 23:08:51 -07:00
lili
b112f888cf feat(game-runtime): U2 build-from-source 装配器(gameDefinition → 可玩工厂源文本) 
plan 2026-06-18-001 U2 · 引擎线 · 解锁「源 → 可玩」装配链。

新增 game-runtime/src/host/build-from-source.mjs:
- validateSourceProject(sp) → {ok,errors,gameDefinition}:轻量校验 + top-level strip
  (产线容错必做——剥模型塞的 schema 外键);引用完整性(entity.components→components[].id /
  scene.entityRefs→entities[].id)+ behavior 缺逻辑 code 揪错。守 game-runtime「本机零依赖」
  不引 ajv(inner 键宽松保留运行时用的 vx/vy/tags,待 schema 迭代再收紧)。
- assembleFactoryFromSource(sp,{runtimeImportPath?}) → generated-factory.js 源文本:
  对齐已冻装载契约(game-host.d.ts:default export 工厂 → GameInstance{init,update,render,
  destroy,_forensicsView}),五法委托 U1 createRuntime;gameDefinition 内联为 JS 字面量、
  behavior.code 作数据串随之内联(运行期 new Function 编译)。校验失败 fail-loud(err.validationErrors
  供 buildNode 回灌 repair feedback)。

接现有零改下游:产出文本 → scaffoldNode 落 generated-factory.js → scripts/build.mjs(esbuild,
不动)→ bundle.iife.js → 九门 harness(零改);entry-bundle.template.js 不动。

验收(lili-mac 快走查):
- node --test src/host/build-from-source.test.mjs 5/5——校验+strip / 装配产物含装载契约要件 +
  node --check 过 / fail-loud / **端到端功能证**(装配文本经 createRuntime 真跑到 win + fx 真接线);
  全 runtime 套件 46/46 无回归。
- 真 esbuild 链探针(探针目录已清,不入仓):金样 gameDefinition → assemble → scaffold(正确深度)→
  真 build.mjs → bundle.iife.js(215KB,语法过,__GameBundle 全局在);metafile 实证
  gd-runtime.js + boot-game-host.js + littlejsengine 全内联。

范围说明:U2 的后端 Java 接线(SaaGenNodes.buildNode/scaffoldNode 从 K_SOURCE_PROJECT 装配、
SaaStudioNodes.modifyNode deterministic 解除 fail-loud)属后端线、需 mvn/mini-desktop 验证,
随 U3 后端线一并落(plan 允两线并行)。本提交 = U2 引擎线核心(本机可验的装配地基)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 23:04:46 -07:00
lili
000f87d98b feat(game-runtime): U1 运行时约定基座 createRuntime/rt(2D 适配器 behavior 侧 API) 
plan 2026-06-18-001 U1 · 引擎线 · 真结构化 gameDefinition 产线化地基。

新增 game-runtime/src/host/gd-runtime.js:
- createRuntime(boot, gameDefinition) → 建可变世界(entities 实例)+ 产 rt 对象;
  rt 即 U2 装配器编译每 behavior 时 new Function('rt','self','dt',code) 注入的那个 rt。
- rt 面(落 plan KTD2):实体 getEntity/entities/query/spawn/destroy(.x.y.vx.vy.alive
  .components.tags+.get/set/destroy);输入轮询 input.isDown/justPressed/justTapped/pointer
  (包 ctx.getInput 受控事件);时间随机 time.now(相对 elapsed,非绝对钟)/dt/random/randRange
  /randInt(走 boot.ctx 受控种子,禁 Math.random/Date.now);分数胜负 score/addScore/setScore
  /win()/lose()(置 latch 终态 gameover,不可逆=H门);工具特效 clamp/dist/overlap(AABB)+
  fx.burst/beep(经 ctx.getEngine 真调引擎粒子/合成核=满F门,无引擎优雅 no-op)。
- behaviors 各带逻辑 JS 经 new Function 编译(init 跑一次/其余每帧),抛错隔离+回灌质量信号;
  rules condition 编 JS 布尔(win/lose latch、score/advance 上升沿);物理组件 opt-in 积分;
  声明式渲染器逐实体按 render 组件画 rect/circle/fill(behaviors 只逻辑不画)+极简 HUD。

受控面铁律:经 boot.ctx(PluginContext)注入,不触裸引擎/DOM;缺 ctx fail-loud。
迭代状态 v0(plan「别冻早」):契约 runtime-api-2d.d.ts 待收 3-5 类真实模型输出补 idiom 再正式化。

验收(lili-mac 快走查):node --test src/host/gd-runtime.test.mjs 10/10 过——
三条必验(rt.random 同种子可复现/win latch 驻留不可逆/fx.burst 真触发 ctx.getEngine)
+ 集成(behavior 编译跑通/rule latch/spawn-destroy-回收/输入轮询/物理积分/渲染出图)+缺 ctx 守卫。
全 runtime 套件 41/41 无回归。测试文件就近 src/host/(贴 npm test 的 src/**/*.test.mjs 约定,
非 plan 所写 test/unit/——遵仓内既有 co-located 约定)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 22:53:38 -07:00
zizi
5bff11dfaf docs(plan): plan-001 实现单元细化为 Mac 可直接执行版——读码实证 file 清单 + 命令级验收门 + 并入 build段设计 
U1-U5 逐单元补:精确 file 路径(接哪个现有类/方法)、关键决策步骤、可跑验收命令。
并入 build段双证的优化设计:
- U1 运行时约定 rt 面(getEntity/spawn/input/time-random 受控/score-win-lose latch/fx 真调引擎)落 game-runtime/src/host/gd-runtime.js,接 boot.ctx 受控面
- U2 build-from-source 装配六步(strip unknown-key+ajv/内联/createRuntime/声明式渲染器/取证派生/behavior沙箱),接 SaaGenNodes.scaffold/build,解锁 deterministic modify 路(现 guard fail-loud);复用 build.mjs+九门 harness 零改
- U3 generateNode 真产 gameDefinition 落 K_SOURCE_PROJECT,SaaPrompts 新 GAMEDEF_SYSTEM 与现 SYSTEM 物理隔离;难门优化(F门/latch/I_control/约定外helper/unknown-key strip)进 prompt+gatespec;cutover 量化门=过门率≥60%(iife 现基线)
- U4 多模型回退链接现 callWithTimeoutAndRetry+looseParse+救场阶梯;deepseek-v4-flash 打底
- U5 ReAct=ReactAgent.asNode,九门 verdict 强制终止,挂 ToolCallLimitHook

接线锚读码核证(SaaStudioGraph.assemble §6.2 / source-project.schema.json / AigcExecutorProperties);
file 两线分组(canonical §8):U1/U2 引擎线·U3-U5 后端线;验收门给精确 mvn -Dsaa.e2e=1 命令(mini-desktop)。
只改实现单元节,KTD/HTD/背景/进展结论不动。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 05:04:00 +00:00
zizi
771619c7da docs: 新角色分工(Mac开发/6c6g大脑)+ 收编他session loose-end + _index修漂移 
- 多session分工总账 §2/§5/§7 重定:域切→角色切(Mac全开发按计划执行 /
  6c6g设计·计划·评审·文档·优化);Mac工作清单(plan001 SAA产线化Tier0 +
  plan002 Tier-1剩4域 + 前端8页)+ 6c6g大脑角色 + 协调约束(git中介·够不到Mac)
- 收编他session未提交:orchestrator *_walk脚本×6 + v1对话生成修改素材/
  v2生命周期项目管理 review + prefix-cache preflight(保全)
- _index修漂移:v2=ACTIVE范式基座(改源不改包)、v1=留痕(前提被supersede);
  生成域canonical现归本session(6c6g)维护

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 04:56:15 +00:00
zizi
1101d01661 docs(saa): reconcile 生成域 canonical 到双证地基现状 + 并入诚实回退 
三档 canonical reconcile 到 2026-06-18 真相,并入另一 session 诚实回退:

- agentic编排-SAA.md(canonical SoT):§0 当前状态改"16 节点 studio 已建并合入
  dev/2.0.0"(裸图=接法A 七成躯干)+ 分清现产线 iife/GameConfig 路(e2e 60%)
  vs gameDefinition studio 已双证产线化中替换它;§2 图加目标态 gameDefinition
  studio 说明+产线化指针;§7 加双证地基 done(spike 92-100%/build 段 deepseek 3/4
  过九门)+ 16 节点 e2e 首证 done,"他 session 在飞"改"本 session 独家在飞产线化"
  +接法B ReAct 演进(九门兜底=自治在门内裁决在门外);143 行≤150 canonical 限。
- 固定架构-review:顶部加双证地基状态横幅;§4 加 16 节点已建现状注(指 §10.1
  权威)+接法A/B 演进+产线化 plan 指针;§1.5 agent 列表"深析中"改"深析→§10.1
  +全图已建"。并入回退(header 重指 v2 独立档/§4 表初版叙事)。
- 固定架构-execution:顶部加双证地基状态横幅(双证/16 节点/现 vs 目标产线/接法
  A-B/红线解除)。并入回退(§0-5+§12 header 退回"待解",源项目存储归属 studio
  vs project 保持真 open=未拍;缓存+classify spike 已绿解除)。

铁律未破(九门定 done/禁 LLM 自评/接法B 亦九门兜底)。仅编辑 3 档,不碰代码。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 04:33:42 +00:00
zizi
8db1414281 docs: 真结构化地基双证 + Tier-1 三域收口回填(plan 001/002 + 总账) 
- plan 001 重写为「SAA 真结构化生成主线—地基产线化+ReAct演进」:spike+build段双证
  地基成立(便宜模型 gameDefinition→build-from-source→真过九门 deepseek满分3/4款),
  创始人拍真结构化+SAA独家本session开发;产线化5单元(运行时约定2D适配器/
  build-from-source产线化/generate真产/模型可靠性/ReAct演进接法B);接法A七成已建是躯干
- plan 002 进展:Tier-1 feed/econ/account 合入 0db1d0da(codex揪3 P0全修,82测试绿),
  剩 social/admin/material/template
- 总账 M2:真结构化地基双证里程碑回填

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 04:20:53 +00:00
zizi
0db1d0da6d fix(trade): AccountServiceImplTest grant 测试补 insert 回填 id(test-only) 
原 impl agent 未跑测试漏:mock insert 只 thenReturn(1) 未回填自增主键,
grant() 返回 grant.getId()=null → assertNotNull 失败。改 thenAnswer 模拟 MyBatis 回填。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 04:02:46 +00:00
zizi
ec23ff61bc feat(compliance): U4 R-ACC 政策正文页+申诉回路 
codex 评审 MERGE-WITH-FIXES→修 P0(申诉重复提交守卫:STORED生成列pending_flag+uk_user_ban_pending局部唯一+@Transactional+DuplicateKey友好返回)+P1(@Transactional/@Size/@Min)。V22。plan 2026-06-18-002 U4。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 03:56:58 +00:00
zizi
ca53a0db0c feat(trade): U2 R-ECON admin赋余额+会员订阅(独立流水表+幂等) 
codex 评审 NO-MERGE→修 P0(订阅幂等漏洞:独立幂等账本表 game_trade_subscription_grant+uk_biz_no,延期前先写、同事务)+P1(VO @Size/totalIncome注释对齐/权限种子SQL)。V21。plan 2026-06-18-002 U2。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 03:56:58 +00:00
zizi
9f2b9f9feb feat(feed): U1 R-FEED feed 游标分页真化((sort_score,id)复合游标+二次过滤续取) 
codex 评审 MERGE-WITH-FIXES→修 P0(MAX_FETCH_ROUNDS 高过滤率提前到底丢数据:dbExhausted 区分库尾vs轮次中断,hasMore=overflow||!dbExhausted)。plan 2026-06-18-002 U1。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 03:56:57 +00:00
zizi
750fdce993 docs(plan): gameDefinition 迁移重构为 spike 先行 + Tier-1 广度拆独立计划 
双对抗评审(codex+opus)揪出初版根本前提问题(gameDefinition 包JS非替代/
赌注未验证/空验收门/基座与广度命运耦合),创始人裁定「前置 spike 先行」。重构:
- 2026-06-18-001 重写:gameDefinition 迁移=前置 spike(路A 模型产结构化 vs
  路B 模型产JS+后端抽取,端到端过门率 vs 现60%基线)+ 工程条件于 spike 通过 +
  引擎线 E1/E2;修正前提框架(源组织JS非替代);engineBundle 全保留冻结
- 2026-06-18-002 新建:Tier-1 七域广度拆出(独立 JIT,不受迁移卡)+ 补强验收级测试矩阵
- 评审7项风险(命门spike/引擎承重/dual-path双cutover/空门/worker split-brain/
  存储归属/历史游戏)全纳

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 02:17:09 +00:00
zizi
d51a6b5943 docs(plan): 后端 Tier0 生成主线收口——U1-U7 机制全收口 + status=completed 
创始人拍板「A 收口后端·defer 切换」。计划加收口结论:
- U1-U6 后端代码全合入(每单 codex 评审揪真 P0 后修绿)+ 契约冻结 8/8
- U7 SAA 真全图 e2e 首证(bf99662c):机制零 prod bug,成功率 60%<80% → 默认产线按门未切,现 worker 主链零回归
- defer 切换触发+配方:dispatcher flag 已存在,门交 W-G1 生成质量域(到 80% 一行 flip)
- status active→completed

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 01:04:19 +00:00
zizi
1bca84c91e docs(saa): SAA 真全图 e2e 首证回填——总账 M2 + saa 技能(成功率 60%/U7 cutover 未切) 
- 总账 M2 行:SAA 真全图 e2e 首证(SaaFullGraphE2eTest bf99662c)零 prod bug,
  成功率 3/5=60%<80% → U7 worker 转 SAA 默认产线按门未切,现 worker 主链零回归
- saa-graph-orchestration 技能新增「真全图 e2e 测成功率」节:零 DB 测法(stub callback+
  内存 checkpoint)/异步派发测试坑(共享 latch+traceId 归位,单款 3.5-16min)/首证 60% 基线
  (难门 I_control/F_wiring/H_progress=生成质量天花板,SAA 机制≠生成质量)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 00:42:33 +00:00
zizi
bf99662c3f test(aigc): SaaFullGraphE2eTest — SAA 真全图 e2e 首证门控测试(U7) 
U7 集成顶石的门控集成测试(-Dsaa.e2e=1 + NEWAPI_KEY)。构造真 5 参
SaaGraphDispatcher(stub callback 捕获 reqVO+latch,DataSource=null 内存
checkpoint,零 DB),顺序跑 N 条一句话 create job,真 LLM(new-api 五角色)+
真九门 harness(node/esbuild/Chrome,4320/9222 串行)+真 16 节点全图
(render→classify→design→generate→validate→scaffold→asset→build→play→player→nreview→emit/giveup)+真出口回调,测成功率。

首证(2026-06-18,mini-desktop):SAA 真全图 e2e 机制完整跑通、零 prod bug;
成功率 3/5=60%(贪吃蛇/接金币/躲障碍 succeeded,engineBundle≈211KB 含 __GameBundle;
打砖块败 I_control、点击消除败 F_wiring+H_progress,救场阶梯耗尽 giveup 真落盘)。
单款墙钟 3.5-16min(九门真玩循环+最多8救场轮固有,同 Python W-G1)。
→ 成功率 60% < 80% 转正门:cutover 未切(现 worker 主链保持默认,零回归)。
gap=难门生成质量(prompt 接地/gatespec/救场调优),W-G1 生成域调优单元。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 00:40:14 +00:00
zizi
679afa1c65 feat(aigc): U5 giveup 真落盘 + U6 modify regenerate 取base源真消费(B4/B7) 
6c6g 后端 Tier0 计划 U5+U6(docs/plans/2026-06-17-001-...)。
- U5 giveupNode 真落盘:gameRuntimeRoot 句柄 + attempts/verdict/escalationEvents 整包写盘 giveup-dump.json + K_GIVEUP_DUMP_PATH 回填真路径;
  best-effort 落盘失败仍正确 failed 终态;多级升档 stage3+ follow-up
- U6 modify 不被卡部分:
  · base 源 dispatcher 据 baseVersionId(V19 持久化)反查 SourceProjectApi.fetchByVersionId→K_SOURCE_PROJECT(零新增列/不搬大 blob)
  · regenerate-module 缺 target fail-loud(防静默全量重生成)+ 真消费 base 源(buildRegenerateMessages 注 base 源 JSON+目标 behavior 聚焦,system 不变;create/repair 普通路零变)
  · deterministic guard-pending-E2 一字未动;严格 per-behavior splice-back 依赖结构化源=follow-up(诚实标注)
- -api:SourceProjectApi.fetchByVersionId + DTO
- 测试:aigc 46+studio 44=90 绿(+17 新);codex 评审 NO-MERGE→2 P0(缺target/伪收窄)全修后绿

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 23:02:10 +00:00
zizi
069ae73e97 feat(aigc/worker): U3 trace 扩展键 + U4 缓存命中落账(B5/B9) 
6c6g 后端 Tier0 计划 U3+U4(docs/plans/2026-06-17-001-...)。execution §5.8 trace+cost 落值。
- U3 extractTraceQuietly(Java)+ _extract_trace(worker)additive 抽 modelTier/escalationEvents/giveupDumpPath;
  仅真升档态(stage2/escalationEvents 非空)落 modelTier + 形态校验(非空 str/非空 list)→ 字节兼容(无扩展键键集与扩前一致)、Java/Python 两路同口径
- U4 cost.py 缓存命中折¥:两套字段取 max(DeepSeek prompt_cache_hit_tokens / MiniMax prompt_tokens_details.cached_tokens)
  + cache_ratio 折真实 quota;worker usage 捕获(_safe_int 兜脏不抛);pricing 不可达 tokens-only+costFallback 标记;不阻断仅观测
- 诚实边界:SAA Java 路无 cache 字段源→省略不伪造(follow-up);AgentScope 丢 DeepSeek 顶层字段(待真跑对账);worker 生产路完整落账

验证:mini-desktop Java 12+(SaaGraphDispatcherTraceTest)+ Python 73(test_cost 56/wg1_groupb 17)全绿;
codex 评审 NO-MERGE→2 P0(字节兼容/usage 阻断)+2 P1(pricing 口径/两路一致)全修后绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 22:26:27 +00:00
zizi
d57032a6d3 feat(studio): U2 源项目落库事务(B8)+ V19/V20 数据完整性 
6c6g 后端 Tier0 计划 U2(docs/plans/2026-06-17-001-...)。execution §5.2 源项目工件落库 + status 机器态串联。
- GameSourceProjectDO/Mapper/SourceProjectService(studio,§12-①)+ SourceProjectApi seam(land/markBuilt/markOrphanById)
- 落库挂回调外层 DifyCallbackServiceImpl(非内层 tx)——守 §5.2「源落库与建包非同一大事务」
  (land 建包前独立 commit/markBuilt 成功后/markOrphan 失败补偿)
- status 0 草稿→1 已构建(回填 version_id)/2 孤儿(不建包不动 currentVersion);
  DifyCallbackReqVO additive sourceProject;dispatcher 从图终态抽 K_SOURCE_PROJECT
- 数据完整性(codex 评审 2 P0+2 P1 全收口):
  · P0 终态任务重复回调跳过 land(防版本血缘污染)· P0 去重按 game_id+source_hash + markBuilt 校 gameId(防跨游戏复用)
  · P1 markBuilt 与 notify 解耦(notify 失败不停 status=0)· P1 markOrphanById 精确标 + V20 唯一键 uk_game_source_hash(并发兜底)
  · post-commit best-effort 包兜底 try(防挂点失败反触写链补偿误置 failed)
- 诚实边界:现图只产最小骨架源(gameDefinition 待生成 agent 真填,跨单元),终态有什么落什么不伪造

验证:mini-desktop 编译绿 + 33 单测全绿(DifyCallback 19/SourceProject 14,含跨游戏/gameId校验/终态重复/notify解耦/markOrphanById);
V19+V20 SQL 结构绿(Flyway-apply 留部署验);codex NO-MERGE→2 P0+2 P1 全修后绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 21:46:38 +00:00
zizi
d64dcc9080 feat(studio): U1 studio 生命周期编排 create/modify/extend(B6) + V19 modify 持久化 
6c6g 后端 Tier0 计划 U1(docs/plans/2026-06-17-001-...)。生成主线 modify/extend 生产可达。
- /studio/{create,modify,extend} + 5 VO(对齐 studio.yaml)+ StudioServiceImpl 三方法
  (create=draft+generate 复用;modify/extend 经扩展 aigc seam 委托;mode×target 锁定映射校验;白名单+归属门)
- aigc seam:AigcGenerateReqDTO/VO/AigcTaskDO additive 扩 modify 四件套;AigcGenerateExecutor.putModifyFieldsIntoJob
  接进 §6.1 job(键名对齐 buildInputs);project seam getVersionOwnerUserId/getVersionGameId(归属边界)
- V19.0.0__aigc_task_add_modify.sql:game_aigc_task 加 modify_mode/base_version_id/modify_patch +
  AigcTaskDO @TableField 持久化映射 → modify 四件套跨异步 tick 真抵达 buildInputs(化解执行器从 DB 重建无内存续传)
- 错误码 1-112-003-*;additive(存量 modify_mode='' 即现行 create 分流,零破坏)

验证:mini-desktop 编译绿 + 54 单测全绿(Studio 27/Executor 22/Project 5);V19 SQL 结构绿(Flyway-apply 留部署验);
codex 评审 MERGE-WITH-FIXES(0 P0;P2 注释已修)。follow-up(codex P1,计划已 deferred):
  idempotency 去重(契约缺省=不去重,present-dedup 待幂等基建)、taskChain.baseVersionId 轮询回显(即时已回显,轮询待小补)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 20:39:05 +00:00
zizi
e7243ef855 docs(plan): 6c6g 后端线 P1 Tier-0 生成主线收尾实现计划(ce-plan) 
ce-plan「6c6g work list」产出(origin=6c6g 后端 P1 工作清单 requirements)。Deep 计划,7 单元:
U1 studio 编排 create/modify/extend · U2 源项目落库事务(status 机器态/孤儿) · U3 trace+cost 落值 ·
U4 缓存命中落账 · U5 giveup 完整 dump · U6 modify 不被卡部分(确定性 build-from-source guard-pending-E2) ·
U7 worker 转默认产线(feature-flag+隔离实例真验)。
范围=Tier 0 关键路径;Tier 1+ 广度 + 确定性 build-from-source(依赖引擎 E2)显式 deferred。
grounding:StudioServiceImpl / 回调内外层事务 / B2 节点实证 + execution §5/§6/§7.1。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 19:26:56 +00:00
zizi
6d21f3e434 docs(coord): 6c6g 后端线 P1 工作清单 requirements 档 + 总账 §7.1 指针 
ce-brainstorm「6c6g work list」产出(创始人选 1+2):
- 新增 docs/brainstorms/2026-06-17-6c6g-后端-P1-工作清单-requirements.md:后端线 P1 完整范围
  (全 13 模块;Tier0 生成可靠=SAA 收尾 B4-B9+worker 转产线 / Tier1+ 广度后端经济/feed/社区/账号/素材/玩法模板/admin;
  边界:compliance硬化→P2、runtime真编译=架构已解(build 在 worker)、渠道/pay→P3、护城河→P2/P3;依赖/成功标准/3 待确认)
  —— 作 ce-plan 的 origin。
- 总账 §7.1 加指针指向该权威详档(协调摘要 + 详档分层,避免重复漂移,一题一活档)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 19:16:55 +00:00
zizi
e70652c57a docs(coord): 多session总账 §6/§7 刷新为契约冻结后各线当前工作清单 
§7「即起 M0 contract-first」(已执行过半 stale)→「各线当前工作清单」:
- 顶部加当前进度横幅(契约冻结 8/8✅ + B2 16 节点合入 04f3bfee → 两线可开工)
- §7.1 后端线:B1-B3✅+trace/studio.yaml✅;Tier0 紧接 B6 studio 编排=下一件大头,B5/B8/B9/B4余/B7;广度 Tier1+;验证债 V18 Flyway/SAA e2e
- §7.2 前端+引擎线(Mac)全可开工:E1 2D适配器=最高价值首件 + E3/E4/E2/E5/E6;广度 8 页 Tier1+
- §7.3 支撑/集成/founder;关键路径=B6+E1/E3/E4 合流 M0
- §6 优先级对齐创始人重排序:玩法模板#3/素材中心#7=非最高优先级,旧「核心1-6先行」flat 口径作废

一题一活档:就地刷新协调活档,不另起新档。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 18:43:18 +00:00
zizi
04f3bfeeb6 fix(aigc): B2 codex 评审整改——救场阶梯连贯/escalate真切档/modify guard/RFC6901 
codex NO-MERGE→整改:
- P0-1 validate/build/play 硬失败统一 bumpFailCount(救场阶梯 5/8 对各门生效,非仅 play+recursionLimit 兜底)
- P0-2 nreviewRouter 补 escalate 分支(narrative 同 5+3 阶梯,§5.9)
- P1-5 stage2 强档 deepseek-v4-pro(对齐 models.yaml)+ generate 按 modelTier 二维选档(升档真生效)
- P1-6 applyDeterministicPatch 改 RFC6901 JsonPointer(支持数组下标/追加,越界不损坏源)
- P2-8 classify 失败错因记 trace(非 feedback,免污染 generate 修复上下文)
- P0-3 dispatcher 透传 modifyMode/modifyPatch/baseVersionId/sourceProject + 非法 modifyMode fail-loud(禁静默走 create;job 侧填充待 B6)
- P0-4 modify deterministic guard fail-loud(failureReason=源构建管线待 B7+引擎E2;router fail→END,不静默接忽略 sourceProject 的旧 build)
- P1-7 asset 产侧 merge 真(sp.set assets;消费侧 build→GamePackage 待引擎线 E2/E3)
+5 拓扑测试(共 19 @Test 非门控);create-metric 全链连贯;§1.4 硬约束未碰。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 18:08:08 +00:00
zizi
706d014869 feat(aigc): B2 SAA 固定架构图拓扑扩展——+5 节点(classify/asset/modify/escalate/nreview)+ 救场阶梯 
execution §6 拓扑落地(opus 实现 + 框架 API 对真 1.1.2.2 jar javap 核验)。11→16 节点,布线唯一源 assemble,无孤儿。
- 5 新节点:classify(真LLM物理优先→archetype/profile三维+§6.4映射表)、asset(六类规格v0+产消打通)、
  modify(deterministic改源/regenerate-module路由)、escalate(stage1→stage2+escalationEvents)、nreview(真LLM叙事审查+needsRepair计failCount)
- 布线:render→classify/modify、classify→design、scaffold→asset→build、play→player/nreview/repair/escalate/giveup、nreview→emit/repair/giveup、modify→build/generate、escalate→generate
- recursionLimitFor(maxRepairs,stage2Extra)=(m+s+1)*10+30,默认(5,3)=120;救场 5失败escalate→8失败giveup
- ALL_KEYS 字面量提升为 K_* 常量(单一源);新 SaaArchetypes §6.4 映射表契约;classify/narrative system prompt;saaStage2ExtraRepairs=3 旋钮
- 新 SaaStudioGraphTopologyTest(非门控:哑API build全图证无孤儿+Mermaid 16节点+recursionLimit+路由单测)
- 初始逻辑标 TODO(B4 救场真切stage2模型/giveup真dump/validate-build计failCount)、TODO(B7 modify深层指针/按id定位)
- additive:create-metric全链不破;§1.4硬约束(GamePackage/宿主/回调/九门harness)全未碰

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 17:33:15 +00:00
zizi
0f380a516b feat(contracts): 冻结 SAA state key 全表(ALL_KEYS +14)+ trace 扩展键 schema(§5.4/§5.8) 
契约冻结门收尾(§7.0 剩 2 项后端内部契约):
- SaaStudioNodes.ALL_KEYS +14 键(archetype/tickModel/inputModel/progressModel/sourceProject/
  assetSpec/modifyMode/modifyPatch/baseVersionId/failCount/modelTier/escalationEvents/
  giveupDumpPath/narrativeReviewVerdict),全 ReplaceStrategy;先冻命名空间,classify/asset/modify/
  救场 节点 B2 实现写入(additive,存量节点不读零影响)。
- DifyCallbackReqVO.trace(开放 Map)javadoc+@Schema 文档化固定架构扩展键:
  modelTier/escalationEvents/cacheHit/giveupDumpPath/cost;落值属 B5 impl,trace_json 字节兼容。

验证:本地结构校验绿(14键无重/无撞/引号成对/数组收尾);纯 additive(字符串数组追加+注释级)。
aigc 编译 + V18 Flyway-apply 的整合 mini-desktop 验证随后跑(清验证债)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 16:54:48 +00:00
zizi
ca72fce600 feat(contracts): V18 game_source_project Flyway 迁移(源项目工件表·改源不改产物源侧存储面) 
契约冻结增量:execution §5.2 源项目 DB 存储——独立 game_source_project 表(勿塞 game_version)。
两副本(studio 模块 + huijing-server 聚合,字节一致,如 V8 模式)。

字段:game_id/version_id/source_json/source_url/source_hash/schema_version/build_profile/
status(0草稿1已构建2孤儿3已发布)/base_version_id(modify 血缘)+ Yudao 审计列;
3 索引(idx_game/idx_version/idx_source_hash);头注铁律(回滚写 V18.0.1 不改本文件)。

验证:本地结构校验绿(16列/1主键/3索引/括号平衡/InnoDB+utf8mb4/审计列全);镜像已验证的 V8 studio 表约定。
⚠️ Flyway-apply-green 留批量 mini-desktop 部署(与 ALL_KEYS/trace 一并 recompile+migrate)验,本次暂未声称迁移已验。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 16:42:50 +00:00
zizi
15efff4dee docs(harness): 文档体系重构(止血最小集)——两层模型+机器可检蒸馏门 
全局 ~/.claude/CLAUDE.md(仓外)退役「每任务 dated review+execution 双档」→两层喂料(WHAT/HOW)+收口蒸馏,增量 deprecate(旧档兼容)。本仓:engineering-conventions §10.6(两层心法/判层/蒸馏门/留痕 frontmatter);wave-close 第5/8步机器可检蒸馏门;AGENTS §2 目标锚去双 roadmap 二义 + §3.3 两层前门索引(模块进度 SoT=总账§2 / 自动记忆界外 / memorys 判死)。

评审 CE 5 人格(coherence/feasibility/scope/product/design)压缩至止血最小集,砍两层新目录/新收口门/评审舰队正式替换。WHAT=docs/brainstorms/2026-06-17-文档体系重构-requirements.md;决策记忆 docs-system-hybrid-two-layer(仓外)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 16:33:21 +00:00