supsub-grouplisted
Install: claude install-skill SupSub-AI/supsub-cli
# 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`。
```bash
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`)。
```bash
supsub group add "AI 周报"
supsub group add 财经 -o json
```
JSON shape: `{"success":true,"data":{"id":1182,"name":"AI 周报"}}` —— 返回里直接带新分组 `id`,可立刻接 `add-sub` / `sub add --group` 使用(已实测)。
> ⚠️ **分组名不可重复**:已存在同名分组时报 `Resourc