bestblogs-profile — BestBlogs Intake(冷启动 / 画像)
何时使用
- 用户第一次使用 BestBlogs,希望建立兴趣画像。
- 用户想查看自己当前选了哪些兴趣标签、语言偏好、onboarding 是否完成。
- 用户想重新设置一遍兴趣(作为漂移干预或重置)。
原语
| 原语 | CLI | 说明 |
|---|---|---|
bestblogs.profile.setup | bestblogs intake setup | 交互或非交互地完成 onboarding |
bestblogs.profile.get | bestblogs intake show --json | 获取当前画像 + onboarding 状态 |
前置检查
bashbestblogs auth status --json
若输出 loggedIn: false 或报 AUTH_REQUIRED,先提示用户运行 bestblogs auth login,获取 API Key 来自 https://bestblogs.dev/settings/api-keys。
动作
非交互建档
bashbestblogs intake setup --non-interactive \ --tags "tag_ai,tag_coding,tag_product" \ --lang both \ --source-limit 10 \ --json
输出示例:
json{ "success": true, "data": { "onboardingCompleted": true, "interestTagCount": 3, "followedSources": 10, "languagePreference": "both" } }
交互建档(推荐真人场景)
bashbestblogs intake setup
(CLI 会用 prompts 弹出多选,Skill 在支持 shell 的 agent 里 fork 子进程执行即可。)
查画像
bashbestblogs intake show --json
关心的字段(parse 时按需取):
data.interests.explicitInterests[]— 显式兴趣(含 tagName, weight)data.interests.implicitInterests[]— 隐式兴趣data.interests.recentActiveTopics[]— 近 7 天活跃主题data.onboarding— onboarding 状态data.interests.driftDetected— 是否有漂移
错误处理
error.code=AUTH_REQUIRED→ 提示运行bestblogs auth login,中断流程error.httpStatus=403→ 某些子能力需要 Pro,提示用户升级error.code=RATE_LIMITED→ CLI 已自动退避重试一次;如仍失败告知用户稍后重试
输出契约
Skill 的 caller 应拿到结构化结果,例如:
json{ "onboardingCompleted": true, "explicitInterestCount": 6, "languagePreference": "both", "driftDetected": false, "recentActiveTopics": ["AI Coding", "Dev Tools"] }
组合建议
- 冷启动完成后,立即调用
bestblogs-discover展示 "today" 列表,给用户第一次价值点击。 - 定期(每周或 drift 触发时)调用
profile.get,根据driftDetected=true建议用户打开bestblogs-profile setup重新调整。

