Files
UHD_Media_Tool/packages/testkit
rootandClaude Opus 5.5 abc69886ea feat(contracts,server,web): files G6–G8 fields and identify S-7 contract
- G6: FileRoot.pendingCount/pendingPartial for download roots (same rule as the
  unidentified filter, recursive, cached 5 min, invalidated by files.changed)
- G7: FileEntry.parsedHint from parseReleasePath (file + parent dirs); the web
  subline uses it and no longer parses names itself
- G8: FileIdentifyCandidate.posterUrl (TMDB poster_path via adapter and
  catalog.lookup, local entities from metadata.posterPath); thumbnails in the
  identify panel
- S-7 contract: FilesIdentifyResult.remoteTaskId/remotePending,
  MediaServerInventory.partial, EventType identify.completed with
  IdentifyCompletedPayload; identify panel (useIdentifyLive) and organize wizard
  merge remote results by root + path, buffering events that beat the response

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-28 20:09:29 +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 这类真实路径。