pan-resource-search

name	pan-resource-search
description	网盘资源搜索：搜剧/搜电影/搜番剧，按画质和文件大小排序推荐。 不搜字幕，纯找网盘里的视频资源。 触发词：找资源、搜网盘、搜剧、搜电影、网盘资源、找下载。

网盘资源搜索

在网盘里搜视频资源（剧集、电影、番剧等），按画质和文件大小排序推荐。 不含字幕搜索，只是帮你找到最合适的视频资源。

脚本复用：~/.cursor/skills/pan-drama-subtitle-search/scripts/pan_drama_search.py （搜索逻辑不变，但本 Skill 只用搜索能力，不用字幕和配对）

---

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

Agent 做。 提取剧名/电影名；季/集仅当用户明确说了再提取（如「第一季」「S01E01」），不要擅自加。

泛化只做下面几类（不要空格/点号/别名等额外变体）：

顺序	query	示例
1	用户原始说法	帮我找绝命毒师 → --keyword 原样传入
2	中文官方名	绝命毒师 → show
3	英文/原语言官方名	Breaking Bad → --sub-query
4	仅用户明确指定季集时，正式剧名 + SxxExx	加 --with-episode-query --season 1 --episode 1

默认不加 SxxExx 到搜索词（即使用户口语里有「第一季」，也靠 --keyword 覆盖，不要擅自拼 S01E01）。

传给脚本：show + --sub-query + 可选 --keyword。通常 4~6 条 query。

---

步骤 2：搜视频

脚本：pan_drama_search.py（复用原有脚本）

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

参数	说明
show	中文官方剧名
--sub-query	英文/原语言官方名（可逗号分隔多个）
--keyword	用户原始说法
--top	返回条数，默认 20（比原 skill 多，因为不过滤字幕）
--limit	搜索候选池，默认 80
--drives	仅用户指定网盘时才加，如 quark,aliyun
--no-require-subtitle	必须加，不按字幕过滤结果

做什么： 调 PanSou 聚合搜夸克/阿里/百度/迅雷/123/115 等 → 多 query 合并去重 → 校验链接（失效丢弃）→ 拉取夸克/阿里内文件列表用于分析。

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

---

步骤 3：分析 & 排序 → 三级输出

Agent 做。 拿到脚本返回的 JSON 后，按以下三级优先级重新组织结果：

优先级规则

1. 🥇 视频 + 字幕文件（同分享内同时有 .mkv/.mp4 和 .srt/.ass）
2. 🥈 MKV 格式（按画质/大小排序，选一个最佳推荐）
3. 🥉 其他视频格式（MP4、AVI、TS 等）

「视频 + 字幕文件」 = 分享里同时有视频文件（.mkv / .mp4）和独立的字幕文件（.srt / .ass），不是 MKV 内封字幕。 只有文件列表里确实能看到 .srt / .ass 文件的才算一级。

---

3.1 判断是否「视频 + 字幕文件」（一级）

关键：是分享里同时有视频文件（.mkv / .mp4）和独立的字幕文件（.srt / .ass），不是 MKV 内封字幕。

从 files.detail.files[] 判断：

• 文件列表里同时存在 .mkv/.mp4 视频文件和 .srt/.ass 字幕文件 → 属于一级
• 仅看文件名列表确认，不依赖标题里的「内封」「双语」等文字

也可以用 subtitle_analysis 辅助判断：

• subtitle_mode 为 "paired" 或 "external"，且 subtitle_count > 0 → 确认有字幕文件
• subtitle_mode 为 "mkv_unverified" 且 subtitle_count == 0 → 只是 MKV，没有独立字幕文件，降为二级

如果没有符合条件的（没有任何分享里同时有视频+字幕文件），整个一级省略不输出。

---

3.2 MKV 文件分析（二级）

对 files.detail.files[] 中文件名以 .mkv 结尾的资源，做以下分析：

a) 提取画质信息（从 note 和文件名）

标签	含义	优先级
2160p / 4K / UHD	4K 超高清	最高
1080p / FHD	全高清	高
720p / HD	高清	中
480p / SD	标清	低

来源标签	含义
BluRay / Blu-ray / BD	蓝光原盘压制，画质最佳
REMUX	蓝光无损提取，画质=原盘，体积最大
WEB-DL / WEBRip	流媒体下载，画质好
HDTV	电视录制，画质一般
AMZN / NF / DSNP	Amazon/Netflix/Disney+ 片源

编码标签	含义
x265 / HEVC	H.265 编码，同画质下体积更小
x264 / AVC	H.264 编码，兼容性好
HDR / DV / Dolby Vision	高动态范围，色彩更好

b) 看文件大小

从 files.detail.files[] 的 size 字段获取（单位：字节）。

• 单集电影：合理范围 2GB–15GB（4K REMUX 可达 30GB+）
• 整季合集：按集数估算，每集约 1GB–5GB
• 如果一个分享文件数很多但单个很小 → 可能是低码率版本

c) 选择最佳推荐

综合画质 + 来源 + 编码 + 大小，选一个最适合推荐的放在最上面，并解释选择理由：

推荐： 选 1080p BluRay x265 版本（约 3GB/集），画质和体积平衡最好。 如果你追求极致画质，可以选下面的 4K REMUX 版本（约 25GB/集）。

d) 对比说明

列出其他 MKV 版本，说明它们与推荐的有什么区别：

• #2 是 4K REMUX（~25GB），画质比 #1 好但体积大 8 倍，适合收藏
• #3 是 720p HDTV（~800MB），画质一般但省空间，适合移动设备
• #4 是 1080p WEB-DL x264（~5GB），兼容性比 x265 好但体积更大

---

3.3 其他视频格式（三级）

非 MKV 格式（.mp4、.avi、.ts、.m2ts 等）排在最后。同样按画质排序，简单说明格式差异。

---

步骤 4：输出格式

4.1 结构（固定顺序）

📺 剧名 / 电影名（可选：季集信息）
├── 搜索摘要（1 行：搜到多少个有效分享）
├── 🥇 视频 + 字幕捆绑（如果有）
├── 🥈 MKV 推荐 & 对比
├── 🥉 其他视频格式
└── 提示

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

4.2 字段规范

规则	说明
链接	必须是可点击 URL，禁止只给文件名
网盘	链接文字用 [夸克] [阿里] [百度] [迅雷] [123] [115] 等
提取码	仅当存在时加「提取码：xxxx」；无码不写
大小	换算为可读单位（GB / MB），标注是单文件还是合集
画质/来源	从 note/文件名提取：2160p / 1080p / 720p，BluRay / WEB-DL / HDTV 等

4.3 完整 Case：《绝命毒师》

## 📺 《绝命毒师》Breaking Bad · 全五季

> 共搜到 18 个有效分享，以下按画质和实用性排序。

---

### 🥇 视频 + 字幕捆绑（下载即用）

| # | 说明 | 网盘 | 大小 | 字幕 |
|:--:|------|:----:|------|------|
| 1 | 1080p WEB-DL x265 全五季，内封中英字幕 | [夸克](https://pan.quark.cn/s/xxxx) | ~35GB | .srt 中英 |

> **#1** 分享内同时有 `.mkv` 视频和 `.zh.srt` / `.en.srt` 字幕文件，下载后直接外挂即可。

---

### 🥈 MKV 版本 · 画质对比

> **🏆 推荐 #2**：1080p BluRay x265，画质好体积适中，是最均衡的选择。

| # | 说明 | 网盘 | 大小 | 推荐理由 |
|:--:|------|:----:|------|----------|
| 2 | 1080p BluRay x265 全五季 | [阿里](https://www.alipan.com/s/yyyy) | ~45GB | 蓝光画质 + H.265 编码，画质与体积最佳平衡 |
| 3 | 4K REMUX 全五季 | [夸克](https://pan.quark.cn/s/zzzz) | ~250GB | 极致画质，每集约 4GB，适合收藏党 |
| 4 | 1080p WEB-DL x264 全五季 | [百度](https://pan.baidu.com/s/1xxxx) | ~60GB | H.264 编码兼容性好，但比 #2 体积大 30% |

> **#2 vs #3**：#3 是 4K 蓝光无损（REMUX），画质最好但体积是 #2 的 5 倍。除非你有 4K 屏幕且硬盘够大，否则 #2 足够。
> **#2 vs #4**：#2 用 H.265 编码，同 1080p 画质下体积比 #4（H.264）小约 25%，是更好的选择。

---

### 🥉 其他视频格式

| # | 说明 | 网盘 | 大小 | 格式 |
|:--:|------|:----:|------|:----:|
| 5 | 1080p WEB-DL 全五季 | [迅雷](https://pan.xunlei.com/s/xxxx) | ~55GB | MP4 |
| 6 | 720p HDTV 全五季 | [123](https://www.123pan.com/s/xxxx) | ~18GB | AVI |

> **#5** MP4 格式兼容性好，适合手机/平板直接播放，但画质不如 MKV 蓝光版本。
> **#6** AVI 格式较老，720p 画质一般，适合小存储设备。

---

> 💡 **提示：** 以上资源来自公开网盘搜索，链接可能随时失效。下载后请自行检查画质和完整性。

4.4 禁止

• ❌ 只给列表不解释画质差异
• ❌ MKV 和 MP4 混在一张表里
• ❌ 推荐不说理由
• ❌ 提取码写「无」
• ❌ 网盘链接不标注平台名
• ❌ 大小不换算，直接写字节数

---

步骤 5：Agent 处理要点

5.1 搜索结果为空时

脚本返回 results: [] → 提示用户：

• 试试换关键词（中文名 ↔ 英文名）
• 检查是否输入了完整的官方剧名

# 可先 preflight 确认 PanSou 可用
python3 ~/.cursor/skills/pan-drama-subtitle-search/scripts/pan_drama_search.py preflight

5.2 搜索范围太小

如果 --top 20 结果太少，Agent 可以自动扩大搜索：

• 先广搜合集（不加 --with-episode-query）
• 如果用户指定了季，再加 --with-episode-query 精确搜

5.3 多季搜索

用户只说剧名没指定季 → Agent 先搜一次看结果中有哪些季，再逐季搜。

每季可以并行搜索，提高效率：

for season in 1 2 3 4 5; do
  python3 ~/.cursor/skills/pan-drama-subtitle-search/scripts/pan_drama_search.py search "绝命毒师" \
    --sub-query "Breaking Bad" \
    --with-episode-query --season $season --episode 1 \
    --top 10 --limit 80 \
    --no-require-subtitle &
done
wait

5.4 画质/来源识别关键词

Agent 解析 note 和文件名时，关注这些关键词：

画质：2160p, 4K, UHD, 1080p, FHD, 720p, HD, 480p, SD
来源：BluRay, Blu-ray, BD, REMUX, WEB-DL, WEBRip, HDTV, AMZN, NF, DSNP, HBO, Hulu, AppleTV+
编码：x265, HEVC, x264, AVC, HDR, DV, Dolby Vision, HDR10, SDR, 10bit
音频：DTS, DTS-HD, TrueHD, Atmos, AAC, AC3, FLAC
封装：MKV, MP4, AVI, TS, M2TS, MOV, WMV

---

参考

• 原有 Skill（含搜索脚本）：~/.cursor/skills/pan-drama-subtitle-search/
• 搜索脚本：~/.cursor/skills/pan-drama-subtitle-search/scripts/pan_drama_search.py
• 本 Skill 的 know-how：~/.cursor/skills/pan-resource-search/know-how.md