supsub-sub

supsub-sub Skill

List, add, remove subscription sources, and browse the articles inside each source. Sources are typed MP（微信公众号）、WEBSITE（网站）或 X（推特 / Twitter 平台账号）。

⚠️ 关于字母「X」的歧义（务必先读）

本文档里 X 有两种完全不同的含义，不要混淆：

1. --type X —— 这是一个真实的 sourceType 枚举值，专指 推特 / Twitter / X 平台账号。
2. 占位符 X —— 用户口语里说「订阅 X」「取消订阅 X」「X 公众号最近的文章」时，这里的 X 通常只是一个占位代号，代指某个具体账号（可能是公众号、网站，也可能就是名字里带 X），与推特无关。

判定规则：

• 只有当用户**明确提到「推特 / Twitter / X 平台」**时，才使用 --type X。
• 用户说「订阅 X」「X 公众号」「看 X 的文章」而没有提到推特平台时，不要据此推断 --type X；这里的 X 是占位符，应按其真实类型（多为 MP 或 WEBSITE）处理。

Prerequisites

• 安装：curl -fsSL https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/scripts/install.sh | bash（native 安装，装到 ~/.local、支持后台自动更新）；或包管理器 npm i -g @supsub/cli / pnpm add -g @supsub/cli
• 已登录：supsub auth status 显示 Authenticated（首次使用先 supsub auth login）
• 未授权（exit 2 / UNAUTHORIZED）时不要止步于「你未登录」：直接运行 supsub auth login 为用户打开浏览器授权（命令会自动打开浏览器并阻塞等待授权，请用足够长的超时，如 10 分钟；用户只需在浏览器点确认，无需在终端输入任何内容），授权成功后重试原命令。无浏览器 / 无头环境再回退为提示用户 SUPSUB_NO_BROWSER=1 supsub auth login。

Commands

List subscriptions

supsub sub list [--type <MP|WEBSITE|X>]

Flag	Default	Description
--type	— (all)	过滤来源类型：MP（公众号）/ WEBSITE（网站）/ X（推特）

Each row includes: sourceId, sourceType, name, img, description, unreadCount。表格模式下 类型 列会把 sourceType 显示为中文：MP→公众号、WEBSITE→网站、X→推特。

# 列出全部订阅
supsub sub list

# 仅看公众号
supsub sub list --type MP

# 仅看网站
supsub sub list --type WEBSITE

# 仅看推特（X 平台账号）
supsub sub list --type X

# 导出 JSON
supsub sub list -o json

JSON shape: {"success":true,"data":[{"sourceType":"MP","sourceId":12345,"name":"...","img":"...","description":"...","unreadCount":3}, ...]}

---

Add a subscription

sub add 有两条互斥入口，对应两种"拿到的 ID 形态"：

# A) 全局搜索 / 已收录源 → 用内部正整数 sourceId
supsub sub add --source-id <id> --type <MP|WEBSITE|X> [--group <gid>]...

# B) mp search 发现的微信原生公众号 → 用 base64 字符串 mpId
supsub sub add --mp-id <mpId> [--type MP] [--group <gid>]...