back
loading skill details...
|
---
name: pansou
description: |
盘搜(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条)或相关度低,自动触发:
```bash
# 磁力搜索:搜 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 直接反查更多源:
```bash
# 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] 动漫名"
```
## 搜索命令
```bash
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 执行下载:
```bash
# 方式一:告诉白龙 "下载第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`
- **多语言扩展**: 内置常见资源的中英日文对照(塞尔达、原神、黑神话悟空、王国之泪等)don't have the plugin yet? install it then click "run inline in claude" again.