lili 405394d451 feat(wg1-gen): gate-H 推广 = design agent 自产 gate-spec + reframe 决策锁定
P1(gate-H 推广多游戏):确定性门从手写 brief 升级为 design agent 自产,适用任意游戏。
- roles.py:DESIGN_SYSTEM 末尾产机器可读 gatespec 块(exportState/driver/controlCheck/
  assertAfterPlay/expectLatch);ballPath 明确为水平 x。
- studio.py:_extract_gatespec 抽取(json_repair 兜)+ 合入 play_spec + 安全归一
  (paddle-intercept 的 ballPath .y→.x 兜底);结果记 gatespec。
- 实证:flash design agent 对 breakout 产出结构合法 gate-spec,studio 抽取合入成功
  (唯一内容误差 ball.y 已由 prompt + 归一双修)。

reframe 锁定(WG1 review §8,创始人亲玩校准后):确定性 gate-H = 可玩性真值/地板;
player = 主观层(消费 gate-H、判不出手感、须人锚校准);创始人/人锚不可替代;
生产三层 = 确定性门 + 便宜 player + 创始人抽检(无 Claude)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 05:16:04 -07:00
..

wg1/gen-worker —— W-G1 L1 生成 worker(便宜模型 → 可真玩轻游戏)

结论看 REPORT.md(durable)。本文件 = 如何跑。 验证 HJ-GEN-001:便宜模型(new-api)在插件库+装载契约上写出可真玩轻游戏,质量由 harness 七门保证。

它做什么

brief(题面)→ 便宜模型写 GameHostFactory 源码 → 静态校验门 → esbuild 打 __GameBundle iife → P1 宿主 bootGameHost 装载 → 本机 Chrome+CDP 真玩七门取证,失败回喂错因重试 ≤N。"能生成代码 ≠ 能玩"——必须过真玩门才算 pass。

目录

wg1/gen-worker/
├── REPORT.md            # 交付报告(结论/四件套/成本/坑/最优模型)
├── requirements.txt     # openai==2.41.1 + json-repair
├── .env                 # NEWAPI_KEY 等(gitignored,绝不入库)
├── worker/
│   ├── _client.py       # 裸 openai 客户端 + 代理旁路 + usage(复用 spike 范式)
│   ├── prompt.py        # 生成上下文包(契约/能力面/禁用项/few-shot)→ system+user
│   ├── validate.py      # 校验门:抽码 + 静态契约扫描 + node --check 语法
│   ├── cost.py          # ¥ 折算(new-api quota 口径,/api/pricing+/api/status)
│   └── run.py           # 编排(§3 job-in/result-out + 重试门)
├── briefs/              # pong.json / simon.json / whack.json(题面 + CDP play-spec)
└── results/             # 每 run 结果(pass/retries/verdict 七门/tokens)
# 生成游戏产物在 game-runtime/games/_wg1-gen/<game>/(见该目录 .agent,解释为何落那)

前置(本机一次)

# 1) 密钥(gitignored,走环境):编辑 wg1/gen-worker/.env 写 NEWAPI_KEY(向创始人要)
# 2) game-runtime 工具链(esbuild + ws,CDP 驱动用)
npm i --prefix game-runtime
# 3) worker venv
uv venv wg1/gen-worker/.venv --python 3.12
uv pip install -p wg1/gen-worker/.venv/bin/python -r wg1/gen-worker/requirements.txt
# 4) 自测连通(列模型,零成本)
wg1/gen-worker/.venv/bin/python wg1/gen-worker/worker/_client.py

依赖本机 macOS + Google Chrome(headless)+ Tailscale 可达 new-api 网关 100.64.0.8:3000。

跑

# 生成 + 真玩一款(默认 deepseek-v4-flash;--model 换模型;--max-retries N)
wg1/gen-worker/.venv/bin/python wg1/gen-worker/worker/run.py pong
wg1/gen-worker/.venv/bin/python wg1/gen-worker/worker/run.py simon  --model deepseek-v4-pro
wg1/gen-worker/.venv/bin/python wg1/gen-worker/worker/run.py whack
# 成本表(聚合 results/*.json)
wg1/gen-worker/.venv/bin/python wg1/gen-worker/worker/cost.py
# 仅重放某款已生成 bundle(不重新生成,调试 harness 用)
( cd game-runtime && bash games/_wg1-gen/_shared/serve-and-play.sh pong )

新游戏:在 briefs/<id>.json 写 {title, brief, play_spec:{inputs,expectedEngineCallPrefixes}},再 run.py <id>。

七门真玩判据(全过才 PASS,详见 REPORT §2)

A 装载 · B 未捕获 · C 掌帧[20,45] · D 真渲染 · E 活性 · F 真接线(__engineCalls) · G 输入有效(确定性 A/B 对照)。 verdict 落 game-runtime/games/_wg1-gen/<game>/evidence/verdict.json + 首帧/玩后截图。

边界

  • 只消费冻结契约(game-host.d.ts / boot-game-host.js / __GameBundle / bootGameHost),零修改。
  • 不推 dev/2.0.0;只在 lane 分支 wg1/gen-worker。
  • 不做(创始人并行 P3/mainline):AigcGenerateExecutor 接线、白名单注册、全 20 游戏 bake-off、judge 评分。