PanSou 盘搜
搜索 12 种网盘 + 磁力资源,支持链接有效性检测,按速度+相关性排序
首次部署(必须)
PanSou API 需本地部署后才能使用。
官方仓库: https://github.com/AshinGau/PanSou
# 方式一:Docker 一键部署
# 获取官方镜像或自建
git clone https://github.com/AshinGau/PanSou.git
cd PanSou && docker build -t pansou .
docker run -d --name pansou -p 1080:1080 -p 1081:1081 -v ~/pansou-data:/data pansou
# 方式二:使用 Skill 自带的 docker-compose.yml
cd ~/.openclaw/skills/pansou
docker-compose up -d
部署完成后访问 http://你的IP:1081 确认控制面板可打开。
配置 API 地址
部署后需要让 Skill 知道你的 API 地址:
# 方法一:环境变量(推荐)
export PANSOU_API=http://你的服务器IP:1080
# 方法二:直接修改脚本
sed -i 's|http://127.0.0.1:1080|https://你的API地址|g' ~/.openclaw/skills/pansou/pansou.py
搜索命令
cd ~/.openclaw/skills/pansou
# 默认搜索(表格输出)
python3 pansou.py "关键词"
# JSON 输出(程序化处理)
python3 pansou.py "关键词" --json
# 强制多语言扩展(中文+英文+日文)
python3 pansou.py "关键词" --expand
工作流程
用户输入关键词 → 搜索原始词 → 评估质量 → 自动扩展多语言 → 合并去重 → 链接检测 → 速度+相关性排序 → 输出结果
何时自动扩展:结果少于 5 条或相关结果少时自动触发。
链接检测:自动过滤失效链接,保留有效/需密码/未知状态的链接供用户选择。
支持的网盘类型
| 优先级 | 类型 | 说明 |
|---|---|---|
| ⚡ | 迅雷网盘 | 速度最快,优先推荐 |
| ☁️ | 阿里云盘 | 高质量资源 |
| 1️⃣1️⃣5️⃣ | 115网盘 | 高速资源 |
| 🟣 | 夸克网盘 | 常用资源 |
| 🧲 | 磁力链接 | 直连下载 |
| 🐴 | 电驴链接 | 备用 |
| 💾 | 百度网盘 | 资源丰富但速度慢 |
| 🌊 | UC网盘 | 备用 |
| 📡 | 天翼云盘 | 备用 |
| 📱 | 移动云盘 | 备用 |
| 📦 | PikPak | 备用 |
| 🔢 | 123网盘 | 备用 |
排序规则
- 网盘速度(升序):迅雷 > 阿里 > 115 > 夸克 > 磁力 > 电驴 > 百度 > 其他
- 相关性(组内降序):完整匹配 > 前缀匹配 > 包含匹配 > 部分重叠
输出示例
🐉 「王国之泪」搜索结果(共9条)
✅ 有效: 6条 ❌ 失效已过滤: 2条 🔒 需密码: 1条
⚡ 迅雷网盘
• 塞尔达传说:王国之泪 v1.16 全DLC+mod `2025-09-17`
🔗 https://pan.xunlei.com/s/xxx
🟣 夸克网盘
• 王国之泪 完美存档+攻略 `2025-10-01`
🔗 https://pan.quark.cn/s/xxx
⏱ 4.2秒
---
💡 告诉我要下哪个,我帮你调用 xunlei-download 执行下载
迅雷下载联动
PanSou 结果可直接交给 xunlei-download Skill 执行下载:
# 告诉白龙:"下载第X个" 或 "用迅雷下这个链接"
# 白龙会自动调用 xunlei-download 执行
故障排除
| 问题 | 解决方案 |
|---|---|
| "请求失败" | 检查 PANSOU_API 地址是否正确,服务是否运行 curl http://你的IP:1080 |
| "API错误" | PanSou 服务异常,重启 docker restart pansou |
| 0 结果 | 尝试 --expand 强制扩展,或换更精准的关键词 |
| 链接全部失效 | PanSou 索引可能过期,等待数据更新或换数据源 |
技术细节
- 搜索 API:
POST /api/search,body:{"kw": "关键词"} - 检测 API:
POST /api/check/links,body:{"items": [{"url":"...", "disk_type":"..."}]} - 结果文件:
search_result.json(最近一次搜索存档) - 多语言扩展: 内置常见资源的中英日文对照(塞尔达、原神、黑神话悟空等)