rootandClaude Opus 5.5
ceb66f8c77
生产 v0.3.8～v0.3.13 均由 8013196 加工作区修改构建部署，此前未提交；本提交补齐源码，
并含未部署的 v0.3.14 原地入库。中间各版本源码状态未保存，无法逐版拆分，详见
docs/plan/17-full-upgrade.md 与 docs/plan/18-organize-release.md。
- v0.3.8 全面升级：Deno workspace 依赖、Router 8 / Vite 8、camofox 1.18.0 / Node 24、
PostgreSQL 18.6、备份客户端 18.6、演示 qB 5.2.4
- v0.3.9 媒体整理：分类规则、整理来源与目录快照（0059）、文件管理整理入口
- v0.3.10 手动下载与入库：独立手动下载、详情页资源下载、TMDB / Local 元数据兜底
（metadata.resolve_organize）、正常多版本 / 一次性洗版（0060）
- v0.3.11 搜索详情与桌面黑边修复
- v0.3.12 列表分页、搜索历史、首页概况
- v0.3.13 统一整理弹窗与队列
- v0.3.14 原地入库（0061，未部署）
同批审计修复：
- 刮削入队：确认原记录存在后才删重放产生的新记录；写回 run 关联失败时保持 queued，
由处理器补关联（对齐 MP 先登记、只在入队失败时记失败）
- 识别升级链只在结果更确定时采用，不再用 no_match 顶替原有歧义候选
- bluray_dir 资产以原盘目录本身为刮削根（MP 同做法）
- metadata.resolve_organize 登记到入库排障 Skill 与能力地图
- db/src/types.ts 按迁移重新生成；contracts 整理动作枚举顺序与数据库对齐
- 测试：原地入库用例改为直接查记录表；domain 测试模板补 version
- 前端：通知铃铛弹层与用户菜单统一样式；站点卡片共用卡头、底栏贴底、分页间距
依赖升级证据只提交摘要文件，registry-snapshot.json 移至 .local/（SHA-256 记于文档）。
Co-Authored-By: Claude Opus 5.5 <[email protected]>
@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)。