supsub-deepread

supsub-deepread Skill

精读 = 对单篇文章做 AI 深度拆解。它不是摘要（sub contents 里的 summary 才是摘要）， 而是一份带批判视角的结构化拆解：值不值得读、干货在哪、作者什么立场、信源可不可信、论证最弱的一环在哪。

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。
• 精读需要付费计划；无权限时后端返回业务错误（exit 1），如实转达并停止，不要重试。

两条硬门禁（先读这两条，再看命令）

① 花钱门禁：发起精读前必须确认额度

精读按次扣月度额度，且没有「撤销/退额度」的操作。额度上限随套餐/后端调整而变，一律以 deepread quota 当次返回的 limit / remaining 为准，不要凭记忆里的数字向用户复述余额。所以：

1. 先 supsub deepread quota -o json 取 {limit, used, remaining}；
2. 向用户复述：要精读哪几篇（列标题）、将消耗几次、本月还剩几次；
3. 得到明确肯定答复后才执行 deepread run。

批量时逐篇列出标题让用户确认，不要因为用户说了句「都精读了」就自行扩大范围。 用户已经明确点名单篇（「精读这篇」+ 上下文只有一篇）时，一次 quota + 一句「将消耗 1 次，本月剩 N 次，现在开始？」即可，不必逐层追问。

已经精读过的文章不会重复扣费：run 会先探测状态，命中 done 直接返回结果（quotaSpent: false）。 所以「这篇之前读过没」不用问用户，跑一遍 deepread get 就知道。

② 取值门禁：contentId 只能来自上下文

contentId 是不透明字符串，必须来自本轮会话里 sub contents / focus contents / search 的真实返回。

用户说法	做法
「精读第 3 篇」	指代上文列表第 3 项 → 直接用它的 contentId
「精读那篇讲 XX 的」	在上文列表按标题模糊匹配：恰好命中 1 篇才执行；命中 0 篇或 ≥2 篇 → 回问用户，不要取第一个
上文没有任何文章列表	先 sub contents --brief / search 把候选列出来，停下来等用户点名，不要自作主张选最新一篇
用户直接粘一条文章 URL	CLI 没有 URL → contentId 的接口。如实说明，并改为从订阅/关注点/搜索里定位这篇

绝不让用户手输 contentId，绝不凭记忆构造或猜测。猜错的代价是花掉一次额度读错文章。

Workflow

A. 单篇精读（最常见）

# 1. 定位文章（拿 contentId + sourceType）
supsub sub contents --source-id 25 --type MP --brief -o json

# 2. 查额度 → 向用户确认 → 才执行
supsub deepread quota -o json

# 3. 发起并等待（默认前台等，实测 20~40 秒）
supsub deepread run --type MP --content-id <cid> --title "<标题>" --source-name "<源名>" -o json