Files
UHD_Media_Tool/packages/adapters
rootandClaude Opus 5.5 19f7bd0330 fix(download): 下载器离线与下载目录读不到容量开待处理,季包暂停添加后选文件
- M5:单个下载器连续 10 分钟连不上开 downloader_offline(按实例去重),恢复连接后自动关闭
- M3:下载目录读不到容量按卷开 critical 的 cache_volume_unknown,读到后关闭;面板单独显示
  「下载目录读不到」不再归为等空间;cache.threshold 不再把未知当 0%
- M4:季包 / 多集包 .torrent 暂停添加、磁力用「拿到元数据后停止」,选完文件再恢复;文件清单
  拿不到时留给同步重试,超过 10 分钟整包下载并记 file_list_timeout
- L1:提交 commit 时锁计划复核仍是 reserved,被取消的不写回 submitted,qB 里刚加的任务暂停、
  去掉管理标签并打 <管理标签>-cancelled
- L3:已收单未确认的提交在同步首次看到任务时补调 afterDownloadAccepted
- L4:排队中(queuedDL)的纳管任务一并受阈值暂停
- L6:停用的下载器上还有在下的任务时仍同步这些任务(不接管新任务、不开离线事项)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei
2026-10-03 23:20:29 +08:00
..
2026-10-03 21:49:03 +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、FsProxy;另有子路径导出 @umt/adapters/fsworker(fsWorkerMain,供 --role fsworker) 校验复制、跨卷移动、库根哨兵、增量扫描;FsProxy 把文件操作放进可杀子进程(挂死 → SIGKILL → TIMEOUT)
browser BrowserProvider 合同、createNoneBrowserProvider、camofox 适配骨架、redactBrowserUrl 浏览器服务接口(M1 只有接口与骨架)

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