用途:管理 SupSub 中按主题聚合的内容流「关注点」。与 supsub-sub(管理具体订阅源)不同,关注点跨多个来源聚合同一主题的文章。
安装与登录:curl -fsSL https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/scripts/install.sh | bash,或 npm i -g @supsub/cli / pnpm add -g @supsub/cli。首次使用先 supsub auth login,用 supsub auth status 确认已登录。
主要能力:
- 列出关注点:supsub focus list,每行含 id、icon、title、unreadCount。
- 查看关注点内容:supsub focus contents --id <focusId> [--unread | --all] [--brief] [--page <n>] [--page-size <n>]。默认只返回未读,--all 返回全部;--unread 与 --all 互斥,同时用会报 INVALID_ARGS。按时间浏览(如「最近有什么」)应用 --all,并把 isRead 当标注。每行含 contentId、url、title、sourceType、sourceName、publishedAt、isRead 等;建议直接读 CLI 补好的 publishedAtText。批量枚举加 --brief,避免输出过大。
- 整个关注点标记已读:supsub focus mark-read --id <focusId> --all,--all 必填且不可逆,执行前需向用户二次确认,且 CLI 无交互确认。
- 删除关注点:supsub focus remove --id <focusId>,破坏性且不可逆,无新增关注点命令。
限制:不支持单篇标记已读,也不支持取消已读;无 focus add;订阅源增删查、分组、跨源未读概览、全文搜索分别由其他技能负责。解析数据统一用 -o json,响应结构为 {"success":true,"data":<payload>}。退出码:0 正常,2 未授权,64 参数错误,1 业务错误,10 网络错误,11 服务端错误。