docs(t1b-beta): Phase A 引擎真接线收口入账+harness §6 蒸馏
总账加 T1b-β Phase A 行(A0 掌帧+A1-A4 包装+A6 真引擎门 6/6,对账 11c8eaf→3e5cab4)+表头日期; game-e2e-cdp-harness.md §6 增补门②(runtime call-ID)四坑:rec→__engineCalls 探针形制/引擎渲出色=spec 非旧 sim 青蓝口径(像素门换 maxCh)/音频合成需 unlockAudio/scratch 部署禁裸 ./rsync 吞 monorepo。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
3e5cab455c
commit
db9b7b623e
@ -38,3 +38,12 @@
|
||||
4. **掌帧断言=帧增量区间,非 `>0`**:`time=frame++/frameRate` 是引擎定义式恒等,`>0`/`t1>t0` 可被「只 update 一次的假桩」骗过;真掌帧证据=500ms 内 frame 增量落 `[20,45]`(@60fps 理论 ~30),带上下界排单步假推进+失控空转。
|
||||
5. **dev 构建引擎自带污染源(只读源码才发现)**:littlejsengine 开发包默认 `debugWatermark=true`(每帧画非确定 averageFPS 进 mainContext 右上角,毁 readback 复现)→ 取证前必 `setDebugWatermark(false)`;`canvasClearColor` 默认 `CLEAR_BLACK` alpha=**0**(透明不铺底,非不透明黑)→ 须 `setCanvasClearColor(BLACK)`。prod min 包默 false,dev 包必显式调。WebGL 取证嫌麻烦可 `setGLEnable(false)`(须 engineInit 前)走纯 2D mainContext readback,避 preserveDrawingBuffer 坑。
|
||||
6. **引擎一 RAF 内追帧 N tick(N 受墙钟抖动)破异步逐像素确定性**:`frameCount>=target` 跨 RAF 异步采样落帧不确定 → 逐像素门交「手摇定量推帧」的桩通道(`?engine=stub`)独占,引擎通道只证掌帧+渲染落 2D(像素非空+主色命中,不比逐像素哈希)。门0 driver=`game-runtime/test/harness/gate0-engine-takeover.cjs`(双通道:real 证掌帧/stub 兜确定性+回滚)。
|
||||
|
||||
## 6. 引擎能力真接线门(门②·runtime call-ID)增补(A6 实证,T1b-β·2026-06-13)
|
||||
|
||||
证「插件能力**经 ctx.getEngine() 运行时真调引擎**」(动态证据,区别于门①的 esbuild metafile 静态 import)。门 A6 6/6 实证,driver=`game-runtime/test/harness/a6-engine-wiring.cjs`,编排=`a6-runbook.sh`。
|
||||
|
||||
1. **门②探针形制=host-dev 侧 rec→window.__engineCalls**:在 host 的能力工厂(`makeEngineCaps`)给每个引擎能力叶方法(particles.spawnEmitter/audio.synth.synthSfx/math.easing.*)埋一行 `rec(id)` push 到 `window.__engineCalls`,**仅取证、绝不入渠道产物**(工厂只活 real 通道)。再加 `__hostdev.engineProbe()` 经**各插件真实公开 API**(非直调引擎)触发能力调用 → 断言 __engineCalls 含 call-ID。真接线靠「插件真实 API → rec 命中」双证,不靠直调引擎自欺。
|
||||
2. **引擎渲出色=spec,非旧 sim 口径**:删 sim 后粒子由引擎 ParticleEmitter 渲,颜色取 `spec.colorStart`(如 particles-juice burst 给**白** r=g=b=1)。A0 G0-7 的青蓝(`b>r+30`)口径对引擎渲染**失效**→像素门判据改「任意亮像素 `max(r,g,b)>80` 计数 + `maxCh` 全屏最亮」;`maxCh≈0`=确凿反证「GL 关致引擎粒子不落 2D」的全黑假象(实测 maxCh=240,引擎真落 2D,GL 关无碍 fillRect 路)。**换引擎能力后,像素门的颜色假设必同步重核**。
|
||||
3. **音频合成需 AudioContext 非空**:插件 playSfx 在 `audioOrSilent()==null` 时早返不合成→rec 不触发→探针须先 `unlockAudio`;chrome `--autoplay-policy=no-user-gesture-required` 下 headless 可合成(此项软门兜,headless 不可用时 deferred 不阻断,正确性由单测 mock-synth 注入兜)。
|
||||
4. **mini-desktop scratch 部署**:6c6g `./` rsync 会吞整个 monorepo(cwd 易被重置到仓根→`tar -C <abs game-runtime>` 或绝对路径,**严禁裸 `./`**);A6 仅需 host-dev/index.html + 预建 host-bundle.js(本机 esbuild 出,含探针)+ test/harness/*.cjs + `npm i ws`,tar-pipe 几文件即可,无须全树同步。
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
> **本文件是项目管理唯一活账**:把「计划 ↔ 完成 ↔ 待办 ↔ 执行记录」对在一起。
|
||||
> **铁律**:每次波次收口、每次里程碑状态变化,**必须按 [`wave-close-checklist`](../../.agents/skills/wave-close-checklist.md) 七步收口**(本表+表头日期、作战清单+归档、回填、蒸馏、索引;`.agent` 仅结构变化时),否则视为未收口。
|
||||
> 计划权威来源:`.agents/knowledge/mvp-scope-and-milestones.md`(55 P0 / 137 技术项 / M0-M5)、`docs/architecture/{产品需求清单,技术架构与模块,需求模块映射}.md`(Doc A/B/C)、`docs/superpowers/specs/mvp-execution-spec-design.md`。
|
||||
> 维护:主 agent | 最近更新:**2026-06-12**(T1b-α 收口:插件库 9 件+拔高样板「暖阳小卖部」**创始人亲玩主门 PASS**,好玩基线 v2 立标;同日补账渠道波/W-CLEAN/战略与审计簇〔生成主线裁定+AgentScope 终裁+NIH 审计清毒〕;对账至 commit `12716d1`+本次收口)。
|
||||
> 维护:主 agent | 最近更新:**2026-06-13**(**T1b-β Phase A 引擎真接线收口**=A0 掌帧 + A1-A4 能力包装 + A6 mini-desktop real 引擎门 6/6,对账至 `3e5cab4`;前序 2026-06-12 T1b-α 收口:插件库 9 件+拔高样板「暖阳小卖部」**创始人亲玩主门 PASS**,好玩基线 v2 立标;同日补账渠道波/W-CLEAN/战略与审计簇〔生成主线裁定+AgentScope 终裁+NIH 审计清毒〕;对账至 commit `12716d1`+本次收口)。
|
||||
|
||||
---
|
||||
|
||||
@ -145,6 +145,7 @@
|
||||
| **T1b-α 插件库+拔高样板(主门=创始人亲玩 PASS)** | spec v2.1 对抗审 11 条全采纳→Gate0 七件+core-protocol-v0 冻结(受控面 6 项禁直透引擎)→8 件插件三 lane **155/155 测绿**→集成段三门 PASS(**SIZES 九件全≤配额,全栈 gz 16.5KB**,mini-desktop CDP probe 链/vfx 像素哈希)→参考件轮 1「暖阳小卖部」(Fable dev agent:logic/host 双层 49 测+mmx 资产 16 件统一水彩风)→e2e 四件套 REF_E2E PASS(**7 轮调试链全在 harness/壳侧,游戏逻辑零返工**;收编+门逮 2 真缺陷:esbuild const 赋值/canvas 压下 29px 裁底)→我判 ≈4.1 达线→**创始人亲玩判「quality passed」(轮 1/3 即过),好玩基线 v2 立标**;成本对账:Fable 单件 398,678 tok≈¥50-80(L3 顶配档参照系)、mmx quota 零差;顺手清雷:ExecutorLlmClient 显式 max_tokens=4096(`09d8678`,mini-desktop 15/15 绿) | `2446b71`→`a4b2eef`(spec/Gate0/插件/集成/参考件/e2e/判定全链);收口报告 `2026-06-12-T1b-α收口报告.md` | 155+49 node 测;SIZES 增量法实测;evidence 四件套 `games/wanglanmei-ref/evidence/round-1/`;创始人亲玩门;demo serve `100.64.0.7:4320`(t1ba-ref-play 登记保留) |
|
||||
| **战略与审计簇(生成主线/agentic 基建/NIH 审计+全档清毒)** | ①创始人裁定**生成主线:Fable 只造引擎,生产生成=便宜模型**(M2.7/M3/DS-V4+harness 门兜底,W-G1 竞标实测);②agentic 基建复议(自研薄内核被推翻,同引擎终裁逻辑)→HJ-AGI-001 **终裁=AgentScope 2.x 主力**(五资产契约边界+L1 裸通路框架外定案,换轨触发写死,W-G1 即 spike 门);③NIH 自研偏误全链审计(Fable Max 只读):病理=切面性,根因 R1-R7,逮**第三案现行**(粒子/物理/后处理平行重造引擎内建)→创始人裁决①**三件改引擎能力包装层**(β 真接线门)→新规 `.agents/rules/build-vs-buy.md` 七条+**全文档清毒**(单源高危件亲笔+长尾 agent 18 改 1 新建,活文档残毒终扫清零,历史 spec 挂横幅纪律) | `8509bfd`/`430f832`→`58a30d5`/`5a40824`→`12716d1` | 审计报告 `2026-06-12-自研偏误全链审计-报告.md`;评审版 `2026-06-12-agentic基建框架选型-review.md`;清毒残扫零未标记命中 |
|
||||
| **T1b-α 收口(wave-close 七步)** | 七步全跑:总账补今日五波欠账+表头;作战清单完成项移归档+完成线提请重锁;回填声明(已随清毒六连提交完成,无新增);新建 `game-runtime/.agent`(结构性新工作区);蒸馏新 skill `game-e2e-cdp-harness.md`(编排形制/驱动器六律/出厂红线);索引双同步(README+AGENTS §5);e2e runbook 自 /tmp 入库+收口报告落档 | 本次收口提交 | 提交前 30 秒自检过(表头日期=收口日;作战清单 ✅ 残留=0) |
|
||||
| **T1b-β Phase A 引擎真接线(A0 掌帧 + A1-A4 能力包装 + A6 真引擎门 · Ultracode)** | 2026-06-13 按创始人「引擎↔插件边界模型」(引擎有→薄包装/引擎无→自研补层/一职一路,见记忆 `engine-plugin-boundary-model`)接线。**A0**=host-dev RAF 桩→littlejsengine engineInit 五回调真掌帧(门0 8/8)。**A1-A4**(scoped workflow 政策→设计→对抗复审 halt 门→实现):A1 host.js engineFactory 真活+受控面+easing 门面;A2 EngineEmitterSpec additive 扩+薄包装引擎 ParticleEmitter 删 sim;A3 包装 zzfxG/zzfxM 删 vendored+播放层补×0.3;A4 gamefeel easing 改走门面+collision/physics/palette 补层标注。**对抗门两逮均落地前零返工**:①A4 easing 误判(grep 假阴性→引擎实有 Ease)创始人改判本波包装→11 曲线门面包装+backInOut/elasticInOut(引擎 IN_OUT 差 6.6%/17%)留内置补层(hybrid);②collision 注释 under-claim 源码精校。**A6**=mini-desktop real 引擎门 **6/6**(真接线门② call-ID:particles/easing/audio 运行时真调引擎 + 引擎粒子真渲 maxCh=240 + 掌帧/受控面零回归)。新红线政策 §1.5:**引擎能力普查禁按预期名 grep** | `11c8eaf`+`7efe8a4`(A0)→`e591e9b`(A1-A4)→`3e5cab4`(A6) | 本机门:**168 单测绿**+双 bundle esbuild rc=0+真接线门①引擎 163641B+门③负扫全清(0 插件 import/vendor 删/0 sim/0 假注释);A6 mini-desktop real 引擎 **6/6**(`game-runtime/evidence/a6/a6.json`+RESULT.md);**5 次源码证伪假设全前置**(含我自身「byte-identical」过宽断言被 ULP 实测纠偏,2 条 §7 误判+easing+collision+我自证)|
|
||||
|
||||
## 7. 风险与口径提醒
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user