PanSou 网盘搜索

网盘资源搜索引擎。支持百度网盘、阿里云盘、夸克网盘、天翼云盘、UC网盘、移动云盘、115、PikPak、迅雷、123网盘、磁力链接、电驴等12种网盘类型。支持按网盘类型、插件、TG频道过滤搜索结果。当用户需要搜索电影、剧集、软件、学习资料等网盘资源时使用此技能。触发词：搜索网盘、找资源、pan搜、网盘搜索、pan...

Security Scan

The skill's code, instructions, and requirements are coherent for a remote PanSou search client; it contacts only a user-specified PANSOU_URL and stores a local token, with no signs of unrelated credential access or hidden endpoints.

Purpose & Capability

Name/description match the implementation: the script is a CLI client that queries a PanSou HTTP service. Declared required binary (uv) and required env var (PANSOU_URL) are appropriate for this purpose.

Instruction Scope

SKILL.md instructs the agent to run the packaged CLI against the user-provided PANSOU_URL and to format links as clickable Markdown. The runtime instructions do not ask the agent to read unrelated files, search system history, or transmit data to other endpoints.

Install Mechanism

There is no install spec (instruction-only usage plus a bundled script). No downloads or archive extraction are specified; included Python script uses the widely-used requests library (the skill instructs how to install it).

Credentials

Registry metadata declares only PANSOU_URL as required, which is correct for operation. However the bundled script also reads optional PANSOU_USER and PANSOU_PWD (used when the service returns 401) and will POST them to the PANSOU_URL to obtain a JWT. Those optional env vars are documented in SKILL.md but not listed in the registry requires.env; this is a minor metadata mismatch to be aware of.

Persistence & Privilege

The script stores a JWT token at ~/.config/pansou/token.json for persistence. always:false (not force-enabled). Writing a token to the user's home directory is expected for a client but means the skill creates persistent state on the machine.

Assessment

This skill is a client for a PanSou server you must provide via PANSOU_URL. Before installing: (1) ensure you trust the PANSOU_URL host — the skill will send your search queries and, if used, username/passwords to that address; (2) know that an auth token is stored at ~/.config/pansou/token.json; (3) the script can optionally use PANSOU_USER/PANSOU_PWD to log in (these are documented but not listed as required env vars in the registry metadata); (4) the skill needs the 'uv' runner and Python requests; if you don't control or trust the remote PanSou service, consider deploying your own instance and pointing PANSOU_URL to it.

使用

调用前确认环境变量 PANSOU_URL 已配置。部署详见 PanSou GitHub。

# 健康检查（无需认证）
uv run {baseDir}/scripts/pansou.py health

# 验证 token 是否有效，无效自动重新登录
uv run {baseDir}/scripts/pansou.py verify

# 搜索（自动处理认证）
uv run {baseDir}/scripts/pansou.py search "关键词"

# 指定网盘类型
uv run {baseDir}/scripts/pansou.py search "关键词" --cloud-types quark,aliyun,baidu

# 指定插件
uv run {baseDir}/scripts/pansou.py search "关键词" --plugins labi,zhizhen,shandian

# 指定TG频道
uv run {baseDir}/scripts/pansou.py search "关键词" --channels tgsearchers3

# 过滤结果
uv run {baseDir}/scripts/pansou.py search "觉醒年代" --include 合集,全集 --exclude 预告,花絮

# 仅TG / 仅插件
uv run {baseDir}/scripts/pansou.py search "关键词" --src tg
uv run {baseDir}/scripts/pansou.py search "关键词" --src plugin

# 强制刷新缓存
uv run {baseDir}/scripts/pansou.py search "关键词" --refresh

# 使用 GET 方式搜索
uv run {baseDir}/scripts/pansou.py search "关键词" --get

Token 自动存储在 ~/.config/pansou/token.json，过期自动重新登录。

安全说明

• PANSOU_URL 由用户自行部署或指定，脚本仅向该地址发起 HTTP 请求
• PANSOU_USER / PANSOU_PWD 仅在服务返回 401 时用于获取 JWT token
• Token 仅通过 HTTP POST 发送至用户指定的 PANSOU_URL，不会外泄
• 认证为可选：未启用认证的服务无需设置 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 等）详细说明见 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。

输出格式注意事项

链接展示格式

向用户展示搜索结果中的链接时，必须使用 Markdown URL 形式，不要用代码块包裹：

✅ 正确示例：

1. 更新至20集 4K HDR
https://pan.quark.cn/s/abcdefgxxxx

❌ 错误示例：

1. 更新至20集 4K HDR
`https://pan.quark.cn/s/abcdefgxxxx`

原因：代码块形式的链接无法直接点击，用户体验差。Markdown URL 可以直接点击打开。