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]>
3.2 KiB
3.2 KiB
name, title, description, triggers, capabilities, sessions
| name | title | description | triggers | capabilities | sessions | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| import-troubleshoot | 入库 / 整理问题排查 | 查一部作品为什么没入库、整理为什么失败、为什么认错作品，给出卡在哪一步和怎么处理。用户问「为什么 X 没入库」「整理失败了」「认错片了」时用。 |
|
|
|
适用意图
- 「为什么《沙丘 2》没入库」「昨天下的剧怎么还没进库」「整理失败了」「这个文件认成别的片了」。
步骤
- 定位作品：inventory.query（写作品名）看收录版本是否已满足、有没有已入库文件。已满足就直接回答「已经入库」并写文件位置。
- 找下载：download.list 按作品名查这部作品的下载任务。没有下载任务就说明「还没下载」，并说是没找到资源还是没提交（看订阅 / 收录版本状态）。
- 看卡在哪：对相关的那个下载任务调用 download.inspect，按顺序判断：
- 还在下载 / 无进展 → 汇报进度和最近进展时间；
- 已完成待整理 / 整理中 → 看关联的核验入库任务（task.inspect 看错误）；
- 入库失败 → 读整理记录和错误，一句话说原因；
- 有「没识别出作品」的待处理事项 → decision.list 确认，说明要用户指定作品。
- 身份问题：资源还没对上作品时可以用 identity.resolve 提出映射；TMDB 查不到的作品，网页搜索开启时用 metadata.enrich 出建议。整理要用的资源连常规识别也对不上作品时，用 metadata.resolve_organize 补全译名重查 TMDB，仍没有合适条目才建立带来源证据的本地作品。
- 需要重新整理时：organize.plan 生成计划（不动文件），再 organize.execute。
需要批准
- organize.execute（执行整理）、identity.resolve（身份映射）需要授权；没有授权时写一句「没做：重新整理，需要你批准」。
- organize.plan、查询类不需要批准。
汇报模板
《沙丘：第二部》还没入库：下载已完成（昨天 22:10），整理时目标目录「电影」不可访问，入库失败。检查媒体库目录挂载后，在下载页点「重新整理」。
《沙丘：第二部》还在下载，进度 63%，最近进展 5 分钟前；下完会自动整理入库。
- 第一句写结论（卡在哪一步），第二句写原因或进度，第三句写用户要做的事（如有）。
不要做
- 不要向用户要下载任务 ID、种子 hash 或任务 ID：先 download.list 再 download.inspect。
- 业务任务 ID 用 task.inspect，下载任务 ID 用 download.inspect，不要混用。
- 不要猜原因：记录里没有的写「原因未确认」。
- 不要把整理记录路径以外的内部字段（状态码、fingerprint、ID）写进汇报。