菜单
SupSub 全文搜索 —— 在订阅源（公众号 / 网站）和文章正文里跨源搜索内容。用户说「搜一下 X 相关的内容 / 文章」「在 supsub 里搜 X」「查 X 相关文章」「全文搜索 X」「找 X 的内容」「search articles/content in SupSub」时使用本 skill。注意：本 skill 用于搜「内容 / 文章 / 订阅源标题」；如果用户想发现一个新的微信公众号本身（拿 mpId 准备订阅），改用 supsub-mp。
用 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 微信公众号发现 —— 仅当用户想查找 / 发现一个微信公众号「本身」（通常为了拿到 mpId 后订阅它）时使用。匹配「搜公众号 X」「找 X 这个公众号」「查 X 公众号」「想订阅 X 公众号但不知道 ID」「discover / find a WeChat MP account」。⚠️ 不要用于搜索文章正文 / 内容 / 关键词相关的文章 —— 那种意图（如「搜一下 X 相关的内容」「找 X 相关的文章」）必须走 supsub-search。也包含取消正在跑的公众号搜索任务。
SupSub 订阅管理 —— 列出 / 添加 / 删除订阅源（微信公众号 MP 或网站 WEBSITE），以及浏览某个已订阅源里的文章列表。匹配「列出我的订阅」「我订阅了哪些」「取消订阅 X」「订阅 X 这个公众号 / 网站」「看 X 订阅里有哪些文章」「X 公众号最近的未读文章」「添加 / 删除订阅源」。⚠️ 不用于跨订阅搜索文章关键词（走 supsub-search），也不用于「发现一个新的公众号」（走 supsub-mp）。
| name | supsub-search |
| version | 0.1.0 |
| description | SupSub 全文搜索 —— 在订阅源（公众号 / 网站）和文章正文里跨源搜索内容。用户说「搜一下 X 相关的内容 / 文章」「在 supsub 里搜 X」「查 X 相关文章」「全文搜索 X」「找 X 的内容」「search articles/content in SupSub」时使用本 skill。注意：本 skill 用于搜「内容 / 文章 / 订阅源标题」；如果用户想发现一个新的微信公众号本身（拿 mpId 准备订阅），改用 supsub-mp。 |
全量搜索：在订阅源（公众号、网站）和文章正文里同时搜，可按类型缩小范围。
pnpm add -g @supsub/cli（或 npm i -g @supsub/cli）supsub auth status 显示 Authenticated（首次使用先 supsub auth login）supsub search <keyword> [--type <ALL|MP|WEBSITE|CONTENT>]
| Flag | Default | Description |
|---|---|---|
--type | ALL | 搜索范围：ALL（源 + 文章）/ MP（公众号源）/ WEBSITE（网站源）/ CONTENT（文章正文） |
<keyword> 是位置参数，可以是中文或英文，建议用引号包起来避免 shell 拆分。
# 全量搜索（默认 ALL：同时搜源 + 文章）
supsub search "RAG"
# 只搜公众号
supsub search "阮一峰" --type MP
# 只搜网站
supsub search "hacker news" --type WEBSITE
# 只搜文章正文
supsub search "向量数据库" --type CONTENT
# JSON
supsub search "MCP 协议" -o json
JSON shape: {"success":true,"data":{"results":[...],"recommendations":[...],"prompts":[...]}}
results 是异质数组，每条形如：
// 源结果（type=MP 或 WEBSITE 时）
{ "type": "SOURCE", "data": { "sourceType": "MP", "sourceId": 12345, "isSubscribed": false, "img": "...", "name": "...", "description": "...", "introduction": "...", "url": "..." } }
// 文章结果（type=CONTENT 时）
{ "type": "CONTENT", "data": { "contentId": "...", "title": "...", "summary": "...", "url": "...", "coverImage": "...", "publishedAt": 1700000000, "sourceId": 12345, "sourceName": "...", "sourceType": "MP", "isSubscribed": false, "keywords": [...], "tags": [...] } }
recommendations 是后端推荐的相关源（SourceBasic[]），prompts 是后端给的搜索建议词。
-o json：results[] 是 {type, data} 联合类型，先看 type 再访问 data 字段。--type ALL（默认）会同时返回源 + 文章混排；想精确控制结果类型时显式指定 MP / WEBSITE / CONTENT。supsub search "<词>" --type MP -o json → 取 data.results[].data.sourceId → supsub sub add --source-id <id> --type MP（参考 supsub-sub skill）。supsub search "<词>" --type CONTENT -o json 拿到 contentId 与 sourceId，目前 CLI 没有"按 contentId 取文章详情"命令，需要通过 supsub sub contents --source-id <id> --type <T> 在该源内浏览。data.results[].data.isSubscribed 字段可以判断当前结果是否已经订阅，避免重复 sub add。pageSize=10），不支持翻页；如果想要更多结果，调整关键词缩小或扩大搜索范围。0 OK，2 UNAUTHORIZED，64 INVALID_ARGS（--type 不在白名单时），10/11 网络/服务端错误。