feat: v0.3.8–v0.3.14 工作区汇总（依赖升级、整理来源、手动入库、原地入库等）

生产 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]>

docs/runbook/backup-restore.md

@@ -18,41 +18,41 @@
 先写到 `.<时间戳>.partial/`,全部成功才改名,不会留下半截备份。`BACKUP_KEEP=N`(compose 缺省 14)时只保留最近 N 份。
 
 **SECRET_MASTER_KEY 不在备份里。** 它和备份必须分开保管:备份泄露时密文仍然安全;主密钥丢失时备份里的站点/下载器/模型凭证无法解密(需要重新录入)。
-恢复到新机器时,`.env` 里的 `SECRET_MASTER_KEY` 必须与备份时一致。
+恢复到新机器时,`.env.deploy` 里的 `SECRET_MASTER_KEY` 必须与备份时一致。
 
 ## 日常备份
 
 ```sh
-docker compose exec app umt backup                              # 在线备份(pg_dump 一致性快照,不停服)
-docker compose exec app ls /data/backups
+docker compose --env-file .env.deploy exec app umt backup                              # 在线备份(pg_dump 一致性快照,不停服)
+docker compose --env-file .env.deploy exec app ls /data/backups
 # 拷到机器外(示例):
-docker compose cp app:/data/backups/20260927T120000Z ./offsite/
+docker compose --env-file .env.deploy cp app:/data/backups/20260927T120000Z ./offsite/
 ```
 
-定时:宿主 cron `0 4 * * * cd /opt/umt && docker compose exec -T app umt backup >> /var/log/umt-backup.log 2>&1`。
-单独导出映射清单:`docker compose exec app umt export-mappings`(写到 `/data/exports/`)。
+定时:宿主 cron `0 4 * * * cd /opt/umt && docker compose --env-file .env.deploy exec -T app umt backup >> /var/log/umt-backup.log 2>&1`。
+单独导出映射清单:`docker compose --env-file .env.deploy exec app umt export-mappings`(写到 `/data/exports/`)。
 
 ## 恢复
 
 恢复会删除并重建备份里的全部对象。**先停 app**,脚本检测到库里还有其它连接会拒绝(`--force` 可跳过,不建议)。
 
 ```sh
-docker compose stop app
-docker compose run --rm --no-deps app restore 20260927T120000Z --yes   # 或绝对路径 /data/backups/...
-docker compose up -d app
+docker compose --env-file .env.deploy stop app
+docker compose --env-file .env.deploy run --rm --no-deps app restore 20260927T120000Z --yes   # 或绝对路径 /data/backups/...
+docker compose --env-file .env.deploy up -d app
 ```
 
 `restore.sh` 依次:
 
 1. 校验 `SHA256SUMS`;
-2. `pg_restore --clean --if-exists --no-owner` 生成 SQL,经 `psql --single-transaction -v ON_ERROR_STOP=1` 回放(失败整体回滚,库保持恢复前状态)。镜像里是 17 版客户端,回放前去掉 16 版服务端不认识的 `SET transaction_timeout`;
+2. `pg_restore --clean --if-exists --no-owner` 生成 SQL,经 `psql --single-transaction -v ON_ERROR_STOP=1` 回放(失败整体回滚,库保持恢复前状态)。当前镜像使用 18.6 客户端,支持 PG18 备份;回放前仍过滤 `SET transaction_timeout`,以兼容回滚到 PG16;
 3. 还原 `agent-sessions.tar.gz`;
 4. `--role read-only-on`:把 `automation.readOnlyReconcile` 置为 true(保留 automation 其它字段),写审计 `ops.read_only_reconcile_on`;
 5. 重新导出映射清单到 `DATA_DIR/tmp/restore-check-*.json`,逐表与备份里的 `counts` 比对,不一致以退出码 3 结束;
 6. 打印"恢复后先对账再关闭只读"提示。
 
-从别的机器恢复:把备份目录拷进目标机器的 `umt-data` 卷(`docker compose cp ./20260927T120000Z app:/data/backups/`),
-`.env` 用原来的 `SECRET_MASTER_KEY`,空库上照上面的命令执行。备份早于当前镜像版本时,`up -d app` 会自动跑后续迁移。
+从别的机器恢复:把备份目录拷进目标机器的 `umt-data` 卷(`docker compose --env-file .env.deploy cp ./20260927T120000Z app:/data/backups/`),
+`.env.deploy` 用原来的 `SECRET_MASTER_KEY`,空库上照上面的命令执行。备份早于当前镜像版本时,`up -d app` 会自动跑后续迁移。
 
 ## 恢复后:先对账,再关闭只读