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

67 Commits

Author SHA1 Message Date
lili
14c79dbfdd feat(studio): A11 切片三 M4 模块重生成执行(有界单文件 LLM 重写 game-logic.js) 
两段式第二段的 regenerate-module 类:改玩法 = 据 intent 有界重写 game-logic.js,不动其余。

复用机制(参数化、不复制 resume/熔断/收口):
- cheap_studio.run_studio 加 4 个默认 None 可选参(system_prompt/initial_kick/write_whitelist/prepare)
  切到 modify 态,create 路零行为变化(params=None 等价原逻辑)
- cheap_toolkit.build_toolkit 加 write_whitelist(非白名单 basename 写直接拒)
- cheap_roles.build_modify_system_prompt(复用 create 红线契约块)

cheap_modify.execute_regenerate_modify:
- 取 intent(空→failed)→ materialize base 源 → 重写前后对非目标文件算 hash
- 有界重写(写边界收窄到只 game-logic.js)→ 九门
- status=succeeded ⟺ 九门过 ∧ 非目标稳;manifest{file,kind:behavior,intent,changed,untouchedStable}(断言②地基)

worker_service._process_regenerate_job(regen_fn):把 M3 的 regenerate-module 显式 failed 占位换成真执行;
deterministic/create/生成路一字未动。

测试:test_a11_m4_regenerate 10/10(全注入桩零 LLM)+ 全回归独立复跑 73 测试全绿。
一次真 LLM smoke(单跑):intent=连击递增 → status=succeeded、untouchedStable=True、九门 pass、
attempts=1、¥0.31、137s;独立 diff 佐证 5 非目标文件字节相同、仅 game-logic.js 变。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 02:16:22 -07:00
lili
51230f1347 feat(studio): A11 切片三 M3 确定性类执行(零 LLM 改规范工程一处→重建→九门) 
两段式第二段的 deterministic 类:用户确认后的改动落到规范工程那一处,零 LLM。

cheap_modify.py:
- apply_deterministic_modify:config/level→core.js 等 L3 的 export const 值替换;
  asset→assets.js IMAGE_FILES 键值或 baseUrl;no-op 检测(无 found&&old≠new→ok=false,M5 断言①地基)
- materialize_source_project:系统级落盘全 files(含 L1,绕 write_file 的 L1 守卫)
- execute_deterministic_modify:apply→(缺 plumbing 才 scaffold)→materialize→cheap_run build/stage/smoke/play 九门

worker_service.py:
- process_job 最前 modify 分流(_process_modify_job);deterministic 走执行 + manifest 进 trace.modifyManifest
  + best-effort 带新版 sourceProject(链式改);regenerate-module 显式 failed 留 M4;create/生成路一字未动

测试:test_a11_m3_deterministic 18/18 + 回归全绿。
九门 smoke(独立复跑,本机 Chrome 免 LLM):amgen-bake-click-score-0 base 源 → ROUND_MS 30000→19000
→ status=succeeded、verdictPass=true、manifest found=true、落盘 core.js=19000、运行时 remainMs=19000
(改的那一处真在游戏里生效并过九门)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 01:49:10 -07:00
lili
938219d7a5 feat(studio): A11 切片三 M2 判意图入口 Java 侧(studio→aigc→worker) 
两段式第一段的后端承接:用户原话进系统、判意图、返建议供前端确认(确认后才调 /modify 执行)。

契约先行:
- studio.yaml 新增 POST /app-api/studio/modify/plan + StudioModifyPlanReqVO/RespVO

studio(应用面):
- AppStudioController.planModify;StudioServiceImpl.planModify =
  validateCreator 白名单门(与既有 createDraft/generate/modify 一致)+ 归属校验防越权
  + 委托 aigc classifyModify + 异常/空兜底 unclear

aigc(worker 对接):
- AigcApi.classifyModify + AigcModifyProposalDTO
- WorkerClassifyClient:据 baseVersionId 反查 base 源(同 injectBaseSourceProject seam)
  → NO_PROXY JDK HttpClient POST worker /classify → best-effort 兜底 unclear+needsConfirm
- AigcApiImpl 软注入 ObjectProvider<WorkerClassifyClient>(executor 关闭时缺席→兜底,
  绝不因 Bean 缺席启动失败,镜像 WorkerDispatchClient);worker URL 尾段 /generate→/classify

测试:StudioServiceImpl 31/31 + WorkerClassifyClient 10/10 + AigcApiImpl 2/2,
本地 maven 独立复跑 43/43 绿、BUILD SUCCESS,既有 modify/generate/SAA 回归零破坏。
真连 worker 的判意图 e2e 待 M5(mini-desktop)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 01:22:24 -07:00
lili
fc782db08b feat(studio): A11 切片三 M1 前置基座 + M2 worker 判意图 
M1 前置基座(便宜档源回传落库链 + base 源注入 + 血缘):
- derive_profile 兑现(便宜档基线 profile{realtime,discrete-choice,metric})解锁 sourceProject 回传
- worker parse_modify 提取 modify 区(mode/baseVersionId/modifyPatch/sourceProject)
- executor 据 baseVersionId 反查注入 base 源到 HTTP job(镜像 SaaGraphDispatcher.resolveBaseSourceProject)
- 回调落源回填 base_version_id 血缘(landSourceQuietly)

M2 worker 判意图(两段式第一段,NL→建议改动+风险):
- cheap_classify 把用户原话 + base 源可改面(assets.js 资产清单/core.js 集中数值/game-logic 玩法)
  判成 {category,mode,target,payload,riskLevel,needsConfirm,clarify}
- mode×category 锁定(LLM 给的 mode 不采信)+ 危险回问硬编进 needsConfirm(只低风险确定性改免确认)
- worker /classify 同步端点(不入生成队列、不起 Chrome)

测试:Python test_a11_m1 5/5 + test_a11_m2_classify 9/9 + 回归全绿;
Java 执行器/回调/源服务 + SAA 回归(本地 maven 独立复跑 46 + 子代理 98)全绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 01:04:55 -07:00
lili
bc1efb26d8 docs(tier2): 纠正 U5 退路层 —— win-balance 在 agent 层非工具层(创始人纠正) 
经济/数值平衡是 agent 玩法职责,基础工具层做静态模板/补骨架治不了(静态验证调不动动态平衡 +
每游戏数值会改、预制浪费)。真杠杆 = verdict 反馈质量(让 M3 像 spike 自调平衡)+ 模型能力(换档)。
撤回工具层加固 + 精确率测量(率随 agent 演进会变)。go/no-go=conditional,卡 agent 层、随其演进改善。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 21:05:22 -07:00
lili
55a213e722 docs(tier2): 切片二 U5 收敛环 go/no-go 结论 = conditional go(留观+针对性加固) 
真跑(M3-only,chrome 泄漏修后 iso 逐款):M3 写得出结构完整多系统富游戏(过大多数九门+三联动/latch),
但收敛 run-dependent(随机)、confounded pass 率 ~1-2/5;失败集中「进度/经济平衡门」
(H_progress + 经济门 profitPathWin)。退路 = win-balance 模板化/补骨架(非换档,M3 有能力)。
第二 confound(live worker:9501/@8200 争 4 核)未除,真率需暂停 live 干净跑测。
非 no-go(能过全门)、非干净 go(收敛太不稳)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 20:10:53 -07:00
lili
8d4654ab63 fix(tier2): serve-and-play chrome cleanup 杀整树(治泄漏)+ 切片二 U5 执行发现 
chrome 泄漏根因:cleanup() 只 kill $CHROME_PID(父)→ renderer/gpu 子进程 reparent 给 init 成孤儿、
跨款累积(实测 U5 Round1 撞 wall_timeout、杀批组仍残留)。修=cleanup 加 pkill -f "$USER_DATA_DIR"
杀本实例整棵 chrome 树(user-data-dir mktemp 唯一、不误伤别的 chrome/live worker)。

plan 执行发现:① env 闸缺口(fresh worktree 无 node_modules/esbuild → build 失败 → M3 假性不收敛,
已补 U1 S0 + Risks);② M3 已证能收敛(smoke 面包+水果 clean accept、九门全过);
③ U5 Round1 被 confound(chrome 泄漏 + live worker:9501/@8200 争 4 核)、需隔离干净重跑。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:54:17 -07:00
lili
4f444e0ca0 docs(tier2): 切片二 n=5 收敛环 go/no-go 细化执行 plan(Codex+Opus 双评审收口) 
plan① 切片二的可跑 runbook 细化:U1 前置阻断(复现 smoke+反向 smoke+DockerWorkspace 小验)/
U2 批级+跨轮护栏 fail-closed / U3 退路树 n=5 适配 / U4 play-scene 门结构化 / U5 跑环+go/no-go。
执行决策(创始人):串行+M3-only;n=5 绝不 n≥30。§6.8 双评审 19 项发现全核验、全文档内修。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 08:59:29 -07:00
lili
7f8a418cb5 docs(cheap-worker): M3 生产 cutover 完成 — Node/gamedef 退役 go-live、live 跑 Python M3 路(切片一 M3) 
live :48080 端口精确从 6-21 旧 gamedef jar 换成 6-28 M3 jar(dev/2.0.0)+ dispatcher=http→worker:9501 + trace.enabled;boot 日志「生成派发通道选定 dispatcher=http=WorkerDispatchClient」坐实 Node/gamedef 旧路在 live 退役。拆 iso :48090 避 live+iso 双 executor 同 DB split-brain。最终拓扑=live :48080(M3 路)+ worker :9501,同 DB。control-plane 6门放量创始人定后单独开。

M3 剩(非 cutover 工程缺口):≥80% 生产真实分布达标复验(质量轨 WU-B/C/F)+ 对外开闸放量(放行决策)+ publish→feed→玩家真玩(产品轨移交边界)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 04:46:09 -07:00
lili
16112827da docs(cheap-worker): M3b U6 收口 — 执行发现 + trace parity 蒸馏(切片一 M3b) 
plan close-out:U4/U5 mini-desktop 真后端 e2e —— D11 三值判别坐实(失败 gen 28 / 退化态 45 / 注入真 bundle 成功 100),9d trace 七项 + D9 similarity 真落库、engineBundle 落可发布预览包,live :48080 全程未动。边界:publish→feed→玩家真玩 属产品/审核台轨(auth + REVIEWING),非生成线 M3b。

.agents 蒸馏:gen-path-parity-harness skill 加「换 worker 别静默退化 D11/D9」段(必填七项 + gatespec.driver 键名坑 + H_progress 嵌套 + repairs=max(0,attempts-1);D11 退化判别双峰 45/55 + 逐维断言反假绿非看区间;import 边界 tier2≠wg1 故 trace 手写镜像 + dedup vendor;两路都落 trace;玩家试玩需 published)。README 索引同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 04:12:02 -07:00
lili
d00938ccbd feat(cheap-worker): M3b 本机 U1-U3 — 9d trace parity 救活 D11 + D9 vendored + 跨语言反假绿门(切片一 M3b) 
便宜档生成切到 cheap-worker 新路后,result_out 只产 trace.cost、缺 9d trace 七项,致后端 D11 ReadinessScorer 三维恒中性、退化成 45/55 双峰近恒定分,D9 反同质失效。

U1 cheap_studio 富化:build_trace_source + _furthest_stage,additive 捕获 verdictFull/driverType/models/stage。U2 result_out._build_trace:七项(repairs=max(0,attempts-1))+ sevenGateVerdict{pass,guards} + gatespec{driver} + cost + similarity,camelCase 镜像 _extract_trace、None 容错。U3 D9 dedup vendored 进 cheap-worker/dedup.py(registry 指自己 results/)、worker_service 接线非阻断。

Java 跨语言切片测加逐维反假绿门(反射调真 ReadinessScorer:三维脱离中性 + 合成分 100 vs 退化 ≤55 拉开 ≥35)。顺带修预存 M3a 红测:worker 异常兜底 failureReason 改传真枚举 llm_error。

验证:cheap-worker 全 16 测绿 + Java 切片 5/5 绿 BUILD SUCCESS。范围仅 cheap-worker/ + 2 fixture + 1 Java 测 + plan,零 live 触碰。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 02:17:41 -07:00
lili
847089b541 feat(m3a): 便宜档 Node 退役机制 U1-U4 本机交付（Python §6.1 worker + 后端路由契约/A2A/幂等） 
M3a 退役机制 plan 经 Codex+Opus 双评审(needs-rework)→ 按创始人 A(全局 dispatcher
flag 整体翻转、不做 per-request 灰度)重写 → Opus 复审 minor-fixes → 发现项全数修复。

U1 Python §6.1 HTTP worker(cheap-worker/worker_service.py + result_out.py):
  202 投递握手 + 有界串行队列(治串行 worker 忙 409 误判)+ 三字段 result-out
  (gameConfig 占位 / engineBundle 承重含 __GameBundle / sourceProject best-effort 2.0)
  + HMAC 回调。27 单测 + 真生成 e2e 过九门 + 真网络回调。

U2 跨语言契约 slice test(CheapWorkerResultOutContractTest):反射调真
  validateSucceededPayload 过薄校验 + 真 CallbackSignatureVerifier HMAC。

U3 A2A 状态(additive):AigcTaskStatusEnum.toA2aStatus + app VO/RPC DTO a2aStatus
  字段(保留数字 status 不破坏调用方)+ Convert/ApiImpl backfill + 契约 aigc.yaml。

U4 创作请求级幂等(行业标准 idempotency):DO idempotencyKey + Flyway V26
  (列+唯一索引,NULL 多值=不去重)+ Mapper selectByIdempotency + submitGenerate dedup。

真验证抓到并修 2 个真 bug:① worker 回调走系统代理被 fake-ip 拦 502 → 禁代理 opener;
② result-out 顶层 costRmb 不在 DifyCallbackReqVO 字段内、后端严格拒未知 → 落 trace.cost。

验证:Python 27 测 + Java 21 测全绿(mvn BUILD SUCCESS)。
剩余 U2 真派发 / U4 真 DB / U5 待 mini-desktop 真部署。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 21:18:28 -07:00
lili
afb0705078 docs: M2 完整收口 — WU-C 5.4 阻塞已修、Node 退役授权三条齐 authorized=True 
承 ffe3a5c9(单数 target 契约漂移修复):复验 auto-vs-golden 三品类全 aligned
(退化款 avg-click-score-14 auto 0.667→1.0)→ retire_authorization 三条齐
M1✓+002✓+auto-vs-golden✓ → authorized=True。便宜档具备把默认路由切到 Python
的全部条件(真接线 M3)。

M2 全程没放水:门诚实卡住生成缺陷、修后如实转绿,证伪评审「字段同质恒过无
鉴别力」预判。同步 M2 plan 收口结论/status + parity skill M2 实证。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 10:55:38 -07:00
lili
e963db3a34 docs: M2 收口 — auto-vs-golden 门抓到单数 target 契约漂移 + 蒸馏(WU-C 5.4 阻塞) 
M2 机制全交付(U1-U3 门 + R5 灰度设计、全套件 106 测绿)。full 批 n=5:
whack-mole/shop-serve aligned、click-score regressed(E_live/G_input auto 0.8<
golden 1.0,3 次复跑确定性复现)。retire_authorization 三条:M1✓+002✓+
auto-vs-golden✗ → authorized=False。

根因(systematic-debugging 定位)= 生成契约漂移:~20% click-score 款 forensics
暴露单数 target(对象)而非复数 targets(数组),_build_play_spec 推断漏判→误推
key-cycle + tap-targets 驱动器 targetsPath 找不到。门正确履职(证伪评审「恒过」
预测)、退役授权诚实卡住。创始人定:收口 M2 机制 + 登记 WU-C 5.4 阻塞(修后转绿)。

蒸馏:auto-vs-golden 同款双驱动 delta 门范式 + 单数 target 契约漂移实证 →
gen-path-parity-harness.md;M2 收口结论 + WU-C 5.4 阻塞 → M2 plan。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 09:42:13 -07:00
lili
3ec36037b6 docs(plans): 便宜档 M2 上线就绪细化 plan — auto-vs-golden 门 + Node 退役授权(过双评审) 
主线切片一第二里程碑 M2 细化 plan(承 M1 003 收口)。创始人 2026-06-27 定范围
=聚焦本机可执行的 auto-vs-golden delta 门;灰度切换基础设施只出设计、真接线随
M3。三单元:U1 逐门 delta 判据(关键门容差 0/其余 1/N + double-low 守卫)、
U2 同游戏双驱动 play(同款产物自动 spec vs 金标 spec 各 play 一次、隔离生成方差)、
U3 三条齐退役授权判定(读 M1 达标 + 002 等价 + auto-vs-golden)+ R5 灰度设计。

双评审(§6.8):Opus 对抗评审权威,1 MAJOR + 6 MINOR 全在档内修;Codex 实跑
但读完 plan① 后停半途未产汇总(回落 Opus 单评),其方向性发现已纳入。创始人定
门定性=建全门 + 诚实降权:门方向按 plan① 单边查「自动不比金标驱得差」(非查更松),
覆盖面内鉴别力诚实降为「不退化确认」、退役实质支撑=M1+002。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 08:24:26 -07:00
lili
f0355f98ef docs(M1-plan): 便宜档 M1 达标门绿细化 plan — 双评审定稿 
切片一第一里程碑细化(4 实现单元:护栏 / 自动 spec / 达标门 / 预算闸)。
过 Codex + Opus 双评审(均判修后可执行)+ 创始人三项口径已定:
- U2 防自证假绿:expectedEngineCallPrefixes 取预置品类映射表作 held 期望、非从实际反推(否则 F_wiring 退化自证必过)
- M1 收口钉死 = M3 20 款实测、tap-targets 三品类逐品类 pass_count/total≥0.8;小批=联调非收口替代
- R5/U3/R3 串行→前台进程内有界并发(conc≤15,对齐 002 run_multi);U3 补 U4 偏序
- U2 同质数值化(逐门全等 / delta=0 / 关键门不低于金标);落点校正(middleware 类 172 / cost.py 路径前缀 / fetch_pricing_params 107)
- 创始人定:覆盖面只 tap-targets 三品类 / 横比延后 / 取价沿用既有降级

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 23:07:22 -07:00
lili
618eca14d4 docs(gen-plan): Codex 四维度专项评审 10 项修复 + 蒸馏两坑 
Codex 末轮重连完整产出,双评审真正凑齐。修复:
- §7 切片三补进 WU-C/WU-F 对账(对账漏面);WU-D 补第二批协议 ADR-1/2/5 接收方
- 切片二 n=5 钉死追加轮数上限(≤3 轮 / 累计 n≤20);切片三 A11 补三条结构断言完成判据(改动生效/非目标模块 diff 稳定/baseVersionId 血缘)
- M2 同等过门率补 delta 阈值口径;基建线三项补最小验收判据
- §5 依赖图排队顺序改虚线、硬前置改实线+图例(防误读成阻塞依赖)
- M3 限定生成线端到端+非生成模块归 16 周主计划;§6 补生成线 P0 承接子集
- skill execution-plan-slicing 补第六/七坑(判据未钉阈值 / 依赖图把排队画成依赖)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 22:27:11 -07:00
lili
d9786950d6 docs(gen-plan): Opus 四维度评审修复 — 达标按品类/§7 八面对账/切片三完成判据 
四维度(任务顺序/目标一致性/任务边界/可验证完成)专项评审,Opus 全过无必修,9 处建议/可选已修;Codex 三次占位+连接中断,按 §8 回落 Opus 单评。

关键修订:① M1 ≥80% 改"按品类判、核心品类全覆盖"防达标假绿(对齐 002);② §7 WU-C 5.5 能力面主体归切片二、注册子项留基建线、补 5.3,八面对账闭合;③ 切片三补显式完成判据(两档落地+过九门+接 A2A/D12 跑通一次受计费调整);④ M3 补后端 studio 移交边界 + 生产分布达标复验;⑤ 切片二结构化门标可并行;⑥ §7 WU-F 下钻补 §5.2/§5.7;⑦ §11 TODO 补 A11 设计面缺口。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 22:02:53 -07:00
lili
f0e5638c9a docs(gen-plan): 补回切片一迁移安全契约 + 立"执行契约必须留"换轴判据 
创始人 catch 换轴丢细节:核出被压缩的 WU 内容分两类——设计 HOW(八面/三档矩阵/A2A·cancel·幂等协议/6 ADR)归位设计 SoT 无碍(§7 对账可下钻),但 WU-A 便宜档灰度迁移契约 11 项(链路/灰度 flag/对照/幂等/在途/切换门槛/回滚)是执行契约、被误当设计细节压掉,补回切片一。

skills/execution-plan-slicing.md 立第五坑 + "设计 HOW 移交设计 SoT / 执行契约必须留切片"的判据;README 同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 21:17:31 -07:00
lili
de496321c6 docs(gen-plan): plan① 换轴重构为纵切执行序列 SoT + 蒸馏切分轴 skill 
把生成引擎统一执行计划从关注面横切(WU-A..F)重构为成果纵切三切片(便宜档达标上线 / tier2 go/no-go / A11 调整回路)+ 基建线 + 已冻协议基线,WU-A..F 降为 §7 设计面对账。补上执行序列 SoT 这一缺失的中间层(夹在设计 SoT 与切片细化 plan 之间)。canonical 唯一性门:原地重构、文件名保留、旧主轴降对账。

过 Codex + Opus 双评审,必修项已修:假前置门(A1-A13 定级设计 SoT 已冻、非待拍)/ 散文元叙述 / 切片三对切片一真依赖(A2A·D12)/ §7 对账补全八面 / 插件数 11→12 / base 编号去掉。

蒸馏:新增 skills/execution-plan-slicing.md(横切 vs 纵切判据 + 换轴动作 + canonical 唯一性门 + 四坑),README 索引同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 18:13:09 -07:00
lili
e73eed6585 docs(plans): WU-A 框架收敛剩余 — 便宜档 Python 路 tap-targets 三品类对照验证 
WU-A 自有剩余工作收敛为「对照验证」一件:三个 tap-targets 代表品类
(点击得分/打地鼠/经营点客)Python↔Node 同输入对照,用每品类金标
play-spec 喂两路、把驱动器摘出对照变量,产「Python≈Node、范式未回退」
的框架等价证据(R1 头号风险头道缓解闸)。

范围按 plan① 的 WU 分解钉死:生成质量归 WU-B/C/F、生产自验 play-spec
与驱动器加固归 WU-C 5.4、灰度基础设施归 WU-F,均不在本计划。key-cycle
两品类(2048/躲避)公平对照需输入键契约,延到 WU-C/生成侧就位再做。
零跨档(全在 cheap-worker/)。

过 Codex+Opus 双评审(§8):base1 归 occupied 反应族(非放置族)、金标
spec 注入 staged play-spec.json(非 evidence)、判据加逐品类绝对地板、
退役授权 gate 在生产自动 spec 达金标同等(auto-vs-golden delta)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-26 10:38:17 -07:00
lili
675a8e688b feat(cheap-worker): 便宜档 Node→Python 重写进 AgentScope spike — 范式可移植坐实 
WU-A 迁移面 spike:便宜档生成核心(多轮 ReAct + 五工具沙箱 + done 门)用 Python 在新建 cheap-worker/
重写成 AgentScope agent,import 复用 tier2 框架层(model client/四道熔断/历史压缩/observability),
check/build/九门 shell-out 现有 node/cjs(不重写 esbuild/CDP/形状门)。

- U1 地基:跨包 sys.path import tier2 worker + 代理旁路 + key 从内网文档注入 env + M3 装配
- U2 五工具:read/list/write Python 实现 + check/build shell-out(形状门三态与 Node 一致)
- U3 LittleJS system prompt:prompt.mjs Python 化(两条 footgun 正反例 + 输入契约)
- U4 scaffold/stage/play 薄壳 + ensure_play_spec(据 state 形态产 play-spec 治链路假绿)
- U5 ReAct 主编排:内置 Agent+ReActConfig+外层有界 resume + done 门 + 收口 stage/smoke/九门
- U6 对照 Node:产物形态 + 九门逐门 + 过门率对比

验收:同 brief Python 新路 vs Node 旧路,产物都真 src/ 6 文件、九门都 9/9 全 PASS、过门率 1.0=1.0
→ spikePass=True。端到端单局 attempt 1 一次收敛、148s。落点 cheap-worker/ 对 tier2/amodel-gen
零改动(结构性零回归)。测试 38/38 全绿。

origin: docs/plans/2026-06-26-001-feat-cheap-worker-python-spike-plan.md

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-26 02:42:14 -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
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
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
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
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
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
zizi
456653cbe1 docs(design): 接口协议 plan opus 终审整改(无 P0)——行号 696→692 / 成本血统钉 new-api / verdict 硬前置与 Q2 口径统一 / readState per-品类层 / §7 补 Q14(A4.5)/ 去元叙述 
opus 子代理对抗终审判'无 P0、可合',逐条整改其 P1/P2:
- P1-1: _bash.py 行号 696→692(实锤;§4 行号读的就是本机 v2.0.2 tag、准确,不软化)
- P1-3: A2.5 成本归集留 §7 Q6 定 + 成本权威钉 new-api 计费行(trace 只携关联键、agent 自报金额不作账)
- P1-2: §7 补 Q14(A4.5 构建产物+feed→play 入口 提独立A类 vs 字段待spike)
- P2-1: A6 readState 劈引擎级(per-engine)vs 语义 state(per-品类·接 A10)
- P2-2: §6 verdict 硬前置=纪律(机器判禁自评焊契约层),结构选择归 §7 Q2,消两处口吻冲突
- P2-3: 去元叙述(诚实说在前面/必须纠正)
状态置 opus 终审通过、作设计基线合入。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:40:26 +00:00
zizi
1a36a7279e docs(design): 接口协议草案 agentscope 2.0.3→2.0.2 + 克隆路径订正 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:31:42 +00:00
zizi
f1ca3b792f Merge dev/2.0.0: agentscope 2.0.2 版本订正入设计分支 2026-06-23 18:31:41 +00:00
zizi
d8adc3d0d4 chore(tier2): agentscope 版本号 2.0.3→2.0.2(2.0.3 未发布·PyPI 最新=2.0.2) 
2.0.3 从未发布到 PyPI(最新 2.0.2),requirements.txt 的 ==2.0.3 不可安装。已在 mini-desktop venv 实装 2.0.2 并冒烟:Agent/ReActConfig/Toolkit/FunctionTool/Anthropic*/MCP(Stdio+Http)/create_app(Agent Service)/AgentState/workspace/middleware/event/skill 全在——设计依赖符号对 2.0.2 成立。
活层(docs/tier2/.agents)agentscope 2.0.3→2.0.2:文档+SVG+requirements.txt+knowledge facts(改名 agentscope-2.0.2-facts.md);npm lockfile 第三方 2.0.3 未动。复验 SVG 32 张全过。
注:6c6g 克隆 /root/oss/agentscope 实为 2.0.3-dev(领先 PyPI),与 2.0.2 架构一致(符号已对)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:29:06 +00:00
zizi
01771b7437 docs(design): 接口协议层与可插拔模块草案——固定契约 vs 可换实现(两轮 workflow + 对抗评审 + 主会话纠漂移) 
回答'换引擎/框架=接适配器、哪些写死、哪些 skill/mcp、探针能否是 skill、多语言'。两轮 workflow(11 子代理)+ 源码核实 + 对抗评审:
- 第一轮 生成/引擎/框架内核:A1-A7(+补 A2.5 trace/A3.5 版本寻址/A4.5 构建+feed入口)+ B-ENG/PROBE/FRAMEWORK;§4 AgentScope 机制实证(MCP=多语言支柱·2.0.3 无 register_tool_function 纠偏)+§5 现状 7 耦合接缝
- 第二轮 平台级面:A8-A13(送审/资产/玩法模板/试玩HITL/通用检查门/配置)+平台级 B(资产源/品类模板/渠道提审/配置注册表)
- 对抗评审揪正'想要≠已是':verdict 锁死 Tier0/1 须 fork+焊纪律、dispatcher 仅 dispatch()无 cancel、trace/GenerationState/配置注册表 contracts/零命中=反锁死真 GAP
- 主会话复验补:A4 projectType→engineBundle 装载分流漂移纠正、A8-A13 tier2 段标 v1 directional

草案·待 Codex+Opus 双评审 + 创始人定(§7 共 13 个开放问题)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 17:49:06 +00:00
zizi
ccb00bb9f2 docs(tier2): 接住 A-model 分支(Tier1 agentic 优化)——前提对齐+可复用资产+协调 
feat/mac-amodel-foundation 让廉价线也 agentic 化(ReAct+M3+插件库+九门,仍 LittleJS),部分推翻 tier2「廉价线=声明式壳天花板」前提。创始人 2026-06-23 裁:维持 tier2、两线分立(A-model=LittleJS 轻量经营 / tier2=Phaser 重表现富游戏),边界从「能力档」精确为「引擎/复杂度档」。计划新增「与 A-model 分支的关系」节集中承载:① 插件契约(scene-fsm/hud-ui/session-score/timer-scheduler 引擎无关零语义+sim-business 配方)复用→U6/能力包(最大协同,原漏接);② amodel-gen 循环范式参照→U2/U7;③ play.cdp.cjs 基线(SAA-mode+driven 感知 advisory 分级)刷新→U3/U6;④ 源项目契约维持独立+溯源→KTD7/U9;⑤ L1/L2/L3 术语消歧。brainstorm+plan Problem Frame 前提措辞对齐;HANDOFF 补 A-model 协调。子代理(opus)分析实证。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 05:51:52 +00:00
zizi
cf0695abd3 docs(plan): tier2 实现方案双审定稿——Codex 挂回落 Opus + R/U 漂移修正 
Codex 评审做完分析但终评迟迟未落盘=实质挂起,按铁律 Codex 挂回落 Opus 单评;提取 Codex 已暴露信号(R 编号/U 单元映射漂移)自核——修 U8 错误引用 R1(R1=pre-spike 不上 service,U8=B 门后上 service 即 R1 deferred 部分,非新需求)。Opus 3 P0 已于 a1539e9e 整改。双审定稿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:48:22 +00:00
zizi
a1539e9eb8 docs(plan): tier2 富游戏自治生成线实现方案(ce-plan)+Opus 评审整改 
ce-plan 产出 HOW 计划:Deep·10 单元(Phase A 详 7 到 A/B 证据门 / Phase B 纲要 3·B 门后投)。纳入 Opus 源码级对抗评审 3 P0:① U2 重定性——种子 validate/run/roles/prompt 是 LittleJS 专属、对 Phaser 完全反转、需重写≈net-new(非 fork+钉版本);② M3 成本取证补 RecordingChatModel(AnthropicChatModel) 变体(原只覆盖 OpenAI 路、A/B 门经济性断链);③ M3 thinking 下结构化 finish 降级、补 spike-grade 最小产物收尾(原误 gated 到 Phase B)。+ 环境切分逐单元(6c6g 骨架/Mac·mini-desktop 真跑)+ A 门两段与(先过 L1 再试玩)+ 闭环端到端独立验收门 + client_reuse 复用面纠偏(参数化 BASE_URL/key+NO_PROXY 副作用非包 chat)。Codex 评审后台跑中,delta 待并。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:39:37 +00:00
zizi
c9db9f7d36 docs(agent-specs): 域化重构收尾(保守批)——归档18档+清引用+_index瘦身 
确立 docs/architecture 为设计/现状唯一真源,agent-specs 仅留正在演进的设计。
回灌核对(review §2.4)后将 18 份「已迁入 architecture 或纯留痕」的设计/过程档
git mv 进 _archive(各带 SUPERSEDED tombstone 指新落点);生成域在飞设计链
(架构演进路线/生命周期范式/多session总账/任务普查)+ 3 待定档暂留,待二次收尾。

- 归档 18 档:SAA编排/引擎运行时/验收门/prompt治理(settled 底座,内容在子树)
  + WG1/设计裁决/OpenGame/开闸接线/固定架构review/传承演进/并行编排(已迁子树)
  + 完成度总账(FOLD 进需求模块映射)+ SAA-dossier残留 + 根因复盘/目录治理/
  深度重构plan/文档整理plan/planB-closeout(纯留痕)
- 清 7 处死引用:5 处 .agents/plans 旧 agent-specs 路径→新树 + 2 处 architecture
  树内回链(开闸接线/观测体系→验收门新树路径)
- 修 7 处归档连带死链(指已归档档→新树现行档 或 _archive 留痕)
- _index 补 2026-06-22 收尾 banner + 6 处指针改新树/_archive
- 死链门 check-deadlinks.sh = 0;收尾清单 docs/plans/2026-06-22-域化重构收尾清单.md

待二次收尾(创始人选保守暂留):总体架构-review/固定架构-execution/产品开发路线图
(architecture 仍当其权威源回链,需先补迁详义)+ 对话素材v1(留痕,牵连保留档链接)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:18:31 +00:00
zizi
b52afc5ea2 docs(arch-atlas): 按领域拆成 00-07 编号文档(全放顶层)——创始人反馈全量主档太大 
结构经三次反馈收敛终态:导览式多文件(跨子目录不渲染)→ 合并一篇(太大 1721 行)→
拆 8 篇编号文档都放 docs/architecture 顶层:
- 00-系统总览图说.md = 总图(7 系统级图)+ 目录(链 01-07)+ 通用图例 + 按角色路径
- 01-产品…07-运维图说.md = 每域一篇,各含该域全部图 + 讲解(散文逐字保留)
顶层文档引子目录 assets(运维/assets/xx.svg)单向下引、全图真渲染;SVG/各域README不动。
复验:8 篇共 35 图嵌入零缺失、36 Mermaid 配平、00 链 7 域有效。
配方/记忆/计划/README索引同步终态(铁律:图集文档放顶层引子目录assets,别让子目录文档跨引另一子目录图)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:33:46 +00:00
zizi
28e70d7d7b docs(arch-atlas): 收口单一全量主档——删冗余导览式apex+7域图说 
创始人裁定'删冗余只留全量主档':
- 删 系统全景图说.md(导览式apex)+ 7 域图说(产品/架构/沙箱/后端/前端/运营/运维),内容已全部 inline 进 系统全图说.md;SVG 与各域 README 保留不动。
- 系统全图说.md 防漂移门改指真实设计档(6域README + 13模块/契约总览/产物执行沙箱/数据模型/鉴权/观测/k8s/生成引擎README)的 commit hash,非已删的中间图说;每图具体映射见图脚注。
- 顶层 README 加'看图入口'指向全量主档;.agents/skills 配方 + plan 同步为'单一全量主档'口径(多文件跨子目录不渲染→合并一篇引子目录assets)。
复核:35 图嵌入零缺失、36 Mermaid 完好、目录锚零断链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:07:50 +00:00
zizi
3c008fb847 docs(plan): 架构图集 v2 确认稿——全域目录+图清单+每图讲什么(纳 Codex+Opus 双评审整改) 
六域生命周期结构上增量铺图集:总图叙(导览式)+ 六域各一份图说 + 生成引擎子树(提案待与在飞 session 对齐)。
混合形式(复杂 SVG + 简单 Mermaid)、house style 沿用金样板、逐图标状态、单源引用防漂移。
~140 图位(~110 新作 + ~30 单源引用)。分两期:先六域、后生成引擎子树。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 11:05:56 +00:00
lili
f4c6789312 docs(saa): 蒸馏 M3 thinking 治理/协议/流式 + rc 门修(91.7% 跃迁) → .agents 技能 + 决策档 
§7 知识沉淀（仓库权威版，配套代码提交 4e5a7bbf）：

- .agents/skills/saa-graph-orchestration.md：新增 §3.5「M3 thinking 治理 + 协议/流式」——M3 thinking 二元(无深度/budget、提示词压不住)；openai adaptive 内联污染→只能关；anthropic 原生分离要质量走这条但必配【流式 StreamingCallChatModel + NO_PROXY webClientBuilder】否则阻塞整取大面积 SocketTimeout；#4407 对 1.1.2 过时；rc 门耦合 bug(playNode pass 别前置 rc==0)。e2e 段补 2026-06-20 跃迁(67%→91.7%、证伪模型天花板)。
- docs/plans/2026-06-20-…md：状态 banner→主线达成 + 追加 §7 结果与修正(rc 真根因 / thinking+协议杠杆 / 实测对照 / n=12 达标口径放宽 / 未尽项)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 11:38:59 -07:00
lili
def1f4244a docs(plan): Plan A 记 T-FUTURE-1 thinking 历史出站丢失(创始人指示:记录+未来解决) 
stock spring-ai-anthropic 1.1.2 出站 buildMessages 丢 thinking 块→interleaved 保留不可达;U2 已简化 text 历史。
未来真解候选:① 自拼 AnthropicMessage 绕过 buildMessages ② 升 spring-ai 库版本 ③ 评估 interleaved 对生成质量真实增益。
触发:U5 收敛若证 thinking interleaved 是达 ≥80% 的关键杠杆则立项。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-19 08:16:07 -07:00
lili
1590f39666 docs(plan): Plan A 实测纠偏 + 机器分工放宽 + 网关治本 + Plan B U1 基底对齐 
- U1 协议/Approach/Files 实测定死(host 根 baseUrl 非 /anthropic、x-api-key 非 Bearer、Proxy.NO_PROXY、多 Gen 取答案靠 signature 键);必修三险①/R-1 标已解
- 机器分工(创始人放宽 2026-06-19):Mac 主力批量验证/收敛量测(能重载不休眠),mini-desktop 只出 final evidence
- 网关对 M3 原生 thinking 曾 ~50% 非确定性 → 创始人网关侧治本 → 稳定原生
- P0-2(单一 budget 撞小角色)→ per-role 自适应;P0-2 资产盲注脚软化(Plan B U1 db14845d asset-orphan 闭合)
- KTD8 运行时钉 = Plan B U1(db14845d)/dev 81c1b2cf

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-19 06:18:55 -07:00
lili
b6cadd8394 docs(plan): plan003 Plan A gen-done 执行计划（用对 M3→≥80%→两步 flip） 
Plan A = gen-done 生死门 = 003-U1(用对 agentic M3) + 003-U2(两步 flip)。
已过双评审(Opus 对抗式+可行性,代码核证)整改 5 P0 + 7 P1：
- Anthropic 多 Generation 响应形(block0=thinking,须遍历 getResults)
- checkpoint 序列化潜伏坑(e2e harness checkpoint-off 隐藏,staging 才炸)
- 独立性纠偏(量测执行 Plan B gd-runtime/build-from-source → KTD8 运行时钉)
- ≥80% 机制门口径(对资产质量盲)+ 并发共享面审计 + measure-first U-C 闸控
对齐 Plan B U1(db14845d,asset-orphan 已闭合)为收敛运行时基底。
Codex(codex-rescue) 未出可用评审 → §6.8 Opus 单评回退。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-19 03:04:23 -07:00
lili
0518d24592 docs(plan): plan003 Plan B — Phase-1 core-done 验收闭环执行（双线拆分） 
ce-plan 据 2026-06-19 验收闭环需求档产出 Plan B(core-done):引擎资产渲染(原003-U5)+
验收 harness(核心纵切e2e/广度抽检/8页走查/smoke)+ 双里程碑收口。
依赖排序:Phase1 六单元全独立(执行期可并行 fan-out)、Phase2 gated on gen-done(Plan A ≥80%产出)、Phase3 最终收口。
gd-runtime 整面归本档(解 U5↔U1 共面冲突,Plan A 走 DESIGN_SYSTEM)。gen-done(U1/U2)=Plan A 另 session。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-19 00:45:00 -07:00
zizi
f7f1262b05 docs(plan): 生成质量 v3 战略转向——用对 agentic 的 M3 提主路(Anthropic协议+thinking/历史保留+工具循环) 
- 根因分析档 v3 重写:整合二轮双评审 P0(n=5 非 13 / M3 论点降工作假设 / 点击消除 H 归上下文非门测错 / a3 救场回传未做 / best-of-N 整图串行) + M3 双协议实测探针 + 官方 Interleaved Thinking 文档
- 最深根因=用法错:M3 是 agentic SOTA 却被当一次性 JSON 填空机用 + thinking 剥离 + 历史不留;QC thinking:disabled 是错补丁(该分离+保留)
- 003-U1 杠杆重排:① 用对 M3(U-A Anthropic /v1/messages + U-B 完整 response/thinking 入历史 + U-C agentic 工具循环=接法B 提主路)② 测量/门修(不改 H 门本体)③ 上下文 8/8 driver ④ best-of-N 次要;加第 0 步真基线门(n≥30 + 证伪实验)
- 退路分支/R2/已拍板 #2:ReAct 从 P2 contingency 提为 M3 主路;升强档/Claude premium=退路
- M3 身份确认:真 MiniMax agentic 双协议模型(非 Claude 改名),探针 /v1/messages 返原生 ['thinking','text'] 块

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