pan-drama-subtitle-search

name	pan-drama-subtitle-search
description	Language-learning SOP: query expansion, pan_drama_search for videos, subtitle_search + episode_match for pairing. Learning use only. Trigger on 找剧/搜剧/带字幕/学英语/练听力.

带字幕剧集网盘搜索

帮学外语的人找「视频 + 能对轴字幕」。仅用于语言学习，不是观影推荐。

脚本目录：~/.cursor/skills/pan-drama-subtitle-search/scripts/

---

步骤 1：用户输入 + Query 泛化

Agent 做。 提取剧名、季、集。

泛化只做 3 类 query（不要展开更多变体）：

query	示例
中文 + 字幕	绝命毒师 字幕
英文 + 字幕	Breaking Bad 字幕
带季集（可选）	绝命毒师 S01E01 字幕

传给脚本：show（中文主名）+ --sub-query（英文原名）。脚本最多试 4 条 query，避免搜太久。

---

步骤 2：搜视频

脚本：pan_drama_search.py

python3 ~/.cursor/skills/pan-drama-subtitle-search/scripts/pan_drama_search.py search "绝命毒师" \
  --sub-query "Breaking Bad" \
  --season 1 --episode 1 \
  --top 10 --limit 80 \
  --no-require-subtitle

参数	说明
show	主剧名
--sub-query	英文原名（与 show 组成中英文 + 字幕 query）
--season / --episode	季集
--top	返回条数，默认 10
--limit	搜索候选池，默认 80
--drives	仅用户指定时才加，如 quark,aliyun
--no-require-subtitle	先广搜视频，字幕在步骤 3 配

做什么： 调 PanSou 聚合搜夸克/阿里/百度等 → 多 query 合并去重 → 校验链接（失效丢弃）。

返回看： results[]（含 url、disk_type、note、validation）、keywords_tried。

调试：pan_drama_search.py preflight 检查 PanSou 是否可用。

---

步骤 3：搜字幕 + 与视频配对校对

脚本：subtitle_search.py（搜字幕池）+ episode_match.py（逐视频配对）

3a 搜该集字幕

python3 ~/.cursor/skills/pan-drama-subtitle-search/scripts/subtitle_search.py find-episode "Breaking Bad" \
  --sub-query "绝命毒师" \
  --season 1 --episode 1 \
  --languages zh,en --top 50

依赖本地 opensubtitles-scraper（:8000）。先检查：

python3 ~/.cursor/skills/pan-drama-subtitle-search/scripts/subtitle_search.py preflight

返回看： subtitles[]（字幕候选池）、query_used、queries_tried。

3b 逐视频配对 + 版本校对

对每个步骤 2 的视频，在字幕池里用 match_score 选最能对轴的：

信号	加分
SxxExx 一致	+40
1080p 等分辨率一致	+15
WEB-DL / BluRay 一致	+12
发布组一致	+8
文件名重叠	+20
BluRay↔WEB 交叉	-8

同分享内已有 .srt/.ass 优先于 OpenSubtitles。

生产用法（2+3+4 一步跑）：

python3 ~/.cursor/skills/pan-drama-subtitle-search/scripts/episode_match.py match "绝命毒师" \
  --sub-query "Breaking Bad" --season 1 --episode 1 --top 10

内部依次调 pan_drama_search.py search → subtitle_search.py find-episode → 逐视频 match_score 配对。

返回看： pair_rows[]（每行视频+字幕+match_confidence+match_reasons）、subtitle_service（是否为 ok）。

---

步骤 4：整理输出（统一格式）

优先直接用 episode_match.py 返回的 display_sections；手工整理时必须遵守本规范。

4.1 结构（固定顺序）

标题（剧名 + 季集）
├── 搜索摘要（可选，1 行）
├── 一、视频 + 同分享字幕文件
├── 二、视频 + 配对字幕链接
├── 三、MKV 可能内封字幕
└── 学习提醒 + 正版指路（步骤 5）

某段无结果 → 整段省略，不要留空表。

4.2 字段规范

规则	说明
链接	必须是可点击 URL，禁止只给文件名
网盘	链接文字用 [夸克] [阿里] [百度] 等，禁止只写「打开」
提取码	仅当存在时加「提取码」列；无码不加列、不写「无」
字幕	一、二段每行必须有字幕链接；三段 MKV 右侧也要有备用字幕链接
匹配度	high / medium / low，low 须配一句「可能对不上」说明
说明	每行表格下方可跟 1 行 匹配说明，来自 note + match_reasons

4.3 表格列（固定）

一段（同分享字幕）：

| # | 说明 | 网盘 | 字幕链接 | 匹配度 |

二段（配对字幕）：

| # | 说明 | 网盘 | 字幕下载 | 类型 | 匹配度 |

三段（MKV 内封）：

| # | 说明 | 网盘 | 如何自查 | 若无内封→下载字幕 | 匹配度 |

有提取码时，在「网盘」后插入 | 提取码 | 列。

4.4 完整 Case：《绝命毒师》S01E01

《绝命毒师》Breaking Bad · S01E01

一、视频 + 同分享字幕文件（最优先）

#	说明	网盘	字幕链接	匹配度
1	1080p WEB-DL 全五季，分享内外挂中英	夸克	中文 · 英文	high

#1 同分享内同名 .mkv + .zh.srt / .en.srt，可直接外挂。

二、视频 + 配对字幕链接

#	说明	网盘	字幕下载	类型	匹配度
2	1080p BluRay x265 单集	阿里	中文 · 英文	中+英	medium

#2 视频 BluRay，字幕来自 WEB-DL（version-mismatch），时间轴可能需 VLC 微调。

三、MKV 可能内封字幕（请你自查）

#	说明	网盘	若无内封→下载字幕	匹配度
3	1080p 全五季，标题写内封简英	夸克	中文 · 英文	low

#3 VLC 字幕→子轨道自查；有内封不用下外挂。备用字幕可能对不上。

---

📚 学习用途说明 — 仅供语言学习。观影请支持正版（Netflix / Apple TV+ 等）。

4.5 禁止

• ❌ 只给视频列表、字幕另起一段让用户自己配
• ❌ 一段/二段某行没有字幕列
• ❌ 提取码写「无」
• ❌ 网盘链接不标注平台名
• ❌ 把 MKV 整季合集放最上却不给字幕

---

步骤 5：学习提醒 + 正版指路

输出末尾必须加：

以上仅供语言学习，请勿传播。纯观影请支持正版——
国内： {查到的平台，如腾讯/优酷/爱奇艺/B站，没有则说明}
国际： Netflix / Apple TV+ 等

Agent 主动查该剧国内是否有正版。

---

参考

know-how.md — Query 泛化细节、MKV 自查、常见坑