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
      }
    ],
    "primarySource": "my_brief",
    "fallbackApplied": false,
    "details": { "triedSources": ["my_brief", "for_you"] }
  }
}

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