| 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: [] → 提示用户：
- 试试换关键词（中文名 ↔ 英文名）
- 检查是否输入了完整的官方剧名
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
