supsub-deepreadlisted
Install: claude install-skill SupSub-AI/supsub-cli
# 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 篇 → **回问用户**,不要取第一个