用途:bestblogs-explain 是 BestBlogs 的解释层技能,用于说明推荐背后的原因,包括兴趣画像、来源贡献和资源评分。适合用户追问“为什么给我推这条”“哪些订阅源贡献最大”“这条资源评分多少”时使用。
主要能力:一是获取画像摘要,命令为 bestblogs explain profile --json,关注字段有 onboardingCompleted、languagePreference、driftDetected(为 true 时提示用户重设兴趣)、explicitInterests[]、implicitInterests[]、recentActiveTopics[]。二是查看来源贡献,命令为 bestblogs explain sources --days 7 --json,返回按 count 倒序的来源列表,含 sourceId、sourceName、count。三是查询资源评分,命令为 bestblogs explain score <id> --json,返回 score、resourceType、language、qualified、sourceName。
使用方式:发现类接口的每条候选已内联 candidateSource、selectionReason、fallbackApplied、personalized 字段;解释“为什么推这条”应优先看这些字段,仅在需要更深入了解画像维度、源级别或评分维度时才调用 explain 原语。给用户输出候选时,可把 candidateSource 与 selectionReason 显示在每条旁边。
限制与错误处理:401 表示未登录,profile 和 sources 需要登录,score 对公共资源可匿名。若贡献列表为空,应告知用户“近 N 天没有被推荐的来源”,建议调整 --days 或关注更多高质量源。用户抱怨推荐质量下降时,可依次调用 profile(看 drift)与 sources(看哪些源在拖后腿),并建议用户到网站取消关注贡献少的源;取消关注操作本期无对应技能,需提示用户到网站操作。