用途:该技能用于 BestBlogs 的 Intake(冷启动 / 画像)环节。当用户首次使用、想查看当前兴趣标签与语言偏好、确认 onboarding 是否完成,或想重新设置兴趣(作为漂移干预或重置)时使用。
主要能力:
- 建档:通过 bestblogs intake setup 交互或非交互完成 onboarding。
- 查画像:bestblogs intake show --json 获取当前画像与 onboarding 状态。
前置检查:运行 bestblogs auth status --json,若输出 loggedIn: false 或报 AUTH_REQUIRED,先提示用户运行 bestblogs auth login,API Key 来自 https://bestblogs.dev/settings/api-keys。
使用方式:
非交互建档:
bestblogs intake setup --non-interactive
--tags "tag_ai,tag_coding,tag_product"
--lang both
--source-limit 10
--json
交互建档(推荐真人场景):bestblogs intake setup,CLI 会用 prompts 弹出多选。
查画像:bestblogs intake show --json,可解析 data.interests.explicitInterests[]、implicitInterests[]、recentActiveTopics[]、data.onboarding、data.interests.driftDetected 等字段。
错误处理:AUTH_REQUIRED 提示先登录并中断;httpStatus=403 表示某些子能力需要 Pro;RATE_LIMITED 时 CLI 已自动退避重试一次,仍失败则告知稍后重试。
输出契约示例:caller 应拿到结构化的 onboardingCompleted、explicitInterestCount、languagePreference、driftDetected、recentActiveTopics 结果。
组合建议:冷启动完成后立即调用 bestblogs-discover 展示今日列表;定期或 driftDetected=true 时建议用户重新运行 setup 调整。
限制:具体兴趣标签取值、Pro 功能边界与价格等资料暂未提供。