rootandClaude Opus 5.5
521c86d730
虚拟前缀 /@alist/… 读到本地是 ENOENT,但 mkdir -p、复制 / 移动目标、写文件、回收站落点会在本机真建出 /@alist 并写入文件。统一守卫:任何本地写类操作参数是虚拟路径即抛 REMOTE_PATH_ON_LOCAL_FS (remote_path_on_local_fs),不落盘。 - adapters:fs/remote-guard.ts,接在 runFsOp、FsProxy.run(父进程拒绝不起子进程)、copyWithVerify、 crossDeviceMove、moveSafe、commitNoClobber、sweepStalePartials、writeRootSentinel - server:storage/local-fs.ts 带守卫的写函数,整理 / 替换 / 刮削 / 回收站 / 上传 / 字幕 / vfs 本地分支改用它 - 补字幕目标在 Alist 媒体库上返回失败原因,撤销同样拒绝 Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei
@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)。