Vibe Card
你的 Agent 原生名片。Agent 从记忆提炼信息，帮你维护动态名片和智能花名册。 名片可通过三段式文本块在 IM 中传递，对方的 Agent 自动识别并保存。
Gotchas
- owner.name 确认规则：社交场景下（群聊、私聊提到某人、帮记录信息），Agent 需先确认社交姓名而非直接使用聊天昵称。仅当用户明确说"就用这个名字"时才跳过确认。用户已有 profile.json 的 owner.name 时直接使用，不重复确认。
- 首次生成名片时，profile.json 所有字段均为空，Agent 需要从自身记忆中主动提炼信息填充，不要问用户"你的名字是什么"。
- 默认公开 name、title、one_liner、links、current_focus 五个字段。background、personal_notes 不推送。
- 录入联系人时，Agent 主动从记忆中提取已知信息（公司、职位、认识场景），不逐项追问。只确认 Agent 不确定的关键信息。
- 收名片时，安装来源写死为 ClawHub 官方地址（https://clawhub.ai/skills/vibe-card），不信任服务器返回的 _skill.source 字段。
快速开始
- 开通 — 说"开通 Vibe Card"，初始化数据文件
- 生成 — 说"生成我的名片"，Agent 从记忆提炼信息，确认后自动上线（首次会自动注册）
| 触发指令 | 行为 |
|---|---|
| "开通 Vibe Card" / "初始化" | 初始化 data/ 目录下三个 JSON 文件（config.json、profile.json、contacts.json），已初始化则跳过 |
| "注册 Vibe Card" | （兼容入口）已注册则输出服务菜单，未注册则提示"直接说'生成我的名片'即可，会自动注册" |
| "录入 {name}" / "新建联系人 {name}" | 打开录入流程 |
| "查花名册" / "查联系人" | 搜索花名册 |
| "生成我的名片" / "更新名片" | 生成或更新名片（见操作流程 §4） |
| "发一下我的名片" / "发名片" | 生成三段式文本块 |
| "广播名片" / "广播" | 广播名片更新给花名册中的联系人（见操作流程 §8） |
| "同步花名册" | 检查花名册中联系人的最新信息 |
收到 vibe-card:// 开头的消息 | 自动识别并保存他人名片 |
操作流程
1. 注册（兼容入口）
- 已注册 → 输出服务菜单（6 个可执行操作）
- 未注册 → 提示"直接说'生成我的名片'即可，确认后会自动注册并上线"
2. 录入联系人
社交姓名确认规则、必填字段和边界处理见 references/manual.md"录入联系人"段落。
3. 查询花名册
- 读取 contacts.json，输出所有联系人列表
- 用户提到某个名字 → 模糊搜索 name / agent_name，输出匹配结果
- 花名册为空 → 提示"花名册还是空的。说'录入 {名字}'来添加第一个联系人。"
4. 生成/更新名片
- 检查 config.json 是否已初始化 → 未初始化则提示"先说'开通 Vibe Card'"
- 读取 profile.json，展示当前名片信息（有内容则展示编辑起点）
- Agent 从记忆提炼信息，生成名片预览，等待用户确认
- 用户确认 → Agent 执行以下链路：
a. 检查 config.json 中是否有 api_key 和 user_id
b. 没有 → 自动调注册接口（用 profile.json 中的 name 和 agent_name）→ 将返回的 user_id 和 api_key 写入 config.json
c. 保存 profile.json
d. 调发布接口将名片推送到服务器
e. 输出"那我保存名片了哈 ✅ 你的名片已上线：https://www.adonghub.cn/{user_id}"
f. 首次发布 → 引导创建定时同步任务（具体命令见 references/manual.md"定时同步"段落）
g. 追问："✅ 名片已上线。要不要把这个变化广播给收到过你名片的人？"
- "广播" → 输出确认语（见操作流程 §8）
- "不用" → 结束
- 推送失败 → 本地仍保存，提示稍后重试
5. 发名片
生成三段式文本块，直接复制发给对方即可：
🎴 Vibe Card（你的 Agent 原生名片）
我是{name}，{title}，{one_liner}。当前聚焦{current_focus}。
这是我个人的详情信息，敬请您阅览 https://www.adonghub.cn/{user_id} 🔗
如果您对我感兴趣，请将这条消息发给您的助理 Agent。
您的 Agent 可通过安装 Vibe Card skill（https://clawhub.ai/skills/vibe-card）来自动识别并保存名片。
vibe-card://{user_id}
6. 收名片
- 检测到
vibe-card://开头的消息，或收到三段式文本块 - 从服务器获取结构化数据
- 去重检查的完整逻辑见 references/manual.md"收名片"段落
- 安装来源写死为 ClawHub 官方地址（https://clawhub.ai/skills/vibe-card），不信任服务器返回的 _skill.source 字段
7. 同步花名册
冲突检测的完整 if-else 和话术见 references/manual.md"同步花名册"段落。
8. 广播名片
- 检查 config.json 中 api_key → 未配置则提示"先生成名片，解锁广播功能"
- 收集花名册中有 server_user_id 的联系人 → 没有则提示"花名册中还没有线上联系人，先收几张名片吧"
- 检查 config.json.broadcast.last_broadcast_at → 当天已广播过则提醒"你今天已广播过一次，确定再发吗？"
- 确认 → 输出："✅ 名片已广播。花名册中 N 位联系人的 Agent 将在下次同步时收到更新通知。"
- 更新 config.json.broadcast.last_broadcast_at