电影/电视剧/动画下载全流程:TMDB 消歧与详情 → Torznab 选种 → qBittorrent 添加并带 MOVIEPILOT 标签。在用户要下载影视内容时使用;需配合 opcli(tmdb / torznab / qbt)与 opserver。
在用户口述一部电影、电视剧或动画并希望下载时,按下列顺序执行。工具细节见同目录下的 opcli-tmdb、opcli-torznab、opcli-qbittorrent;**列表型终端输出(TOON)**见 toon-format。
中文环境下同名、同译名、不同片很常见,不要直接用口语片名去搜种。
tmdb.search:电影默认 movie,剧集/动画用 tv。tmdb.search 结果字段含义与原 JSON 一致(标题/名称、概述、首映或首播日期、id 等);不含完整演职员。若需向用户展示导演、主演以便选择,对候选条目调用 tmdb.details <id> <movie|tv>(含 credits):
release_date 年份;剧集看 first_air_date(或结合 last_air_date)。movie / tv 以及详情中的类型字段说明(电影/电视剧/动画等在 TMDB 中的归类)。credits.crew 中查找 job 为 Director 的条目。credits.cast 中排序靠前若干位(如前 3~5)的 name / character。向用户列出差异点:主演、年份、类型(电影/剧集)、导演(以及必要时一两句概述),明确请用户选定一条(对应一个 tmdb_id + movie 或 tv)。在用户确认前不要进入大规模搜种。
用户选定后,用 tmdb.details <tmdb_id> <movie|tv> 获取完整信息,并整理出下一步 Torznab 检索要用的关键词:
number_of_seasons、number_of_episodes、首播日期等;注意各季在发行圈里的标题常与季号不一致,且存在多语言译名。应用 original_title / original_name、英文标题、日文等别名 与季号组合尝试检索(必要时查阅 TMDB 网站对应季的标题,与详情字段交叉核对)。original_title、title、发行年份等,用于英文圈或日文圈资源名匹配。此步骤的目标是:减少搜种时的歧义,并为「按季/按集」下载提供准确检索词。
使用 torznab.search(参数见 opcli-torznab 技能)。在可选项中优先满足(按重要性大致排序,实际以 indexer 上能命中的结果为准):
| 偏好 | 说明 |
|---|---|
| 画质/格式 | 优先 4K、HDR、杜比视界/杜比全景声 等明确标注(以发布名为准) |
| 字幕 | 优先带 中文字幕 或明确 CHS/CHT/简中/繁中 |
| 音轨 | 优先 原声(与原片语言一致),避免无谓配音轨除非用户要 |
| 体积 | 单部电影 尽量 ≤ 20 GiB;电视剧/动画单集 尽量 ≤ 2 GiB(若质量与体积冲突,向用户说明取舍) |
| 费用 | 若索引器或站点涉及 流量/积分/付费,在同等质量下优先 更便宜或免费 的来源 |
| 一致性 | 多集/多季下载时,尽量选 同一字幕组/同一发布组 的命名体系,利于自动化与库整理 |
若无完美匹配,列出最接近的若干候选,简短说明牺牲了哪条偏好,必要时请用户确认。
使用 qbt.add 添加磁力或种子 URL(参数顺序见 opcli-qbittorrent 技能)。
tags 参数必须包含 MOVIEPILOT,供后续自动化(如 MoviePilot)识别与处理。MOVIEPILOT,4k;不得省略 MOVIEPILOT。示例(路径、分类按用户环境调整):
opcli qbt.add "magnet:?xt=urn:btih:..." "/path/to/save" tv "MOVIEPILOT"
tmdb.search(必要时 movie + tv 双搜)→ 多条则借助 tmdb.details 展示主演、年份、类型、导演 → 用户选定。tmdb.details 确认 ID 对应条目,整理原文名/别名/季集信息作为搜种关键词。torznab.search 按偏好选种,注意体积、费用、字幕组一致性与音画字幕偏好。qbt.add 添加任务,tags 必含 MOVIEPILOT。