supsub-unread Skill

未读工作流的入口 skill：回答「我有哪些未读」，并完成「概览 → 钻取 → 整体已读」的闭环。涉及的命令跨 unread / sub / 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。

已读模型：只有「整体已读」，没有「单篇已读」

这是本 skill 最容易踩错的一点，先记住：

• CLI 能做的只有两件事：sub mark-read --all（这个号我读完了）、focus mark-read --all（这个关注点我看完了）。
• 没有单篇已读。原因是产品侧的：文章在 SupSub 里没有「详情 / 阅读」这一步，也就不存在「用户读完了这一篇」的自然事件，所以 CLI 只保留用户明确表达的整体已读意图。
• 用户说「把这篇标为已读」时：如实说明不支持，再问是否要把整个源 / 整个关注点标为已读。不要试图用 --content-id 绕过（会抛 INVALID_ARGS），也不要靠循环调用伪造逐篇已读。
• 也没有分组级已读命令。用户要「清空某个分组」时：先 group subs 列出组内源，逐个源确认后再逐个 sub mark-read --all，每个源都要在确认范围内。