Files
UHD_Media_Tool/packages/adapters
rootandClaude Opus 5.5 ceff9cf51f feat(ao): W4-E3 manual organize guard, series completion, engine retry, v0.1.0
- POST /organization-records: sourcePaths must resolve (realpath) under a
  registered library_root or downloader path-mapping host path; `..` and
  symlink escapes rejected (400), dryRun included. Move requires an admin
  session, or an API key with an automation_grant covering the entity or a
  matching one-time approval (consumed on use), else 403. Manual Move from a
  managed download_task with unsatisfied H&R returns 409 and opens a
  decision; never silently downgraded to Copy.
- Series slot completion: total episode count is unknown while units are
  provisional, so the slot is not satisfied and the subscription keeps
  tracking; coverage is registered per actual file (creating provisional
  episode units), and already_in_library files count as verified presence.
- POST /engine/runs/{id}/retry (admin): re-enqueue by original task name and
  raw input with idempotency key retry:<id>:<n>, audited; retry button on
  the run detail page.
- E7 regular series e2e, E8 AT24 tag removal / task disappearance e2e.
- All workspace members and root set to version 0.1.0; CHANGELOG.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-27 22:47:11 +08:00
..

@umt/adapters

外部系统适配层:qBittorrent、RSS、站点(观众 NexusPHP / 馒头 API)、TMDB、Emby 兼容服务器、浏览器服务与文件系统。对上只暴露端口接口,凭证经 secret reference 注入,日志一律脱敏(键表与规则取 @umt/contracts 的 redact.ts)。

包入口 src/index.ts 逐个 export * 下列子模块:

子模块 主要入口 说明
qbittorrent createQbClient / QbClient、DownloaderRegistry、assertSafeToDeleteData、mapQbState qB WebUI v2:提交、标签接管、暂停/恢复、带安全校验的删数据
rss createRssFetcher、applyFeedItems、redactUrl、buildRssLinkRequest RSS 2.0 / RDF / Atom 抓取解析、条件请求、退避熔断、去重
sites createSiteAdapter / getSiteAdapter、listSiteDefinitions、siteFetch 观众(NexusPHP 配置驱动 spider)与馒头 M-Team API
tmdb createTmdbClient / TmdbClient、matchTmdb、matchTmdbMulti、TmdbError 多语言搜索、详情、季集;缓存限流;错误信息不带 api_key
emby createEmbyClient / EmbyClient、MediaServerRegistry Emby / Jellyfin 库存查询,失败返回 unknown 而不是"不存在"
fs copyWithVerify、moveSafe、crossDeviceMove、checkRoot、scanIncremental、diskUsage、ffprobe 校验复制、跨卷移动、库根哨兵、增量扫描
browser BrowserProvider 合同、createNoneBrowserProvider、camofox 适配骨架、redactBrowserUrl 浏览器服务接口(M1 只有接口与骨架)

测试:deno task test(vitest,外部服务全部用 @umt/testkit 的 mock)。