Menu
SupSub CLI 认证管理 —— 登录 / 登出 / 查看登录状态。登录走 OAuth 浏览器设备授权，CLI 不支持 API Key 登录。匹配「supsub 登录」「supsub 登出」「查看我在 supsub 的登录状态」「我现在 supsub 用的是哪个账号」「supsub auth login / logout / status」。在调用其他 supsub 子命令前，如不确定凭证状态可先用本 skill 跑 `supsub auth status`。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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）。
SupSub 全文搜索 —— 在订阅源（公众号 / 网站）和文章正文里跨源搜索内容。用户说「搜一下 X 相关的内容 / 文章」「在 supsub 里搜 X」「查 X 相关文章」「全文搜索 X」「找 X 的内容」「search articles/content in SupSub」时使用本 skill。注意：本 skill 用于搜「内容 / 文章 / 订阅源标题」；如果用户想发现一个新的微信公众号本身（拿 mpId 准备订阅），改用 supsub-mp。
| name | supsub-auth |
| version | 0.1.0 |
| description | SupSub CLI 认证管理 —— 登录 / 登出 / 查看登录状态。登录走 OAuth 浏览器设备授权，CLI 不支持 API Key 登录。匹配「supsub 登录」「supsub 登出」「查看我在 supsub 的登录状态」「我现在 supsub 用的是哪个账号」「supsub auth login / logout / status」。在调用其他 supsub 子命令前，如不确定凭证状态可先用本 skill 跑 `supsub auth status`。 |
Log in, log out, and check authentication status for the SupSub CLI.
pnpm add -g @supsub/cli（或 npm i -g @supsub/cli）~/.supsub/config.json（目录权限 0700，文件权限 0600）。supsub auth login 走 OAuth 设备授权，成功后写入 access_token / refresh_token。CLI 不支持 API Key 登录，没有 --api-key flag / SUPSUB_API_KEY 这一类入口。supsub auth login
supsub auth login 会自动打开浏览器，走 OAuth 设备授权流程（Device Authorization）完成登录；授权成功后把 access_token / refresh_token 写入 ~/.supsub/config.json。这是 CLI 唯一的登录方式（不支持 API Key 登录）。
# 自动打开浏览器完成授权
supsub auth login
# 无头 / e2e 环境：跳过自动打开浏览器，手动复制终端里的链接去授权
SUPSUB_NO_BROWSER=1 supsub auth login
JSON 模式 (
-o json) 下，登录成功 stdout 输出{"success":true,"data":{"client_id":"supsub-cli","email":"...","name":"..."}}（name来自登录后拉取的用户信息；若拉取失败这两个字段缺省，退化为{"client_id":"supsub-cli"}）；提示信息走 stderr。
supsub auth status
Shows the current logged-in user, the masked credential, and its source。正常 OAuth 登录后 api_key_source 为 config（凭证来自配置文件里的 access_token）；api_key 字段是脱敏后的访问令牌（CLI 沿用 sk_live_*** 前缀展示，并非真有 API Key）。
supsub auth status
supsub auth status -o json
JSON shape:
{
"success": true,
"data": {
"email": "...",
"name": "...",
"client_id": "supsub-cli",
"api_key_source": "config",
"api_key": "sk_live_***xxxx"
}
}
If unauthenticated, exits with code 2 (UNAUTHORIZED) and a message asking the user to run supsub auth login.
supsub auth logout
Removes saved credentials from ~/.supsub/config.json.
supsub auth logout
supsub auth logout -o json
JSON 模式下输出 {"success":true,"data":{}}。
supsub auth status，确认凭证有效；未登录时引导用户 supsub auth login。--api-key flag / SUPSUB_API_KEY 环境变量；登录唯一入口是 supsub auth login（OAuth 设备授权）。resolveApiKey() 解析，优先级（高 → 低）：配置文件 access_token（OAuth 设备授权令牌）> 配置文件 bearer_token（高级用法：手动从浏览器粘贴的临时会话 token）。access_token / refresh_token / bearer_token，见 src/http/client.ts 调用的 clearAuth()）；遇到 exit code 2 时通常需要重新登录。-o json；常见 exit code：0 OK，2 UNAUTHORIZED，3 PLAN_EXPIRED，10 NETWORK，11 SERVER，64 INVALID_ARGS。SUPSUB_API_URL（默认 https://supsub.net），用于本地或测试环境。