Menu
bili_webos 的测试与验证方法论 — 发版前验证管线、真机 CDP 测试、旧设备(webOS 5/Node 8)兼容、修 bug 的验证纪律。改动 service/ 或 app/、修 bug、发版前都应使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | tv-test |
| description | bili_webos 的测试与验证方法论 — 发版前验证管线、真机 CDP 测试、旧设备(webOS 5/Node 8)兼容、修 bug 的验证纪律。改动 service/ 或 app/、修 bug、发版前都应使用。 |
bash tools/verify.sh # 全链路:语法 → 真Node8 → 构建 → 部署 → 真机DOM检查
bash tools/verify.sh --no-tv # 只跑本地层(电视不在时)
bash tools/verify.sh --full # 额外跑真机 UI smoke(test-ui.mjs,~3分钟)
五层,逐层 fail-fast:
node:8(x86)跑真实 service.js:stub webos-service、驱动 fetch handler 真连 api.bilibili.com、调 getDiagnostics。见 tools/test-node8/tools/launch.mjs 重启 appgit checkout <旧commit> -- <文件> → 部署坏版 → 同一操作复现 bug → 恢复新版 → 同一操作确认消失。边缘滚动 bug 连续两个版本"修好了"都是假的,就是因为没做正对照。route.abort() 掐断 API,确认错误文本上屏、进报告。document.addEventListener('mousemove',...,true))再注入 CDP 事件 —— 曾经 CDP 鼠标注入静默失效,把"工具坏了"误判成"产品坏了"浪费了一整轮。npm run dev + Playwright(page.mouse/page.keyboard 走真实 Chromium 输入管线),addInitScript 干掉 window.webOS 强制走 proxy,page.route mock 数据流(mock 端点注意 wbi 路径:**/top/feed/rcmd**)。TV 的 CDP Input.dispatchMouseEvent 不可靠,不要依赖它测 hover。URL/URLSearchParams/globalThis 全局、没有 ?./??/optional catch binding。new URL 要写 require('url').URL(曾导致 webOS 5 全部请求失败,#10/#13)。ws 必须 v7(v8 要 Node 14)。npx acorn --ecma2017 --silent <file> 快速把关。| 工具 | 用途 | 坑 |
|---|---|---|
launch.mjs <appId> | 启动/切换 app | 必须 luna-send-pub(公共总线);私有 luna-send 对 prisoner 永远 Permission denied |
wake.mjs | WoL 唤醒电视 (MAC 14:7f:67:a1:6b:56) | |
drive.mjs "keys" | 遥控按键 + STATE | 从未知焦点开始导航不可靠,先 left,left 回侧栏 |
point.mjs "move:x:y,wheel:d,click" | 指针模拟 + focus/underPointer/match | 注入可能静默失效(见纪律3);端口已改 ephemeral |
eval.mjs "<expr>" | 页内执行 JS | 验证 UI 状态首选(截图对 GPU 层是白的) |
screenshot.mjs | 真机截图 | 视频/GPU合成层截不到 |
test-ui.mjs | 真机 UI smoke 全家桶 | app 须在前台 |
test-e2e.mjs | API 集成测试 | 需先 node proxy/server.js |
"没法测试 = 不允许上线"。为可测试性可以给 app 加专门的测试钩子。
window.__openVideo({bvid, cid, title})(App.jsx 注册)——CDP 里直接播放指定视频,
跳过整个 UI 导航;入口与卡片按键完全同路(normalizePlay 起全是生产代码)。
找"具备某特征"的测试素材(有字幕轨/有章节/多P):先用页内 luna fetch 查
history/cursor 或 player/v2,拿到 bvid+cid 再深链。setInterval(()=>dispatchEvent(new KeyboardEvent('keydown',{key:'ArrowRight'})),700)
合成键反复续命,另一个连接从容截图,完事 clearInterval。合成键走 JS 层
keydown handler,足够(不需要 trusted input 时)。getBoundingClientRect 只给布局位置,测不出 overflow 裁剪 —— 必须截图看像素。.player-controls 是 overflow-y:auto,往上探出的元素会被静默裁掉(v1.2.4 预览气泡被裁就是这么漏掉的);悬浮层挂到根节点。ended 决策逻辑(收藏连播 vs 分P)可用真实数据在本地 node 里跑决策函数做确定性验证,比 flaky 的真机播放可靠。开发完成 → 验证过的场景必须追加到 docs/TESTCASES.md(带事实佐证:抓过的真 bug 或正对照记录);
发布前按 docs/DEVELOPMENT.md 的门禁清单回归。能自动化的 case 升级进 tools/verify.sh。
每次踩到新坑/建立新方法,追加到对应小节。宁可啰嗦,不可失传。
通用方法论的正式版在独立仓库 ~/code1/webos-tv-skill(github.com/asdf17128/webos-tv-app-skill,reference/testing.md)—— 本文件放 bili_webos 项目专属细节(IP/密钥/工具名),提炼出的通用经验要同步一份过去。