Pansou

盘搜（PanSou）— 国内聚合资源搜索最强工具。搜索百度网盘、阿里云盘、夸克网盘、迅雷、115、磁力链接等 14 种资源类型， 支持链接有效性检测、智能排序、迅雷一键下载。 自动降级 + 混合搜索策略：先 PanSou 查网盘，未找到则切 SearXNG 磁力搜索，再未找到则主动告知用户可手动指定搜索策略。 触发词：搜索、搜一下、找一下、盘搜、pansou、网盘搜索、资源搜索、找资源、下载、magnet、thunder://、ed2k、torrent

PanSou 盘搜 🐉

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

资源类型与优先级

优先级	类型	说明	适用场景
⚡ 1	迅雷网盘	速度最快，优先推荐	游戏、软件、热门影视
☁️ 2	阿里云盘	高质量资源，资源全	电影、剧集、学习资料
🔢 3	115网盘	高速资源，热门保持	影视、动漫、高清资源
🟣 4	夸克网盘	常用资源	剧集、综艺、小众资源
🧲 5	磁力/种子	直连下载，做种数决定质量	电影、剧集、软件、音乐
🐴 6	电驴链接	备用	老资源、稀有资源
💾 7	百度网盘	资源最丰富，速度慢	资料、书籍、旧资源
🌊 8	UC网盘	备用	-
📡 9	天翼云盘	备用	-
📱 10	移动云盘	备用	-
📦 11	PikPak	备用	-
🔢 12	123网盘	备用	-
🦆 13	光鸭云盘	备用	-
📎 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

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

降级机制说明

PanSou 结果情况	自动动作
≥5 条且相关度高	直接输出，不触发降级
<5 条	自动用 SearXNG 搜 magnet: 前缀
0 条	先搜 magnet，磁力也无结果则告知用户可手动指定策略
API 连接失败	跳过 PanSou，直接用 SearXNG 磁力搜索

当降级触发时，输出会标注 [磁力降级] 或 [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 地址是否正确，服务是否运行 curl http://你的IP:1080
"API错误"	PanSou 服务异常，重启 docker restart pansou
0 结果	自动触发降级 SearXNG 磁力搜索，或尝试 --expand 强制扩展多语言
链接全部失效	PanSou 索引可能过期，切换磁力搜索降级策略
磁力下载无速度	在 qBittorrent 里手动添加公共 Tracker，或换做种数更高的源
SearXNG 也无结果	手动告诉白龙尝试其他搜索策略或换关键词

技术细节

• 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
• 多语言扩展: 内置常见资源的中英日文对照（塞尔达、原神、黑神话悟空、王国之泪等）