| name | bestblogs-discover |
| description | Use this skill when the user wants to find today's most worth-reading content from BestBlogs, browse personalized feeds, check trending items, search specific topics, or explore curated newsletters. Triggers include "今天有什么值得读的 / BestBlogs 推荐 / 本周 BestBlogs 热趋 / 搜一下 AI coding / 看关注源的最新 / 最近有什么好周刊", "what's worth reading today", "bestblogs trending this week", "bestblogs discover", "search BestBlogs". Invokes the `bestblogs` CLI. |
bestblogs-discover — 发现（今日 / 个性化 / 关注流 / 热趋 / 搜索 / 周刊）
何时使用
- 用户想快速了解 "今天最值得读的内容"（最重要触发）。
- 用户想找某个主题、作者、内容类型的 BestBlogs 精选。
- 用户想浏览周刊。
原语
| 原语 | CLI | 说明 |
|---|
bestblogs.discover.today | bestblogs discover today --json | 带多源回退链的今日候选 |
bestblogs.discover.for_you | bestblogs discover for-you --json | 个性化推荐（需 Pro） |
bestblogs.discover.following | bestblogs discover following --json | 关注源流 |
bestblogs.discover.trending | bestblogs discover trending --period week --json | 热趋内容（today / week / month） |
bestblogs.discover.search | bestblogs discover search "<q>" --json | 关键词搜索 |
bestblogs.discover.newsletter.list | bestblogs discover newsletters --json | 周刊列表 |
bestblogs.discover.newsletter.get | bestblogs discover newsletter <id> --json | 单期周刊 |
前置检查
bestblogs auth status --json
多数命令需要 API Key；search、newsletters 在某些配置下也可匿名消费。若未登录，提示先 bestblogs auth login。
核心动作：discover today
bestblogs discover today --limit 20 --json
返回：
{
"success": true,
"data": {
"candidates": [
{
"resourceId": "RAW_xxx",
"title": "...",
"url": "...",
"resourceType": "ARTICLE",
"language": "en_US",
"score": 92,
"sourceName": "...",
"candidateSource": "my_brief",
"selectionReason": "今日个性化精选",
"fallbackApplied": false,
"personalized": true
candidateSource 枚举：
my_brief — Pro 个性化早报public_brief — 公共精选（非 Pro 或未生成个性化时）public_brief_fallback — 公共早报降级兜底for_you — For You 推荐following — 关注源
展示给用户时应按 candidateSource 打徽标，并显式标注降级状态（fallbackApplied=true 时）。
其它动作
bestblogs discover for-you --limit 15 --lang en_US --json
bestblogs discover trending --period week --limit 20 --json
bestblogs discover trending --period today --lang zh_CN --json
bestblogs discover search "AI coding" --type ARTICLE --sort score --limit 10 --json
bestblogs discover newsletters --limit 10 --json
bestblogs discover newsletter <id> --json
错误处理
403 / FORBIDDEN on for-you → 用户非 Pro，降级到 following 或 today404 / NOT_FOUND on brief 相关 → 当日早报尚未生成，尝试 public_brief 或 following429 / RATE_LIMITED → CLI 已退避一次；仍失败时退出并告诉用户稍后重试- 空
candidates → 向用户报告 "今日无推荐"，建议做 bestblogs intake setup 建立/修正画像
组合建议
- 拿到候选后，对感兴趣的条目链式调用
bestblogs-read skill 做深读
- 高价值条目链式调用
bestblogs-capture skill 收藏/加笔记
- 想知道 "为什么推这条"？把
candidateSource / selectionReason 直接展示；更深层的解释（如贡献来源的评分）用 bestblogs-explain skill
