lili 882ca3f357 feat(cheap-gen): W-AXIS 波2 判定语义重置——独立模型玩法判定阻断+拆残笼+判定档切 M3
裁定三落地:accepted = 机械预筛 ∧ 独立模型玩法判定,九门 pass 降为「未见明显死」预筛。

- 波2a 玩法判定器(cheap_verify.py):读 brief+run-summary+全程截图(含新增局中连拍
  midplay-1..N,play.cdp.cjs 只读并发拍、不进任何门判据),布尔裁 broken/hollow/off_brief,
  fail-closed;判定真相层落 evidence/judge.json + verdict.json 写回 accepted/judge 段;
  金标夹具 fixtures/judge-golden/ + judge_golden.py 校准跑批
- 波2b 拆残笼:check 词法 tokenizer 替换 stripCode 正则(字符串内 // 假阴根修,292 在册
  源零差异);prompt v1.6.3 外科清洗(两层奖励→纯设计语/删盲驱动器围设计/删熔断恐吓),
  registry 热取==内置逐字节一致(cheap_roles 内置回退同步);edit_file 空白归一+近似片段提示
- 判定器补修:空输出有界重试一次(glm 思考吃光 max_tokens 时 content 空)+重试放大公式
  反缩 bug 修(旧 min(×2,6000) 大 base 反缩)+finishReason 落盘;imagesSeen 模型自报+
  盲检微扰重掷、两掷均盲=仪器故障 degraded(闲鱼中转静默丢图实锤,不再错杀 hollow)
- 判定档切 MiniMax-M3(创始人 2026-07-10 拍板,裁定三①边界随 v2 plan 修订):
  generation.yaml judge.model+max_tokens=202752(512K 网关实探 400 拒,取实探上限);
  3 例盲案 M3 重判全 accept、¥0.026/局
- 三路消费对齐:CLI 预筛语义修(cheap_studio 喂 verdict.pass 而非 finished,违裁定三的
  放行已纠)/Service 路 apply_gameplay_judge 显式 prefilter 参数/result_out 权威改读
  accepted(无键回落预筛,旧产物兼容)+trace.gameplayJudge additive 透传;
  tier2 gate_judge/genconfig 同步判定配置与消费

测试:test_gameplay_judge 33 项新增,全仓 pytest 480 绿;真判定闭环 accept ¥0.061。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 04:27:18 -07:00
..

game-runtime —— LittleJS 增强发行版(插件协议地基)

协议版本:core-protocol-v0(见 src/core/plugin.js 导出的 CORE_PROTOCOL_VERSION)。 ownerT1b-α lane-coreGate0 奠基)。配对 specdocs/agent-specs/2026-06-12-T1b-α插件库与参考件-execution.mdv1.1/ …W-T1b-Runner与双层模板-review.mdv2.1)。

平台维护一套「LittleJS 增强发行版」:每个插件 = 一项引擎能力(碰撞/粒子/物理/手感/调色/音频…),即插即用、可组合、版本化。 插件不含玩法、不含美术成品、不含关卡、不含 UI —— 这四者是 agent 造游戏时的生成域。 本仓只提供「能力编排 + 受控引擎句柄」,绝不内置任何玩法假设。


协议版本声明

当前协议版本 v02026-06-12 冻结,含 Gate0.1 受控面补丁)
标识来源 src/core/plugin.jsexport const CORE_PROTOCOL_VERSION = 'core-protocol-v0'schema/plugin-manifest.schema.json$id .../v0
冻结状态 Gate0 评审通过即冻结。Gate0.1 补丁(受控面由 4 扩 6+getInput/+getAudioContextrandom 改 per-plugin 派生流useContext 守卫)为向后兼容增量,随 v0 一并冻结,不 bump 版本号
升级规则 受控面只增不破坏既有 API破坏性变更须 bump 版本v0→v1并在本表登记

扩展受控面 / 改 manifest 字段 = 改协议,必须走 Gate0 后的扩展申请,不得 lane 私自加。 受控面 v0 最终成员冻结口径6 项)getContext2d / onFrame / getInput / getAudioContext / time / random


目录结构

game-runtime/
├── README.md                      # 本文件:目录 + 证据约定 + 协议版本声明位
├── src/
│   ├── core/                      # 协议核心core-protocol-v0已冻结对象
│   │   ├── plugin.js              #   Plugin 接口 / PluginRegistry 生命周期 / PluginContext 受控面(6 项) + host-dev 桩(含输入桥)
│   │   ├── api.d.ts               #   手写类型门面lane 读契约的一等入口,与 plugin.js JSDoc 同步)
│   │   └── plugin.test.mjs        #   核心零依赖单测31 测node --test
│   └── plugins/
│       └── _example/              # 空插件样例(五件全,可直接克隆为新插件)
│           ├── impl.js            #   ESM 实现(演示受控面用法,无玩法语义)
│           ├── api.d.ts           #   该插件类型门面
│           ├── manifest.json      #   插件机器契约(过 schema 校验)
│           ├── PLUGIN.md          #   给 agent 读的能力文档PLUGIN-TEMPLATE 活样板)
│           └── test/example.test.mjs  # 该插件零依赖单测7 测)
├── schema/
│   └── plugin-manifest.schema.json  # manifest.json 契约additionalProperties:false
├── docs/
│   └── PLUGIN-TEMPLATE.md          # PLUGIN.md 规格模板(六节固定骨架)
├── scripts/
│   ├── build.mjs                  # esbuild 锁参打包bundle+min+iife+es2019——⚠ 仅集成段跑
│   ├── size.mjs                   # 增量法字节测量zlib gz level9→ SIZES.md ——⚠️ 打包部分仅集成段
│   ├── validate-manifest.mjs      # 零依赖 manifest schema 校验(本机可跑)
│   └── test.sh                    # 遍历 core+全插件 node --test本机可跑
└── test/
    └── harness/
        └── browser-evidence.cjs   # 浏览器视觉证据 harness纯计算口径已实现 + CDP 占位,⚠️ 真跑仅集成段)

下列目录在对应阶段产生,本阶段尚未创建:src/plugins/<P1..P10>/(各 lane 插件)、games/(参考件)、host-dev/(本地挂载页)、dist/(集成段构建产物)、evidence/(集成段/参考件证据)、SIZES.md(集成段 size.mjs 产出)。


源码形态与运行纪律

  • 源码形态:发行版 = ESM JS + JSDoc 类型注释,公开能力面 = 手写 api.d.ts零工具链——lane 阶段 node --test 本地直跑,本机零 npm 依赖、不跑 git。
  • 本机可跑lane 阶段):
    • bash scripts/test.sh —— 跑 core + 全插件单测;
    • node scripts/validate-manifest.mjs —— 校验全部 manifest.json 合 schema
    • node scripts/size.mjs --selftest —— gz 量算口径自检。
  • 仅集成段mini-desktop(需 esbuild / 真 Chrome
    • node scripts/build.mjs <in> <out> —— 锁参打包;
    • node scripts/size.mjs —— 增量法实测 → SIZES.md
    • test/harness/browser-evidence.cjs 的 CDP 真跑(连 Chrome 抓 ImageData/截图。本机6c6g禁启 headless ChromeOOM 红线)。

证据与目录约定(沿 T1 结构)

阶段 证据落点 内容
每 lane <lane>/REPORT.md 实现说明 + 边界 + 红线声明
每 lane <lane>/test/RESULT.txt node --test 原始输出
每插件 <plugin>/PLUGIN.md 给 agent 读的能力文档(六节,见 docs/PLUGIN-TEMPLATE.md
集成段 SIZES.md + evidence/integration/ 构建日志 / 浏览器证据哈希 + 截图
参考件 evidence/round-N/ + LOOP-LOG.md + sha256-manifest.txt 四件套(输入轨迹/截图+canvas 哈希/probe JSONL/checklist+ serve 日志
  • 截图路径约定evidence/<bucket>/<name>.png(集成段 bucket=integration,参考件 bucket=round-N),由 browser-evidence.cjsscreenshotPath() 统一给出。
  • 哈希族:全发行版证据用 FNV-1a 32-bitImageData 哈希与 P10 RuntimeProbe 哈希链同口径)。
  • 字节预算:每插件 manifest.jsongzBudgetBytes,集成段 size.mjs 增量法实测对照;单件超配额→评审,合计>60K→创始人放行执行版 §5

给 lane 开工者的最短路径

  1. src/core/api.d.ts(协议类型契约,一等入口)+ src/core/plugin.js(实现与受控面注释)。
  2. 复制 src/plugins/_example/ 整目录 → 改名为你的插件 → 按 docs/PLUGIN-TEMPLATE.md 六节改写 PLUGIN.md → 改 manifest.jsonnode scripts/validate-manifest.mjs 必须过)。
  3. 实现 impl.js:只经 PluginContext 4 项受控面拿引擎能力,绝不直透 littlejsengine 裸对象
  4. test/*.test.mjs:零依赖 node:test,经 createHostDevContext 拿受控面 + tick 驱动帧vfx/audio 的渲染/发声证据留集成段 harness
  5. bash scripts/test.sh 全绿后,产 REPORT.md + test/RESULT.txt