supsub-searchlisted
Install: claude install-skill SupSub-AI/supsub-cli
# supsub-search Skill
全量搜索:在订阅源(公众号、网站)和文章正文里同时搜,可按类型缩小范围。
## 先判范围:全站搜索 vs 用户自己的订阅
拿到一个词 X,**看动词,不看 X 像不像专名**:
| 用户说法 | 意图 | 走哪 |
|---|---|---|
| 「搜一下 X」「查 X 相关文章」「全文搜 X」 | 检索 | **本 skill**(全站) |
| 「看一下最近 X 的内容」「X 最近有什么」「X 更新了吗」「读读 X」 | 浏览某主体的内容流 | **先比对订阅范围**(见下) |
| 「我的订阅 / 我的公众号 / 我的网站」 | 已限定本人范围 | `supsub-sub` |
| 「我的关注点」 | 已限定本人范围 | `supsub-focus` |
浏览意图的处理步骤:
1. `supsub sub list -o json` + `supsub focus list -o json`;
2. 把 X 与 `name` / `title` 做**包含匹配(忽���大小写)**;
3. 命中订阅源 → `supsub sub contents --source-id <sid> --type <t>`;命中关注点 → `supsub focus contents --id <fid>`;**两边都命中就都列出来让用户选**(同一个词很可能既是源名又是关注点主题);
4. 命中后补一句「也可以全站搜 X 相关文章」,别把全局搜索这条路藏起来;
5. 一个都没命中 → **直接执行 `supsub search <X>` 全站搜索,不要反问「要不要我帮你搜一下」**。用户的浏览意图没有变,只是这个词不在他的订阅里;正确做法是搜完再说明「你没有订阅叫 X 的源,以下是全站结果」。
> **实测教训**:「看一下最近 Anthropic 的内容」曾被直接送进全站 search,返回一堆第三方评论文章,而用户自己订阅的 Anthropic 官方博客源、以及「Anthropic 公司动态与 AI 前沿进展」关注点被完全绕过。用户提某个主体名时,**他自己订阅的那份优先**。
## 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
### Search
```
supsub search <keyword> [--type <ALL|MP