菜单
SupSub 微信公众号发现 —— 仅当用户想查找 / 发现一个微信公众号「本身」（通常为了拿到 mpId 后订阅它）时使用。匹配「搜公众号 X」「找 X 这个公众号」「查 X 公众号」「想订阅 X 公众号但不知道 ID」「discover / find a WeChat MP account」。⚠️ 不要用于搜索文章正文 / 内容 / 关键词相关的文章 —— 那种意图（如「搜一下 X 相关的内容」「找 X 相关的文章」）必须走 supsub-search。也包含取消正在跑的公众号搜索任务。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
SupSub CLI 认证管理 —— 登录 / 登出 / 查看登录状态。登录走 OAuth 浏览器设备授权，CLI 不支持 API Key 登录。匹配「supsub 登录」「supsub 登出」「查看我在 supsub 的登录状态」「我现在 supsub 用的是哪个账号」「supsub auth login / logout / status」。在调用其他 supsub 子命令前，如不确定凭证状态可先用本 skill 跑 `supsub auth status`。
SupSub 订阅管理 —— 列出 / 添加 / 删除订阅源（微信公众号 MP 或网站 WEBSITE），以及浏览某个已订阅源里的文章列表。匹配「列出我的订阅」「我订阅了哪些」「取消订阅 X」「订阅 X 这个公众号 / 网站」「看 X 订阅里有哪些文章」「X 公众号最近的未读文章」「添加 / 删除订阅源」。⚠️ 不用于跨订阅搜索文章关键词（走 supsub-search），也不用于「发现一个新的公众号」（走 supsub-mp）。
SupSub 全文搜索 —— 在订阅源（公众号 / 网站）和文章正文里跨源搜索内容。用户说「搜一下 X 相关的内容 / 文章」「在 supsub 里搜 X」「查 X 相关文章」「全文搜索 X」「找 X 的内容」「search articles/content in SupSub」时使用本 skill。注意：本 skill 用于搜「内容 / 文章 / 订阅源标题」；如果用户想发现一个新的微信公众号本身（拿 mpId 准备订阅），改用 supsub-mp。
| name | supsub-mp |
| version | 0.1.0 |
| description | SupSub 微信公众号发现 —— 仅当用户想查找 / 发现一个微信公众号「本身」（通常为了拿到 mpId 后订阅它）时使用。匹配「搜公众号 X」「找 X 这个公众号」「查 X 公众号」「想订阅 X 公众号但不知道 ID」「discover / find a WeChat MP account」。⚠️ 不要用于搜索文章正文 / 内容 / 关键词相关的文章 —— 那种意图（如「搜一下 X 相关的内容」「找 X 相关的文章」）必须走 supsub-search。也包含取消正在跑的公众号搜索任务。 |
搜索微信公众号（异步任务，CLI 默认同步等待最长 30 秒），以及取消正在执行的搜索任务。拿到 mpId 后下一步是 supsub sub add --mp-id <mpId>（见 supsub-sub skill）—— mp search 返回的 mpId 是微信原生 base64 字符串，不能塞给 --source-id（那是 supsub 内部正整数 ID，不同 ID 空间）。
pnpm add -g @supsub/cli（或 npm i -g @supsub/cli）supsub auth status 显示 Authenticated（首次使用先 supsub auth login）supsub mp search <name>
<name> 是公众号名称关键词（建议加引号）。命令内部流程：
POST /api/mps/search-tasks 创建异步任务，得到 searchId。finished=true 后，把所有候选作为结果一次性输出。searchId，附带提示信息。每个候选字段：mpId, name, img, description。
# 同步搜索（最长等 30 秒）
supsub mp search "阮一峰的网络日志"
# JSON
supsub mp search "阮一峰" -o json
JSON shape (成功)：{"success":true,"data":[{"mpId":"...","name":"...","img":"...","description":"..."}, ...]}
未找到：以 MP_NOT_FOUND 错误退出（非 0 exit code）。
超时：以 MP_SEARCH_TIMEOUT 错误退出，错误体里带 data.searchId，提示信息形如 30 秒内未完成，可重试 supsub mp search 或取消任务: supsub mp search-cancel <searchId>。
⚠️ 超时处理：CLI 不提供恢复型查询命令。遇到超时时，用户只有两条路径 —— 重新跑
supsub mp search <name>，或调用supsub mp search-cancel <searchId>取消那个孤儿任务后再试。
supsub mp search-cancel <searchId>
<searchId> 来自上一次 supsub mp search 在超时分支返回的错误数据（JSON 模式：{"success":false,"error":{"code":"MP_SEARCH_TIMEOUT","data":{"searchId":"..."}}} 这一类的形态由 dieWith 和 output() 处理；表格模式下错误字符串里会直接带 searchId）。
supsub mp search-cancel sid_abc123
supsub mp search-cancel sid_abc123 -o json
JSON shape: {"success":true,"data":{"message":"已取消"}}
任务不存在或已取消时，以 TASK_NOT_FOUND 错误退出（HTTP 404 → exit code 非 0）。
mp search 是 同步包装的异步任务：调用方一般不用关心 searchId，直接拿结果数组即可；只在 30 秒超时分支才需要处理 searchId。-o json。成功时 data 是 Mp[]；失败时走标准 ErrorEnvelope（code、message、可选 data.searchId）。# 1. 拿到 mpId（base64 字符串，例如 MzkyNTYzODk0NQ==）
mpId=$(supsub mp search "阮一峰" -o json | jq -r '.data[0].mpId')
# 2. 用 --mp-id 直接订阅（走 POST /api/mps；type 默认 MP，可省）
supsub sub add --mp-id "$mpId"
mpId 当成 --source-id：mp search 返回的 mpId 是微信原生 base64 字符串（如 MzkyNTYzODk0NQ==），supsub sub add --source-id 期望的是 supsub 内部正整数 sourceId（来自 supsub search / sub list），两者属于不同 ID 空间。哪怕 base64 解码出来是数字，后端也会以"信息源不存在"驳回。统一走 --mp-id。mp search 每个候选只含 mpId / name / img / description 四个字段（见 src/lib/types.ts 的 MpSearchTaskResult.mp），不返回 isSubscribed；要判断是否已订阅，改用 supsub search ... --type MP 结果里的 data.isSubscribed，或先 supsub sub list 比对。mp search 内部固定轮询：间隔 2s，总时长 30s（POLL_INTERVAL_MS / POLL_MAX_MS），CLI 不暴露调参 flag。mpId），调用方不用再去重。supsub mp search-cancel <searchId> 取消孤儿任务，或重新发起 supsub mp search <name>。0 OK；超时 / 未找到 / 任务不存在等业务错误是非 0；2 UNAUTHORIZED，10/11 网络/服务端。