PanSou 盘搜 🐉

国内最好的聚合资源搜索引擎，14 种资源类型 + 智能降级 + 混合搜索

资源类型与优先级

搜索策略（核心）

第一阶段：PanSou 网盘搜索（默认）

用户输入 → PanSou API 搜索 → 结果 ≥5 条且质量好 → 直接输出

• 自动链接检测：失效链接过滤掉，有效/需密码/未知状态的保留供用户选择
• 每种类型最多显示 5 条，避免信息过载
• 排序规则：网盘速度优先（迅雷→阿里→115→夸克），同类型内按相关性排序

第二阶段：PanSou 0 结果或质量差 → 降级 SearXNG 磁力搜索

当 PanSou 返回结果少（<5条）或相关度低，自动触发：

# 磁力搜索：搜 magnet:?xt=urn:btih: 前缀，返回含真实磁力链接的页面
# 适用：电影、剧集、软件、动漫
curl -X POST "http://10.1.1.99:8080/search" \
  -d "q=magnet:?xt=urn:btih: 关键词&engines=baidu,sogou,bing&format=json"

# 迅雷搜索：搜 thunder:// 前缀，返回含迅雷链接的页面
# 适用：游戏、软件、大型文件
curl -X POST "http://10.1.1.99:8080/search" \
  -d "q=thunder:// 关键词&engines=baidu,sogou&format=json"

# 电驴搜索：搜 ed2k:// 前缀，返回含电驴链接的页面
# 适用：音频、书籍、老电影
curl -X POST "http://10.1.1.99:8080/search" \
  -d "q=ed2k:// 关键词&engines=baidu,sogou&format=json"

原理：搜索引擎会匹配页面 HTML 中的 magnet: / thunder: / ed2k: 字符串，从而命中带真实下载链接的资源页面。

第三阶段：Hash 定向验证（针对磁力搜索）

从搜索结果提取 magnet:?xt=urn:btih:HASH，用 HASH 直接反查更多源：

# BTIH hash 是资源指纹，同 hash 必同内容
# 在 PanSou 或磁力站输入 hash 可查到做种数，做种数 ≥10 才视为有效
curl -s "http://127.0.0.1:1080/api/search" \
  -X POST -H "Content-Type: application/json" \
  -d '{"kw":"59768c2dcb45d01a27d2a19b31fa2606663c3c53"}'

混合盘搜索（高级玩法）

针对不同资源类型，手动指定优先搜索范围：

场景 1：电影 / 剧集

推荐顺序：磁力(magnet) → 迅雷 → 阿里云盘 → 夸克
原因：磁力直接下载，画质完整，迅雷速度快
关键词技巧：加上分辨率 如"电影名 1080p" 或"电影名 4K"

场景 2：游戏（PC/PS5/Switch）

推荐顺序：迅雷 → 百度网盘 → 阿里云盘
原因：游戏文件大，迅雷盘速度最快，百度资源最全
关键词技巧：加平台名 如"艾尔登法环 PC版" 或"王国之泪 switch"

场景 3：图书 / 资料 / 课件

推荐顺序：百度网盘 → 阿里云盘 → 夸克 → 123网盘
原因：图书资料百度最全，其他平台补充
关键词技巧：加格式 如"摄影 pdf" 或"教材 azw3"

场景 4：音乐 / 专辑

推荐顺序：电驴(ed2k) → 磁力 → 百度网盘
原因：电驴对音频支持好，磁力次之
关键词技巧：加艺术家名 如"周杰伦 flac"

场景 5：日语 / 外语学习资料

推荐顺序：百度网盘 → 阿里云盘 → 混合搜索
原因：日语资源百度最全
关键词技巧：
  - 日语名 + 中文 如"塞尔达传说 ゼルダの伝説"
  - 加文件格式 如"日语教材 pdf"
  - 用 --expand 强制多语言扩展

场景 6：动漫

推荐顺序：磁力 → 115 → 夸克
原因：动漫以种子为主，115和夸克动漫资源丰富
关键词技巧：加字幕组名 如"[ANK-Raws] 动漫名"

搜索命令

cd ~/.openclaw/skills/pansou

# 默认搜索（表格输出）
python3 pansou.py "王国之泪"

# JSON 输出（程序化处理）
python3 pansou.py "王国之泪" --json

# 强制多语言扩展（中文+英文+日文）
python3 pansou.py "塞尔达传说" --expand

# 直接指定资源类型过滤（当前脚本层面不支持，但可以告诉白龙帮你手动过滤）
# 例如："只找迅雷盘的王国之泪"

降级机制说明

当降级触发时，输出会标注 [磁力降级] 或 [SearXNG 补充]：

🐉 「王国之泪」搜索结果（共12条）
  ⚡ 迅雷网盘 3条 | ☁️ 阿里云盘 2条 | 🧲 磁力降级 7条
  ⚠️ 部分结果来自 SearXNG 磁力搜索补充

BTIH Hash 定向验证（精准找资源）

磁力资源的核心是 BTIH Hash，同 Hash 必同内容：

1. 从搜索结果提取 Hash：

   magnet:?xt=urn:btih:59768c2dcb45d01a27d2a19b31fa2606663c3c53
   → Hash: 59768c2dcb45d01a27d2a19b31fa2606663c3c53
   

2. 用 Hash 反查做种数： 在磁力站（xunsooo / wangcili）输入 Hash，查做种数

3. 判断标准：

   • 做种数 ≥10 → 高质量，优先下载
   • 做种数 3-9 → 中等质量，可尝试
   • 做种数 <3 → 死种率高，谨慎

4. 死种抢救： BT 下载无速度时，在 qBittorrent 里手动添加公共 Tracker：

   udp://tracker.altrosky.nl:6969/announce
   udp://opentracker.i2p.rocks:6969/announce
   udp://tracker.openbittorrent.com:6969/announce
   

迅雷下载联动

PanSou 结果可直接交给 xunlei-download Skill 执行下载：

# 方式一：告诉白龙 "下载第X个" 或 "用迅雷下这个链接"
# 白龙会自动识别迅雷链接并调用 xunlei-download

# 方式二：迅雷链接格式
thunder://QUFodHRwczovL2F2YXRhci5jc2RuLm5ldC8yLzAvOC8zX3dlaXhpbl80MDkwNzM4Mi5qcGdaWg==
→ 解码后: https://avatar.csdn.net/2/0/8/3_weixin_40907382.jpg

磁力/种子资源下载流程（完整链路）

找到磁力链接
  → 复制 magnet:?xt=urn:btih:HASH
  → 调用 xunlei-download 或 aria2 执行下载
  → 如果速度慢，添加公共 Tracker
  → 做种数 ≥10 的资源优先

输出示例

🐉 「王国之泪」搜索结果（共9条）

  ✅ 有效: 6条  ❌ 失效已过滤: 2条  🔒 需密码: 1条

⚡ 迅雷网盘
  • 塞尔达传说：王国之泪 v1.16 全DLC+mod `2025-09-17`
    🔗 https://pan.xunlei.com/s/xxx
  • 王国之泪 完美存档+攻略 `2025-10-01`
    🔗 https://pan.xunlei.com/s/yyy 🔑ab12

☁️ 阿里云盘
  • 塞尔达传说：王国之泪 官中中文 `2025-08-15`
    🔗 https://www.aliyundrive.com/s/zzz

🧲 磁力链接（降级补充）
  • Zelda: Tears of the Kingdom v1.2.0 [55个做种]
    🔗 magnet:?xt=urn:btih:59768c2dcb45d01a...

⏱ 4.2秒（PanSou）+ 2.1秒（SearXNG降级）

---
💡 告诉我要下哪个，我帮你调用 xunlei-download 执行下载

故障排除

技术细节

• PanSou 搜索 API: POST /api/search，body: {"kw": "关键词"}
• PanSou 链接检测 API: POST /api/check/links，body: {"items": [{"url":"...", "disk_type":"..."}]}
• 结果文件: search_result.json（最近一次搜索存档）
• SearXNG API: POST http://10.1.1.99:8080/search，q=magnet:?xt=urn:btih:+关键词&engines=baidu,sogou,bing&format=json
• 多语言扩展: 内置常见资源的中英日文对照（塞尔达、原神、黑神话悟空、王国之泪等）