supsub-focus

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。

# 列出全部关注点
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 list 的 id
--unread	(default)	仅返回未读内容
--all	—	返回全部内容（已读 + 未读）
--brief	—	精简输出：只留 contentId / title / sourceType / sourceName / publishedAt(+Text) / isRead
--page	1	页码（正整数）
--page-size	20	每页条数，1-100

⚠️ --unread 与 --all 互斥：同时指定会抛 INVALID_ARGS。不传任何一个时，默认行为等价于 --unread。

⚠️ 「最近」不等于「未读」：「看一下最近 X 的内容」「X 关注点最近有什么」这类按时间浏览的请求用 --all， 把 isRead 当标注（「其中 N 条你还没看过」）而不是过滤条件；只有用户明说「未读 / 没看的 / 还剩多少没读」 才用默认。否则该关注点读完后会返回空数组，回复「没有内容」——而用户问的是「最近」，不是「没读的」。