Files
UHD_Media_Tool/packages/testkit
rootandClaude Opus 5.5 c437c6bff6 feat(browser): vision automation loop with screenshots, coordinate actions and bounded challenge solving
- browser.screenshot returns the page as an image content block (≤1280px wide, JPEG quality
  configurable) for vision-capable upstreams; non-vision upstreams get a redacted text snapshot.
  Login pages / password fields are marked sensitive and withheld unless a
  browser.sensitive_screenshot grant exists and allowSensitive is passed.
- browser.click_at / type_at / scroll / wait act in screenshot pixels; the server converts via
  viewport/DPR, requires automation control and an allowlisted host, and writes a thumbnail
  evidence file (DATA_DIR/tmp/evidence) referenced from agent_run_event.
- browser.solve_challenge runs a bounded child agent_run (vision caps only, maxSteps ≤ 12,
  budget), judges success from page facts, stops immediately on 2FA / SMS / device confirmation,
  and otherwise moves the session to waiting with evidence and a takeover link.
- PiAgentRuntime passes modelImage outputs as pi-ai image content when model.input has image;
  the ledger never stores image data; coordinate actions use per-invocation idempotency keys.
- Tests: image codec, runtime image content, E14 e2e (login solved, 2FA stop, step limit,
  sensitive withheld). Real camofox 1.17.0 check on example.com recorded in the runbook.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-29 01:27:48 +08:00
..

@umt/testkit

测试夹具与 mock 服务,只供测试依赖,不进入生产构建:

入口 模拟对象
createMockQb qBittorrent WebUI v2(见下文"落盘")
createMockNexusPhpSite、createMockMteamApi、createMockFetch 观众(NexusPHP)站点页面、馒头 M-Team API(见 src/sites/README.md)
createMockRssServer RSS / Atom Feed(见 src/rss/README.md)
createMockTmdb TMDB v3(api_key 与 Bearer 两种鉴权,fault() 注入 429/5xx/延迟)
createMockEmby Emby / Jellyfin(flavor),/Users、/Items、`/Shows/{id}/Seasons
createMockCamofox camofox-browser(tabs / navigate / snapshot / screenshot,可选 accessKey;快照里故意带密码、Cookie、passkey 供脱敏测试)
createTempTree 临时目录树(可写库根哨兵)

mock qB 落盘

createMockQb() 默认只改内存状态。e2e 需要"下载完成 → Copy 入库"时:

const qb = await createMockQb();
// files 的 path 相对任务 save_path(多文件种子含根目录);写随机内容,大小与清单一致,返回绝对路径
const paths = await qb.complete(hash, { files: [{ path: "Show.S01/Show.S01E01.mkv", size: 4 * 1024 * 1024 }] });
  • createMockQb({ materializeFiles: true }) 让所有 complete() 按现有文件清单落盘;单次总量上限 maxMaterializeBytes(默认 64 MiB)。
  • torrents/delete 带 deleteFiles=true 时同步删除落盘文件和因此变空的目录(不越过 save_path)。
  • save_path 请用临时目录(mkdtemp),不要用 /downloads 这类真实路径。