Files
UHD_Media_Tool/packages/adapters
rootandClaude Opus 5.5 6e9e8efec2 fix(sites): HHClub parsing, resource list layout and request restraint (re-landed)
Re-lands 901b01d, which was reverted wholesale by 28974d1 (BR-2 committed
from the shared index). The agent UI files 901b01d had rolled back are
left at their AGUI-2 versions; contracts, routes, db types and the runbook
part already reached main through later commits, so this carries the rest.

HHClub (憨憨) was checked read-only against a real account (one detail
request; list, user data and health came from the product's own fetch).

Parsing fixes:
- list titles carried the site's new-torrent marker "[新]" (58 of 100
  rows; the detail page title has none); stripped with a replace filter
- refreshing a detail overwrote seeders / leechers / snatched / category
  name / H&R with null because the HHClub div detail page lacks them;
  detail values now fall back to the list snapshot (mergeDetailOverList),
  and an unknown detail promotion keeps the list promotion
- level "贵宾" is VIP (umt.vipLevels)
- sanitized minimal fixture HHANCLUB_LIST_PAGE_2026 + tests; README marks
  HHClub as verified 2026-09-29
Size, counts, category ids/names, +08:00 time and subtitle were correct.

Request restraint:
- site definitions may carry umt.defaults; merged with settings.sites
  (longer intervals, fewer pages): new settings defaultSnapshotMaxPages 1,
  defaultHealthCheckIntervalSec 6 h, defaultDetailCacheSec 24 h; default
  burst 2. HHClub: snapshot 60 min page 1 only, health 6 h, search
  concurrency 1, detail cache 24 h, 1 token / 3 s burst 2
- periodic / manual snapshots are capped to that page count; scheduled
  health checks skip sites checked within the interval; detail refresh is
  served from cache inside the window; live searches on one site queue
- every rate-limiter token is counted per site per hour
  (site_request_count, migration 0046); GET /sites/{id}/request-stats;
  site overview and resource list show requests in the last 24 hours

Resource list: two-layer rows. Main line: title + spec tags (episodes,
resolution, source, codec, HDR, group, 国语/中字, site tags) + promotion
with time left + H&R. Second line: subtitle (one line, ellipsis) and
fixed-width category / size / seed-leech-snatched / upload time
(relative, absolute on hover) columns, stale badge, inventory overlay;
folds into a card on phones.

Also aligns identity_candidate.normalized_title order in db types with
the migrations (schema drift test).

Takes effect after the stack is rebuilt (migration 0046).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-29 16:00:34 +08:00
..
2026-09-29 03:27:14 +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)。