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 | 单期周刊 |
前置检查
bashbestblogs auth status --json
多数命令需要 API Key;search、newsletters 在某些配置下也可匿名消费。若未登录,提示先 bestblogs auth login。
核心动作:discover today
bashbestblogs discover today --limit 20 --json
返回:
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 时)。
其它动作
bash# 个性化流 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 / FORBIDDENonfor-you→ 用户非 Pro,降级到following或today404 / NOT_FOUNDon brief 相关 → 当日早报尚未生成,尝试public_brief或following429 / RATE_LIMITED→ CLI 已退避一次;仍失败时退出并告诉用户稍后重试- 空
candidates→ 向用户报告 "今日无推荐",建议做bestblogs intake setup建立/修正画像
组合建议
- 拿到候选后,对感兴趣的条目链式调用
bestblogs-readskill 做深读 - 高价值条目链式调用
bestblogs-captureskill 收藏/加笔记 - 想知道 "为什么推这条"?把
candidateSource/selectionReason直接展示;更深层的解释(如贡献来源的评分)用bestblogs-explainskill

