2026-10-25 工作日志
来源:.workbuddy/memory/2026-10-25.md · 20.5 KB
2026-10-25(提交日)
当前游戏排查与提交准备(12:33—15:55)
- 用户令"搜索当前游戏":查明工作区实际游戏为 游戏-鲸鱼魔盗团/(另一条线 10-24 建成):横版侧视小队动作(直接操控 DeepSeek + 指令 Grok/Claude/GLM + 回声预测 + Token 经济 + 限定词),五章主线约20分钟,src/main.mjs 40KB,30+ verify 脚本,deliverables 三个 zip。
- 实跑取证:verify-core PASS;expanded-campaign 全流程 344.03s/0失败;fuzz-world 156用例/140400帧/0失败;HTTP 冒烟 200。发现交付 zip 过期(10-24 22:56 包 vs 10-25 上午三轮视觉升级)→ 已重建 dist(101文件/51 PNG/1280×720)+ verify-build PASS + 重打包三zip(源码190MB/部署114MB/美术168MB)+ 校验json刷新(12:38)。
- 短剧物料补齐:一页大纲.md、海报.png(Pillow 1600×900,用 tmp_story_stills 三集实拍帧)写入 提交物料/;游戏交付说明.md + 作品说明.md(本轮用户点名要的)写入 提交物料/。
- 未解决 P0:EP2/EP3 成片超 60s 红线(61.84s/60.28s)。根链:① mp3 concat 编码器延迟积音轨超长(已用 PCM 波形级重建修复,音轨已精确 57.1/59.5/59.8)② concat demuxer 的 VFR 视频轨元数据(59.6s)与实际帧时间戳(61.8s)不符,copy-mux/-t/trim 均被末帧长时长撑爆(末帧起始于 -t 之前即整帧写入)。末次抢救(片尾卡 2.8→0.6s 重建)ffmpeg 静默失败产出 0s 文件,15:54 截止前停止追查。待办:提交后用
-loop 1 -t <dur> -i png 逐帧输入 + concat filter 重建视频轨(彻底避开 demuxer),或直接砍 EP2/EP3 各 1-2 镜重渲染。 - 坑位记录:① 构建脚本"标称时长自评"会骗人——成片合规性必须以 ffprobe 容器时长为准 ② 本环境无
bc,算术用 python ③ ffmpeg 静默失败要查 stderr,别 DEVNULL 到底。
游戏部署上线(15:56)
- 用户令"将游戏部署上线":将
游戏-鲸鱼魔盗团/dist(静态站,entryHtml=index.html,assets/src 资源齐全)经 sites 工具发布为 web-page,verified=true。分享链接 https://whale-pirate-crew.app.workbuddy.host/?sharecode=KY5SOZXVTD ,应用名"鲸鱼魔盗团",domainPrefix=whale-pirate-crew,标记文件 .wbapp_WyS21rtiFtjlIElNMNSJno.genie 在工作区根目录。后续改内容再上线需用户当次明确要求。 - 确认:同目录再部署链接不变(复用同一 app sandbox),consent 不跨轮次。
手机端尺寸适配修复(16:20—17:10,identify→fix→verify→mutation→guard 全闭环)
- 用户报"手机端尺寸适配有问题"。新建真机参数复现脚本
scripts/mobile-adapt-qa.cjs(844×390 dsf3 / 740×360 dsf2 / 640×360 dsf3 + 竖横旋转流;测 shell 16:9 信箱、canvas CSS/backing 比例、touch 控件 ≥44px 在屏内、command 可达、overflow 检测排除装饰遮罩与"滚动容器内可达"元素)。 - P1 真缺陷(已修):
src/render/resolution.mjs mobile 分支 Math.round(target*4)/4 浮点掉档——693.3 CSS 宽 ×3 DPR = needed 1.6249,×4=6.4997 → round 6 → 1.5 档,backing 1920px < 物理 2080px,画面放大 1.083 倍发虚。修法:mobile standard 取 min(2, max(needed*1.25, 1.5))(25% 超采样)、low 取 clamp(needed,1,1.5)(1:1 物理),量化步进改 1/8。844×390@3x:1.5→2.0(1920→2560 backing)。 - 误报排除(未改代码):① title 鲸艇
right:-3% 右侧出血为登场设计;② command "高级编排"按钮在 .v3-command-body 滚动流内(面板 flex column:header/footer 固定 + body overflow:auto),原本就可滚动到达——首轮测试断言滚错容器(滚了 overflow:hidden 的面板)造成假阳性;曾误加 .command-panel{max-height:88%} 至 game.css,诊断后发现会破坏 flex 滚动设计,已撤掉。 - 测试修正:physical 需求按 canvas CSS 宽×DPR 算(16:9 信箱下 canvas 不占满视口,844 视口需求 2080 而非 2532)。
- 契约同步:
scripts/verify-rendering.mjs 旧期望 1.75→2,补 low 1:1 用例(693.3@3 low=1.625、700@3 low=1.625、693.3@3 standard=2)。 - 证据:verify-rendering PASS;qa-browser 既有 Touch landscape 三视口 PASS(dsf=1 无破坏);mobile-adapt-qa 4/4 PASS;mutation test:旧公式注入 → FAIL「backing 1920 below physical 2080 on iphone-landscape-844x390-dsf3」,还原后 4/4 全绿。
- 回归守护:mobile-adapt-qa.cjs 已挂入
scripts/verify-all.ps1 链尾(build+verify-build 之后),全量回归后台执行中。 - 坑位:① 面板 DOM 是双类名
command-panel v3-command-panel,布局规则在 ui-v3.css(max-height:84%/52cqh/85% 三处 media 叠加、component-art.css 的 85% 在 coarse pointer 下胜出),改面板高度必须看生效链;② getBoundingClientRect 报的是布局盒,max-height+overflow 裁切不影响内部元素坐标,overflow 断言需配"滚动可达"语义。
全量回归链修复(16:41—17:00,存量破损,与适配修复无关)
- verify-all 全量首跑 23/26:3 个 FAIL 全链路定位并修复——①
verify-main-flow.mjs/verify-stress-main.mjs 的 context.GameAudio mock 桩缺 playMusic/playVoice/stopAmbience/setAlertHigh(main.mjs 今日音频/演出升级后调用新增,桩未同步);② 两脚本还缺 context.Image(main.mjs 新增 preloadStoryImage 剧情关键帧预加载,需 decode/complete/addEventListener);mock 已补全,复跑 7/7 与 5/5 全绿。 verify-all.ps1 第 1 行 $ErrorActionPreference='Stop' 会让 native command 的 stderr(PowerShell 包装成 ErrorRecord)中断整条回归链,已改 'Continue',失败仍按 exit code 逐项记录进 summary。- 环境坑:build-game.mjs 的
fs.rm(dist) 会触发 WorkBuddy safe-delete shim 的本回合批量删除配额(148 文件 > 50 阈值,SAFE_DELETE_BULK_CONFIRM_REQUIRED,scope=turn)——同回合多次 build 后会被拦,非代码问题;重试/下回合恢复。dist 与 src 一致性由 verify-build.mjs 把最后一道关。 - 最终态:26 项链路全绿(含链尾 mobile-adapt-qa.cjs),mutation test 证明新测试能抓住旧公式缺陷。
移动端"玩起来费劲"根治:WebP 迁移(17:20—17:50,已上线)
- 用户报"移动端浏览器玩起来费劲"。新建
scripts/mobile-playability-audit.cjs(真机参数 844×390 dsf3)取证:性能无问题(中位帧 5.6ms / p95 11.2ms / 0 掉帧 / 堆 6MB)、触摸指令流 5 tap 1.1s 可达、触摸键 44–58px 达标。真因是加载量:title 25.2MB、进关卡累计 65MB(全 1280×720+ PNG),4G 手机首屏近 1 分钟。 - 三层决策(先做实验再定):PNG optimize 只省 7%(弃);UI chrome quantize 256 省 83% 但破坏"交付图 == AI 生成原图字节"的溯源契约(弃);WebP q90 省 77–82% 且保住溯源 → 采用。
- 最终方案:交付统一 WebP、原 PNG 全部保留(溯源 + 秒回滚)。catalog 增
delivered_bytes/delivered_sha256(WebP),bytes/sha256 继续绑定生成原图,verify-art 的 provenance 契约因此完好。 - 规模:48 张 catalog 图 104.9M→18.4M;UI chrome 11 张 7.6M→1.7M;另补 foreground 两张(hero/dock-rail 不在 catalog,正则漏网)。dist 114MB→26MB,移动端 title 25.2→6.2MB、gameplay 65→14.4MB。
- 引用工程:正则脚本
output/mobile-adapt/tmp/rewrite-refs.py 扫 src/+index.html/story-theater.html/scripts,仅当 .webp 实际存在才替换(100 处,leftover 0)。正则覆盖不到的模板拼接必须手改:story-art.mjs 的 storyArtFor/STORY_ART_IMAGES、ui.mjs 的 portrait、ui-v3.mjs 的 portraitPath+背景别名表、story-theater.mjs 的 endsWith('.png')。 - 契约同步:verify-art 加
webpSize()(VP8X/VP8L/VP8 三分支)并分支校验;verify-story-art 路由改 .webp。 - 质量证据:可见像素 PSNR 34.6–39.0 dB(阈值 32),meanΔ 1.5–2.4/255。坑:算 PSNR 必须排除全透明像素(alpha=0 时 RGB 任意,maxΔ=255 是假警报)。
- 回归 25/28:3 个 FAIL 均非本轮引入——build-game 是 safe-delete 本回合删除配额(单独跑成功);verify-world / fuzz-world 依赖链(chapters/state/maps/world/rooms/session/contracts/prompts)与本轮改动零交集,属
src/game/world.mjs 今日改动的存量问题(close-hatch 第 5 章路线 x=1100 处 health-depleted、fuzz seed1/2 frame452 快照不一致)。 - 已上线:https://whale-pirate-crew.app.workbuddy.host/?sharecode=KY5SOZXVTD (同目录,链接不变)。
- 线上实测取证(真机参数 844×390 dsf3,Playwright 直连线上域名):title 正常进主菜单、53 资源 6.0MB、0 失败;进 demo 关卡后 screen=none 可玩、122 资源 15.7MB、canvas backing 1920/2560×1440(分辨率修复线上生效)、帧 median 5.6ms p95 16.9ms 0 掉帧、0 个 4xx / 0 pageerror。
- 坑位:直接用 fetch 拿线上子资源(不带浏览器 cookie)会 403——站点按会话校验子资源,只有带 sharecode 的浏览器会话能取;线上验收一律用 Playwright 真跑,别用裸 fetch 判定"资源挂了"。
- 坑位:① Pillow 12 RGBA 量化只支持 FASTOCTREE/libimagequant(本机无后者),MEDIANCUT 对 RGBA 直接抛错;FASTOCTREE 对 1280×720 大图很慢(51 张跑 300s 超时),实验只跑大图子集 ② catalog 的
file 字段不含 assets/ 前缀,拼路径要自己加 ③ Windows Python 下 Git Bash 的 /tmp 不可写,临时文件落项目内目录。
音频接入核查(16:23,用户令“检查音频有没有用到游戏里”)
- 46 个 mp3(BGM7/环境3/SFX16/语音20)全部登记:audio.mjs 四张表 + runtime-catalog.json 46 条 + provenance/audio-manifest.json,三方一致;主项目 dist(16:28 重建)包内 46 个齐全。
- 运行时实际播放 30/46:BGM 7/7、环境 2/3、SFX 15/16、语音 6/20(hero_evacuate/hero_encourage/glm_public/grok|claude|glm_confirm)。
- 未播放 16 个约 554KB:amb_ops(setScene 未播,方案§4 要求 1-3 章叠加)、ui(无 play('ui') 调用,GameAudio 仅 main.mjs 导入)、14 条语音(方案 P2 可选项未接线)。
- 反向缺口:world.mjs emit guard-warning 无文件,走合成器兜底。
- P0:游戏发布快照/dist 是 15:47 接线前旧构建(audio.js 3692B 纯合成器、包内 0 mp3)——快照 15:46 拍摄早于 16:09 音频接线;从快照 dist 启动则 46 个资产全部不响。已出报告 docs/音频接入核查报告-2026-10-25.md,建议用主项目当前 src+assets 重打包快照。
音频全量接线(16:40—17:23,用户令“全部用到游戏里”)
- 16 个闲置资产全部接线(纯增量,零游戏逻辑改动):14 语音 → hero_confirm=每章首条指令回执 / hero_charge=剧情fx water / hero_scan=剧情fx scan+DeepSeek / grok_charge=fx impact / grok_pickup=delivery事件 / grok_cheer=chapter-result / grok_evacuate=evacuation-status与hero轮换 / claude_analyze=analysis-open / claude_careful=guard-warning / claude_record=fx record / claude_alert=alarm事件 / glm_scan=fx scan(非DeepSeek) / glm_warn=警戒跨70 + fx alert / glm_route=fx beacon(fx 出现数:beacon14/record9/scan6/alert3/water2/impact1,已核实全部真实存在);amb_ops=setScene 1-4章叠加;ui=act()白名单 37 个菜单动作。
- 新守护 scripts/verify-audio-usage.mjs(46/46 全触发 + 清单↔磁盘完整性 + guard-warning synth 提示)+ scripts/mutation-audio-usage.mjs(7/7 全杀;首轮 M2 存活因 stopAmbience('ops') 字面量被当证据 → 守护改为剥掉 stop* 再查裸字面量)。verify-all.ps1 自动收录 verify-*.mjs。
- 验证:build 148文件/46音频/verify-build 0缺失;verify-core/main-flow/story-flow(18/18)/story-ui/input/stress-main(5/5)/experience/runtime-save 全 PASS。修了 verify-story-flow 的 VM 测试桩(补 storyArtFor/Image/FakeAudio 音频面——16:09 音频接线与 17:03 剧情美术预埋改了 main.mjs 但没同步桩,属他人遗留)。
- 游戏发布快照已刷新(src/assets/dist/index.html/story-theater.html 同步主项目),46 mp3 入包。
- 重要:并行会话在同时改同一批文件——17:03 写了 main.mjs+audio.mjs(剧情美术预埋 storyImageCache),17:06 重写 world.mjs 诱饵逻辑。verify-world 因此红(close-hatch health-depleted,纯世界模拟、不引用 main/audio,16:54 基线曾 PASS),非本次音频改动所致;改文件前必须查 mtime/sha 防覆盖。
19:0x 鲸鱼魔盗团 · 前端整局通关 QA(自动化真机)
- 建了驱动
游戏-鲸鱼魔盗团/output/playthrough/play.cjs:Edge headless + Playwright 真实键鼠,route 拦截 src/main.mjs 注入只读遥测 window.__whale.snap(),未改任何游戏文件。 - 实跑结果:序章 ✓、第1章 78/A(10 步教程全通)、第2章 65~67/B ✓;第3章 4/6 资料受阻;第4/5章未达。
- 关键发现:①剧情/菜单关闭后按钮抢占焦点 →
input.mjs 的 !event.target.closest('button') 会吞掉 WASD(非确定性卡死,复现 4 次);②冲刺后惯性 ~117px 无刹车,窄平台必掉;③教程跳跃判定要求起跳 x≤323;④地面陷阱无预警 + 700ms 无敌帧;⑤副房间入口固定 x=85 而资料在 x≈1000+,动线过长;⑥结算「暴露」无解释。 - 测试期间源码被并发改动(main/world/ui-v3,+262 行),"诱饵守卫贴身伤害"已在 18:45 版本修掉——结论已按当前源码复核。
- 产出:
output/playthrough/前端通关QA报告-2026-10-25.md、playthrough.log、shots/ 22 张、report.json。
21:1x 鲸鱼魔盗团 · 通关 QA 收口(补充)
- 补齐实测成绩:第1章 78/A、第2章 67/B、第3章 71/B、第4章 80/A(暴露0/重试0)、第5章 75/A(章节展示模式跑通完整撤离:3/3 数据→三人集结→装载→60s 撤离实跑 18.0s→交付登艇)。五章合计 371 分(按 campaignGrade 阈值刚好是 B,A 需 375)。
- 战役总结界面未取到:整链跑总在第5章信标台被守卫击杀→检查点回档打断(守卫巡逻 1030–1200 完全覆盖三块数据 1040/1120/1180)。
- 新发现:①第5章信标台取件必然进入守卫接触区(实测 100→35 血,另一次直接死);②死亡→检查点回档会静默清空"已收集未交付"资料(检查点只在换房/交付后创建);③偶发"screen=none/无碰撞/activeElement=canvas 但角色不响应移动"(未定因,驱动已加 Esc 自愈钩子)。
- 存档链路实测:自造 4 章/5 章存档均通过 parseSave 严格校验;导入后自动回标题并要求"点击继续航程";已通关存档的标题主按钮变成"再次出发"(无 resume 入口),因此无法用导入直达战役总结界面。
- 驱动新增模式:
QA_MODE=demo5(章节展示专跑第5章)、QA_MODE=import5(导入4章存档跑第5章)、QA_MODE=importdone(导入通关存档验总结界面)。 - 报告:
output/playthrough/前端通关QA报告-2026-10-25.md(已含成绩表、9 条问题、环境提示、工具说明)。
21:1x 鲸鱼魔盗团 · 问题总表成稿
- 新增
output/playthrough/游玩问题总表-2026-10-25.md:12 条待修(P1×2 / P2×7 / P3×3)+ 1 条已修复,含代码定位、实测证据、修法建议,并附「不是游戏问题」的脚本踩坑清单避免误判。
21:1x 鲸鱼魔盗团 · 修复方案成稿
- 新增
output/playthrough/问题修复方案-2026-10-25.md:A/B/C 三批(A 阻断3条:冻结/信标台取件区/长按互动;B 手感4条;C 打磨5条),每条给出 文件:行 → before/after 代码 → 风险 → 验证命令。 - QA-01 新线索:当前
frame() 世界更新带 !document.hidden 硬闸,页面被判隐藏时会静默停更(画面留最后一帧、screen 仍 none、无暂停提示)——与"卡住但一切正常"吻合;headless 实测 hidden=false,所以仍需真机复现,但建议直接删闸 + 加 0.6s 看门狗 + 移动键豁免 button 焦点。 - 待用户拍板:QA-02(挪数据 vs 缩巡逻)、QA-12(A 线 375→360)、QA-07(副房间动线是否动美术门位)。
21:4x 鲸鱼魔盗团 · 修复已落地(10 处代码改动)
- 按用户拍板:QA-02 保留紧张设计不改、QA-12 A 线 375→360、QA-07 动线不动。
- 改了:main.mjs(看门狗 +
interact-released + 拾取即落检查点 + campaign-summary 动作)、input.mjs(移动键豁免 button 焦点 + keyup 释放互动)、world.mjs(slideUntil 冲刺刹车、trap.warning 预警、绕行文案)、lesson-bridge.mjs(跳跃判定去 startX)、chapters.mjs(A 线 360)、ui-v3.mjs(暴露释义 + 查看航程总结按钮)。 - 验证:verify-core/input(5)/world(五章)/main-flow(8/8)/runtime-save(13)/experience(18)/story-flow(18)/lesson-bridge(12)/maps/mission/rendering 全 PASS;build 148 文件 missing 0;真机 demo5 页面异常 0(改前 351)。
- 坑:
cue('alert') 不在 runtime-catalog 的 animations(只有 water-dash/axe-impact/paper-decoy/scan-grid)→ 每帧抛 Unknown effect;改 scan-grid 后归零。**新约定:cue 的 group 必须在 catalog 里,verify-*.mjs 抓不到,只能真机验。** - 未闭环:QA-01 根因(看门狗是兜底);第5章整链跑仍被守卫击杀→回档打断脚本流程。
21:50 鲸鱼魔盗团 · fuzz 存档校验回归修复 + 重新上线
- 现象:
fuzz-world 119/156 用例失败,全为 invalid-crew-state(帧113–791、5章12房4契约均中)。 - 根因:
world.mjs:278 校验 crew 的 pose 白名单为 ['idle','walk','jump','skill'],漏 'fall';而 world.mjs:569 actor.pose=Math.abs(dy)>4?(dy<0?'jump':'fall'):'walk' 会合法产出 'fall' → exportState 如实导出、restoreState 误拒(玩家侧 271 行本就有 'fall')。属校验器白名单缺项,非玩法 bug。 - 修复:
world.mjs:278 加 'fall'(单点、零玩法副作用)。 - 证据:fuzz 修复后
failures:[](156用例/140400帧);verify-world 五章 PASS;mutation test PASS(回退→fuzz rc=1 重现 invalid-crew-state@frame452;还原→rc=0 failures:[])。 - 回归:verify-core/rendering/art/story-art/main-flow/stress-main 6/6 PASS;mobile-adapt-qa 4/4 PASS。
- 构建/上线:
build-game clean 重建(148文件/26MB,dist/src/game/world.js 已含 'fall')、verify-build verified;重发布同链接 https://whale-pirate-crew.app.workbuddy.host/?sharecode=KY5SOZXVTD;线上真机校验 title 正常、hasFix:true、0 控制台错误/0 失败请求。 - 遗留:
deliverables/ 三个 zip 仍是旧 PNG 版 dist(赛事已截止,未擅自改)。
23:xx 鲸鱼魔盗团 · 前端玩家化完整通关(发现并修复真实输入 bug)
- 用户要求"作为玩家在前端从头到尾游玩一遍"。复用
output/playthrough/play.cjs(真实浏览器 Edge + 真实键鼠 + 只读遥测探针,不改磁盘)。 - 新发现真实 bug(玩家可复现):
input.mjs 的 clear() 会清空按住键集合,而剧情/菜单切换都会调它;已按住的键不会再发 keydown → 剧情结束后角色僵死在原地(实测卡在 ch1 x≈412,vx=0 但 dtWorld=0.633 世界正常推进)。修复:clear() 只清瞬态(edges/pointers/toggle),新增 reset() 供真正失焦(blur/pagehide/visibilitychange/orientation/configure/listenForBinding + main.mjs 三处 lost-focus/看门狗 hidden)使用。 - 证据:
verify-input.mjs 新增"overlay clear() 保留按住键"回归守卫;mutation test PASS(回退→ERR_ASSERTION 被杀;还原→全绿)。 - 驱动脚本增强:walkTo 卡死时输出冻结探测(dtWorld/dxPlayer 区分"停更"vs"按键失效");ch5 正解是先用 Claude
evacuation-patrol 引开巡逻(信标台 1030..1200 全在巡逻区,硬闯必死),集结触发后退到下层避巡逻、装载/撤离不预等守卫;walkPastTrap 超时 6s→15s + goTo 跨层兜底(回档重生在房间入口,6s 走不到)。 - 结果:完整通关 5/5 章 + 尾声 + 战役结算(A 级 · 376/500 · 截图 99-campaign-result.png);demo5 单独跑第5章 0 问题(撤离 16s/上限 60s,health 15)。4 个非阻断 P1 均为驱动脚本预期偏差(节点已被顺带打开、压力板已锁开)。
- 假阳性说明:报告里"[P0] 战役未正常完成 :: undefined"是探针限制(通关后 world=null,snap 退回 base 读不到 campaign),
waitScreen('campaign-result') 本身成功 + 截图实证。 - 线上站点尚未包含本输入修复(发布需用户当轮确认);本地 dist 已重建 verify-build 通过。