supsub-focuslisted
Install: claude install-skill SupSub-AI/supsub-cli
# supsub-focus Skill
「关注点」(focus)是 SupSub 里按主题聚合的内容流:它跨多个来源(微信公众号 `MP`、网站 `WEBSITE`、推特 `X`)把同一主题的文章汇集到一起。本 skill 负责**查看**关注点列表、**浏览**某个关注点里的内容(区分已读/未读),以及**删除**关注点。
> 与 `supsub-sub` 的区别:`sub` 管理「订阅源」(一个具体的公众号/网站,以及其下文章);`focus` 管理「主题聚合视图」(跨多个源的内容流)。两者不要混淆。
> 与 `supsub-search` 的区别:`search` 是按关键词做一次性全文检索;`focus` 是浏览既有的、持续更新的主题流。
## 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 focuses(关注点列表)
```
supsub focus list
```
无参数。每行字段:`id`, `icon`(emoji), `title`, `unreadCount`。
```bash
# 列出全部关注点
supsub focus list
# JSON 输出
supsub focus list -o json
```
JSON shape: `{"success":true,"data":[{"id":42,"icon":"🤖","title":"...","unreadCount":3}, ...]}`
> **已读/未读**:每个关注点的 `unreadCount` 就是该关注点当前的未读条目数。用户问「我哪个关注点还有没读的 / 各关注点还剩多少没看」时,直接读这个字段,无需进 contents。
---
### Browse contents in a focus(查看关注点内容)
```
supsub focus contents --id <focusId> [--unread | --all] [--brief] [--page <n>] [--page-size <n>]
```
| Flag | Default | Description |
|------|---------|-------------|
| `--id` | required | 关注点 ID(正整数),来自 `supsub focus