supsub-group

supsub-group Skill

「分组」（group）是订阅源的文件夹：把已订阅的源（公众号 MP、网站 WEBSITE、推特 X 等）收纳到自定义分组里，便于归类浏览。本 skill 负责分组的增删改查与成员管理。

与 supsub-focus 的区别：group 是人工收纳订阅源的文件夹（成员是源）；focus 是 AI 按主题聚合的内容流（成员是文章）。「把量子位放进 AI 分组」→ 本 skill；「我的关注点里有什么」→ supsub-focus。 与 supsub-sub 的区别：sub 管订阅关系本身（订阅/退订/看文章）；本 skill 只管"源放在哪个文件夹"。sub add --group <gid> 可在订阅时直接入组（见 supsub-sub）。

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 groups（分组列表）

supsub group list

无参数。每行字段：id, name。

supsub group list
supsub group list -o json

JSON shape: {"success":true,"data":[{"id":1063,"name":"AI 周报"}, ...]}

id 目前是数字，但请当作不透明标识原样回传（不要做数学运算/格式假设），后端保留改用字符串 ID 的可能。

---

Create a group（创建分组）

supsub group add <name>

位置参数 <name> 为分组名称（空白名称报 INVALID_ARGS）。

supsub group add "AI 周报"
supsub group add 财经 -o json

JSON shape: {"success":true,"data":{"id":1182,"name":"AI 周报"}} —— 返回里直接带新分组 id，可立刻接 add-sub / sub add --group 使用（已实测）。

⚠️ 分组名不可重复：已存在同名分组时报 ResourceExists（409 → exit 1），不会返回已有分组的 id。

因此「把 X 订上并归到『效率』组里」这类请求的正确顺序是：先 group list 找同名分组， 命中就复用它的 id，没命中才 group add。上来就 group add 会在分组已存在时白白失败一次。 若 group list 没有该分组，直接建即可（建分组是无损操作，不用反问用户）——但建之前顺带说一句 「『效率』组不存在，我新建一个」，因为用户很可能只是把组名记错了。

---

Rename a group（重命名分组）

supsub group rename --id <gid> --name <newName>

Flag	Required	Description
--id	yes	分组 ID（来自 group list）
--name	yes	新分组名称（非空）

supsub group rename --id 1063 --name "AI 深度"