Files
UHD_Media_Tool/packages/testkit
rootandClaude Opus 5.5 838aea3ebd feat(browser): self-heal sessions after camofox restarts (BR-3)
- Any session operation that hits 404/410 (or finds no open tab) reconciles
  tabs; if none survive it re-injects the account cookies (BR-2), opens a new
  tab under the same userId/sessionKey, returns to the recorded URL (site home
  otherwise), marks old tabs lost and retries the operation once. Failure
  returns 503 browser_reconnect_failed with the reason, with a 10s backoff.
- Restart detection: umt plugin GET /umt/instance (fallback /health fields);
  a changed instance id marks every open session needsReconnect.
- POST /browser/sessions/{id}/reconnect (idempotent); session view exposes
  needsReconnect and reconnect {status, trigger, at, reason, humanNotice}.
- Controller and lease are kept; reconnecting during takeover asks the human
  to double-check the reloaded page.
- Web: screenshot and desktop modes show "reconnecting", auto-reconnect once,
  pause polling, offer a reconnect button with the reason on failure; desktop
  mode rebuilds the Selkies connection after a reconnect.
- Mock camofox restart(), tests, smoke step and runbook section 10.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-29 17:29:11 +08:00
..
2026-09-29 03:27:14 +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 这类真实路径。