bestblogs-profile — BestBlogs Intake（冷启动 / 画像）

何时使用

• 用户第一次使用 BestBlogs，希望建立兴趣画像。
• 用户想查看自己当前选了哪些兴趣标签、语言偏好、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

输出示例：

{
  "success": true,
  "data": {
    "onboardingCompleted": true,
    "interestTagCount": 3,
    "followedSources": 10,
    "languagePreference": "both"
  }
}

交互建档（推荐真人场景）

bestblogs intake setup

（CLI 会用 prompts 弹出多选，Skill 在支持 shell 的 agent 里 fork 子进程执行即可。）

查画像

bestblogs 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 应拿到结构化结果，例如：

{
  "onboardingCompleted": true,
  "explicitInterestCount": 6,
  "languagePreference": "both",
  "driftDetected": false,
  "recentActiveTopics": ["AI Coding", "Dev Tools"]
}

组合建议

• 冷启动完成后，立即调用 bestblogs-discover 展示 "today" 列表，给用户第一次价值点击。
• 定期（每周或 drift 触发时）调用 profile.get，根据 driftDetected=true 建议用户打开 bestblogs-profile setup 重新调整。