Pansou

SKILL.md

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