网盘资源搜索。当用户想找影视剧、动漫、软件、资料的观看/下载链接时用。直接说片名也触发(如韩国制造),观看意图也触发(看、想看、我要看、找、搜、求链接、哪里能看、求资源、推荐个好看的),片名+网盘也触发(如韩国制造 夸克)。支持多个 PanSou 站点并发搜索,谁先有数据先给用户。模糊兴趣(如听说某剧好看)先问是不是想找来看再搜。
何时使用(意图 -> 动作)
用户很少说“搜索网盘”“找资源”,都是直接提需求。看到以下意图直接用本技能,不用等明确触发词:
- 直接说片名/资源名:如韩国制造、韩国制作
- 观看意图词:看、想看、我要看、找、搜、求链接、哪里能看、有资源吗、求资源、链接发我、搜索、推荐个好看的
- 组合句:我要看韩国制造、帮我找韩国制造、韩国制造哪里能看、听说韩国制造好看、求韩国制造链接、搜索韩国制造
- 片名 + 网盘限定:如韩国制造 夸克 -> 去掉网盘词,用
--cloud-types quark再搜 - 网盘别名:夸克=quark、百度=baidu、阿里=aliyun、天翼=tianyi、UC=uc、移动=mobile、115=115、迅雷=xunlei、123=123、磁力=magnet、电驴=ed2k
- 模糊兴趣:如“听说XX剧好看”“最近有啥好看的” -> 先问一句“是不是想找XX来看?偏好哪个网盘(夸克/百度/阿里)?”确认后再搜
只聊剧情、评价、演员、不找链接时不用本技能。
首次使用引导
用户第一次安装、环境变量缺失,或直接问“怎么用/怎么配置”时,按以下步骤一步步引导,确认一步再走下一步:
- 先确认是否已有
PANSOU_URL/PANSOU_URLS。当前会话可能没继承用户级变量,先问用户是否保存过。 - 没有就向用户要至少 1 个自建 PanSou 服务地址(形如
http://ip:port)。用户没有地址时,先让他自己部署或拿到地址,不要编造。 - 引导保存地址。Windows 用户永久保存:
[Environment]::SetEnvironmentVariable("PANSOU_URLS","http://a,http://b","User")macOS/Linux 用户在~/.zshrc/~/.bashrc加:export PANSOU_URLS="http://a,http://b"单站点用PANSOU_URL,多站点用PANSOU_URLS。 - 本会话想立即测试,可先用临时变量:
$env:PANSOU_URLS="http://a,http://b"(仅当前窗口有效)。 - 先在
scripts目录编译go build -o pansou .(自动适配当前平台),然后跑健康检查:Windowspansou.exe health,Linux/macOS./pansou health,全部 ok 再进行下一步。 - 让用户发一个想看的内容,实跑一次搜索,确认能正常出 Markdown 链接才算完成引导。
注意:不要一次性丢一大段文档,引导过程中一次推进一步即可。
多站点并发
- 配置一个站点:
PANSOU_URL=https://pansou.example.com - 配置多个站点:
PANSOU_URLS=https://a.example.com,https://b.example.com,优先于PANSOU_URL --strategy first(默认):所有站点并发搜索,谁先返回有效数据就先给用户,返回结果带_site标记来源--strategy merge:所有站点并发搜索,等全部返回后按站点合并,输出{"strategy":"merge","sites":{...}}- 多站点时 token 按 host 分开存在
~/.config/pansou/tokens/;某个站点失败不会卡死其他站点
# 多站点并发,先到先展示
{baseDir}/scripts/pansou.exe search "韩国制造" --strategy first
# 多站点并发,等全部返回后合并
{baseDir}/scripts/pansou.exe search "韩国制造" --strategy merge
# 多站点并发健康检查
{baseDir}/scripts/pansou.exe health
网址健康度提醒
search搜索时会并发探测所有站点的/api/health(和搜索同时跑,不额外阻塞)。失联地址超过 3 个时,会打印警告并列出失联地址,提醒用户更新PANSOU_URLS。- 想单独查看各站点状态:
{baseDir}/scripts/pansou.exe health。 - 收到“超过 3 个失联”的警告时,先让用户更新或移除失效地址,再继续搜索,避免拿到空结果。
使用
调用前确认 PANSOU_URL 或 PANSOU_URLS 已配置。部署详见 PanSou GitHub。
本技能附带 Go 源码,零依赖,不打包预编译二进制。首次使用(或换机器后)先在 scripts 目录编译:Windows 运行 go build -o pansou.exe .(必须带 .exe,否则 PowerShell 拒绝运行),Linux/macOS 运行 go build -o pansou . 再 chmod +x pansou。下面的命令里的 pansou.exe 在 Linux/macOS 上换成 ./pansou。
# 健康检查(无需认证)
{baseDir}/scripts/pansou.exe health
# 验证 token 是否有效,无效自动重新登录(单站点)
{baseDir}/scripts/pansou.exe verify
# 搜索(自动处理认证)
{baseDir}/scripts/pansou.exe search "关键词"
# 指定网盘类型
{baseDir}/scripts/pansou.exe search "关键词" --cloud-types quark,aliyun,baidu
# 指定插件
{baseDir}/scripts/pansou.exe search "关键词" --plugins labi,zhizhen,shandian
# 指定TG频道
{baseDir}/scripts/pansou.exe search "关键词" --channels tgsearchers3
# 过滤结果
{baseDir}/scripts/pansou.exe search "觉醒年代" --include 合集,全集 --exclude 预告,花絮
# 仅TG / 仅插件
{baseDir}/scripts/pansou.exe search "关键词" --src tg
{baseDir}/scripts/pansou.exe search "关键词" --src plugin
# 强制刷新缓存
{baseDir}/scripts/pansou.exe search "关键词" --refresh
# 使用 GET 方式搜索
{baseDir}/scripts/pansou.exe search "关键词" --get
单站点 token 自动存储在 ~/.config/pansou/token.json,多站点按 host 存到 ~/.config/pansou/tokens/,过期自动重新登录。
意图解析示例
- “韩国制造” ->
search "韩国制造" - “我要看韩国制造”/“想看韩国制造”/“看韩国制造” ->
search "韩国制造" - “韩国制造 夸克” ->
search "韩国制造" --cloud-types quark - 配置了多个站点时,默认并发查所有站点,谁先有结果先展示
安全说明
PANSOU_URL/PANSOU_URLS由用户自行部署或指定,脚本仅向这些地址发起 HTTP 请求PANSOU_USER/PANSOU_PWD仅在服务返回 401 时用于获取 JWT token- Token 仅通过 HTTP POST 发送至用户指定的站点,不会外泄
- 认证为可选:未启用认证的服务无需设置
PANSOU_USER/PANSOU_PWD
支持的网盘类型
简要列表:baidu aliyun quark tianyi uc mobile 115 pikpak xunlei 123 magnet ed2k others
完整清单(含各类型对应的插件和说明)见 references/cloud-types.md。
搜索参数详解
所有 CLI 参数(--res、--conc、--refresh、--strategy 等)详细说明见 references/api-params.md。
搜索结果格式
默认 merge 模式,按网盘类型分类返回:
{
"total": 15,
"merged_by_type": {
"quark": [
{"url": "https://pan.quark.cn/s/abcdefgxxxx", "password": "", "note": "标题", "datetime": "...", "source": "plugin:labi"}
]
}
}
如需原始消息列表,使用 --res results。多站点 first 模式的结果会带 _site 字段标明来自哪个站点。
输出格式注意事项
链接展示格式
向用户展示搜索结果中的链接时,必须使用 Markdown URL 形式,不要用代码块包裹:
正确示例:
1. 更新至20集 4K HDR
https://pan.quark.cn/s/abcdefgxxxx
错误示例:
1. 更新至20集 4K HDR
`https://pan.quark.cn/s/abcdefgxxxx`
原因:代码块形式的链接无法直接点击,用户体验差。Markdown URL 可以直接点击打开。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2mo ago
- Current version
- v1.0.2
- License
- MIT-0
