| name | bestblogs-explain |
| description | Use this skill when the user wants to understand the "why" behind BestBlogs recommendations — view their interest profile summary, see which followed sources are driving their daily brief, or inspect the score breakdown of a specific resource. Triggers include "BestBlogs 为什么推这条 / 看我的画像 / 我关注的源哪些最有价值 / 这篇文章评分多少", "why did BestBlogs recommend this", "which of my followed sources contribute most", "show score for this resource". Invokes the `bestblogs` CLI. |
bestblogs-explain — 解释层（画像 / 来源贡献 / 评分）
何时使用
- 用户问 "BestBlogs 为什么推这条？"
- 用户想看自己的兴趣画像摘要。
- 用户想知道哪些订阅源对我的早报贡献最大，作为决定是否继续关注的依据。
- 用户想知道某条资源的评分。
原语
| 原语 | CLI | 说明 |
|---|
bestblogs.interest_profile.get | bestblogs explain profile --json | 画像摘要 |
bestblogs.source.contribution.list | bestblogs explain sources --days 7 --json | 近 N 天关注源对早报的贡献 |
bestblogs.resource.score.get | bestblogs explain score <id> --json | 资源评分 |
相关字段（发现类响应内联）
注意：发现类接口的每条候选已内联 candidateSource / selectionReason / fallbackApplied / personalized。想解释 "为什么推这条"，首先看这些字段——不一定要单独调解释接口。只在需要更深入（画像维度 / 源级别 / 评分维度）时才走 explain 原语。
动作
画像摘要
bestblogs explain profile --json
关心字段：
onboardingCompletedlanguagePreferencedriftDetected — 漂移检测（true 时建议提醒用户重设兴趣）explicitInterests[] — 用户主动选择的标签implicitInterests[] — 行为推断recentActiveTopics[] — 近 7 天活跃主题
来源贡献
bestblogs explain sources --days 7 --json
返回按 count 倒序的来源列表：
{
"success": true,
"data": {
"days": 7,
"contributions": [
{ "sourceId": "SRC_xxx", "sourceName": "阮一峰的网络日志", "count": 4 },
...
]
}
}
资源评分
bestblogs explain score RAW_xxx --json
返回包括 score / resourceType / language / qualified / sourceName。
错误处理
401 → 未登录（profile 和 sources 需要登录；score 对公共资源可匿名）- 空列表（贡献为 0）→ 告知用户 "近 N 天没有被推荐的来源"，建议调整
--days 或关注更多高质量源
组合建议
- 用户抱怨 "最近推荐很一般" → 依次调
profile（看 drift）+ sources（看哪些源在拖后腿）+ 建议用户去 bestblogs-subscription 取关贡献少的源（本期无此 skill，提示用户到网站操作）
- Agent 给用户输出候选时：把
candidateSource + selectionReason 显示在每条旁边；当用户追问 "为什么这条分高"时才调 explain score
