菜单
SupSub CLI 认证管理 —— 登录 / 登出 / 查看登录状态。登录走 OAuth 浏览器设备授权，CLI 不支持 API Key 登录。匹配「supsub 登录」「supsub 登出」「查看我在 supsub 的登录状态」「我现在 supsub 用的是哪个账号」「supsub auth login / logout / status」。在调用其他 supsub 子命令前，如不确定凭证状态可先用本 skill 跑 `supsub auth status`。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| 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），用于本地或测试环境。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。