59 lines
3.2 KiB
Markdown
59 lines
3.2 KiB
Markdown
# 浏览器验证工具（零依赖）
|
||
|
||
这些脚本用 Node 内置的 `WebSocket` 直接讲 CDP（Chrome DevTools Protocol），
|
||
不需要 puppeteer/playwright 这类依赖。目的只有一个：**给"页面里到底发生了什么"留下证据**，
|
||
因为像素和截图的判断在这套环境里不可靠（模型读不了图，`readPixels` 在合成后会返回清空缓冲）。
|
||
|
||
## inspect-page.mjs —— 单页检查
|
||
|
||
```bash
|
||
CHROME=/root/.cache/ms-playwright/chromium-1223/chrome-linux64/chrome
|
||
tsx scripts/browser/inspect-page.mjs "$CHROME" \
|
||
"http://127.0.0.1:5173/acts.html" \
|
||
scripts/browser/checks/act-state.js --screenshot /tmp/act.png
|
||
```
|
||
|
||
它会启动一个 headless Chromium（SwiftShader 软件 WebGL2），打开 URL，等待页面加载，
|
||
把 check 脚本的返回值打印成 JSON，可选截图。
|
||
|
||
## many-pages.mjs —— N 页同时跑（联机用）
|
||
|
||
```bash
|
||
tsx scripts/browser/many-pages.mjs "$CHROME" \
|
||
"http://127.0.0.1:5173/net.html?data=samples/fixtures&ws=ws://127.0.0.1:8787&peers=3&peer=0" \
|
||
"http://127.0.0.1:5173/net.html?data=samples/fixtures&ws=ws://127.0.0.1:8787&peers=3&peer=1" \
|
||
"http://127.0.0.1:5173/net.html?data=samples/fixtures&ws=ws://127.0.0.1:8787&peers=3&peer=2" \
|
||
--seconds 20 --shot /tmp/coop
|
||
```
|
||
|
||
每一页是一个**独立的 Chromium 实例**（标签页级复用在这套 CDP 流程里会把两次导航混在一起，
|
||
曾经导致"两页都跑成了 peer 0"这种假象）。它按页分发不同的方向键，让每个角色只受本页按键驱动，
|
||
结束时打印每页的 `window.__d2web*` 状态。判定靠状态字段，不靠看图。
|
||
|
||
## checks/ —— 页面内脚本
|
||
|
||
| 文件 | 目标页面 | 做什么 |
|
||
| --- | --- | --- |
|
||
| `walk-state.js` | `walk.html` | 读真实 MPQ（暗黑1 `spawn.mpq`）后的就绪状态、tick、drawCalls、`glError` |
|
||
| `net-state.js` | `net.html` | 单机模式的状态：世界 tick、角色数、怪物数、tps |
|
||
| `act-state.js` | `acts.html`（`?live=1`） | 读归档路径：归档是否读入、DS1 象限、格数、瓦片引用缺失数、图集尺寸，以及按键后的位移与朝向 |
|
||
| `act-pack-state.js` | `acts.html`（默认） | 资源包路径：是否走 pack、首帧装了几页（证明懒加载）、出画面毫秒数、按键位移与朝向 |
|
||
|
||
## 已知限制：沙盒里 Chrome 没有网络
|
||
|
||
在某些受限环境（例如代理后的自动化沙盒）里，headless Chrome **无法访问任何 HTTP 地址**，
|
||
包括 `127.0.0.1`。症状很有迷惑性：
|
||
|
||
- CDP 的 `/json` 目标列表**会**显示你要的 URL（Chrome 乐观地先报告待定导航）
|
||
- 但页面里 `location.href` 仍是 `about:blank`、`document.readyState` 是 `complete`
|
||
- 页面内 `fetch()` 报 `TypeError: Failed to fetch`
|
||
- `Page.navigate` 直接挂住不返回
|
||
- 同一台机器上 `curl` 一切正常
|
||
|
||
这和「场景启动失败」长得一模一样，很容易让人去应用代码里找根本不存在的 bug。
|
||
判定方法：如果 `location.href === 'about:blank'` 而目标列表里的 URL 是对的，
|
||
那就是环境问题，不是页面问题。
|
||
|
||
此时请改用纯逻辑测试（`tests/` 下的 vitest），它们覆盖了同样的断言且不需要浏览器。
|
||
`tests/engine-save-load.test.ts` 就是这样从退役的 `map-save-load.js` 迁移过来的。
|