85f48228cd
- tsc 顾问门:typescript devDependency + tsc-advisory 测试档;顾问性(永不阻断), 金标 10 款零误伤抽验 - recipes/ 五篇高频场景索引(命中矩形/计时器/资产回退/场景机/结算演出,「抄这段形态 +头号病根」)+ littlejs-game-dev §0.5 卡壳就查接线 - 暗资产接线:plugin-capability-map(11 注入+1 取证+6 储备逐件裁定)+ engine-capabilities-brief(≤3KB 蒸馏)+ api.d.ts/game-host.d.ts 补插件指针; 三方一致性对账门 plugin-surface-gate.py(含 cwd 锚定修)挂 pre-commit+Gitea Actions - hard_genre_batch 参数化(五品类 n=5 批跑驱动,checkpoint 续跑) - n=5 基线台账入库(gitignore 例外 add -f,只入台账不入游戏产物): wax-baseline.jsonl 25 局逐局记录(含判定仪器订正批注:cap1500 重判/图像盲 M3 重判, 只加字段零改值)——终数:操作口径 14/25=56%、质量口径 18/25=72%; 品类 narrative/heritage 5/5、trpg 4/5、puzzle/sim-business 2/5(缺口逐局有名有姓, 根因见 07-10 v2 plan §1);旧「80%/39%」口径正式作废存照 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4.5 KiB
4.5 KiB
插件能力图谱 —— 注入了什么、储备着什么、为什么
便宜档生成 agent 只能用已注入的插件（经
plugins.<键>取，不能 import）。这份图谱回答：现在桌上有哪 11 件、 每件去哪读详细用法、还有哪些造好了但没摆上桌、以及为什么没摆。改这里的裁定要同步改机器门.agents/tools/plugin-surface-gate.py的台账常量（三方一致性它会自动对账）。
已注入的 11 件（plugins.<键> 直接用）
方法头部选型见 littlejs-game-dev.md §4；精确签名读各插件 api.d.ts；用法散文 + 集成注意读各插件 PLUGIN.md（比 api.d.ts 多了「怎么装、坑在哪、示例」）。
| 键 | 目录 | 一句话能力 | 详细读 |
|---|---|---|---|
sceneFsm |
scene-fsm | 场景/状态机（menu→play→over） | game-runtime/src/plugins/scene-fsm/{api.d.ts,PLUGIN.md} |
sessionScore |
session-score | 计分 + 胜负闸 | game-runtime/src/plugins/session-score/{api.d.ts,PLUGIN.md} |
hudUi |
hud-ui | HUD/UI 绘制 + 命中判定 | game-runtime/src/plugins/hud-ui/{api.d.ts,PLUGIN.md} |
timerScheduler |
timer-scheduler | 受控时钟调度（毫秒） | game-runtime/src/plugins/timer-scheduler/{api.d.ts,PLUGIN.md} |
save |
save-progress | KV 持久化（最佳分等） | game-runtime/src/plugins/save-progress/{api.d.ts,PLUGIN.md} |
gamefeel |
gamefeel | 手感：缓动 + 输入缓冲 + coyote/combo | game-runtime/src/plugins/gamefeel/{api.d.ts,PLUGIN.md} |
juice |
particles-juice | 粒子 + 打击感（顿帧/震屏/闪白） | game-runtime/src/plugins/particles-juice/{api.d.ts,PLUGIN.md} |
palettePost |
palette-post | 调色 + 后处理（预设一键观感） | game-runtime/src/plugins/palette-post/{api.d.ts,PLUGIN.md} |
audioMusic |
audio-music | 程序化音乐 + 语义音效 | game-runtime/src/plugins/audio-music/{api.d.ts,PLUGIN.md} |
collision |
collision | 碰撞查询（纯数学） | game-runtime/src/plugins/collision/{api.d.ts,PLUGIN.md} |
physics |
physics-lite | 街机运动原语（非刚体） | game-runtime/src/plugins/physics-lite/{api.d.ts,PLUGIN.md} |
runtime-probe（取证不注入）：只在收口取证六锚（启动耗时等），不进 plugins 面，生成 agent 用不到。
未注入的能力储备（6 件·造好了但没摆上桌）
这 6 件都是通过测试的真插件（各有 api.d.ts/impl.js/test），但当前 5 个注入品类（经营/剧情/TRPG/解谜/非遗）全是
点击/回合制 tap 玩法，它们服务的是别的品类或需要额外装配，故本波不注入。生成 agent 现在读不到、也用不了它们——
别在 game-logic 里写 plugins.autoTargeting 之类，会是 undefined。每件的裁定依据与「什么时候该注入」：
| 目录 | 是什么 | 为什么没注入 | 注入触发条件 |
|---|---|---|---|
| auto-targeting | 索敌策略族（最近/锥内/随机选目标） | 服务射击/动作类「自动锁敌」，当前 tap 品类用不上 | W-GENRE 上动作/射击品类时 |
| swarm-steering | 均匀网格 + 群体运动学（同屏千级实体） | 服务动作/idle-sim 的大规模实体，tap 品类无此需求 | W-GENRE 上动作或放置模拟品类时 |
| entity-pool | 对象池 + swap-remove（局内零 GC） | 密集实体（子弹/敌群）性能件；粒子已由 particles-juice 承接 | 同上，动作品类需要密集实体时 |
| virtual-joystick | 浮动原点虚拟摇杆 + 轨迹 driver | 连续移动输入，与当前 handleTap 输入契约不同轴；tap 品类不需要 |
W-GENRE 上需要连续移动/瞄准的品类，且输入契约扩展后 |
| canvas-ui-kit | 卡片选择器 / 滚动列表 / 顶栏（hud-ui 之上的组合件） | 需 draw: hudUi 复合装配；对 TRPG 选天赋、经营选货有价值，但注入是行为面变更 |
后续给 TRPG/经营注入的首选候选——单起一个装配任务，同步 3 方对账 |
| hit-feedback | 反馈档位编排（一次事件→顿帧/震屏/音效/飘字） | 需 juice + sfx 复合装配；与直调 juice+audioMusic 重叠，skill/settlement recipe 已教直调 |
若要把反馈收敛成单入口 + 音画同帧取证时 |
注入任一件 = 改 6 个 _template*/src/host-config.js 的 plugins 装配 + prompt 白名单（cheap-system.md）+ tools.mjs PLUGIN_KEY_DIR，三处同改、再跑 plugin-surface-gate.py 验三方对齐。gate 会拦「注入了但白名单漏列」「白名单列了但没注入」「新插件目录没裁定」。