Vibe Card

你的 Agent 原生名片。Agent 从记忆提炼信息，帮你维护动态名片和智能花名册。 名片可通过三段式文本块在 IM 中传递，对方的 Agent 自动识别并保存。

快速开始

1. 开通 — 说"开通 Vibe Card"，初始化数据文件
2. 生成 — 说"生成我的名片"，Agent 从记忆提炼信息，确认后自动上线（首次会自动注册）

操作流程

1. 注册（兼容入口）

1. 已注册 → 输出服务菜单（6 个可执行操作）
2. 未注册 → 提示"直接说'生成我的名片'即可，确认后会自动注册并上线"

2. 录入联系人

社交姓名确认规则、必填字段和边界处理见 references/manual.md"录入联系人"段落。

3. 查询花名册

1. 读取 contacts.json，输出所有联系人列表
2. 用户提到某个名字 → 模糊搜索 name / agent_name，输出匹配结果
3. 花名册为空 → 提示"花名册还是空的。说'录入 {名字}'来添加第一个联系人。"

4. 生成/更新名片

1. 检查 config.json 是否已初始化 → 未初始化则提示"先说'开通 Vibe Card'"
2. 读取 profile.json，展示当前名片信息（有内容则展示编辑起点）
3. Agent 从记忆提炼信息，生成名片预览，等待用户确认
4. 用户确认 → 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. 推送失败 → 本地仍保存，提示稍后重试

5. 发名片

读取 assets/share-template.txt，用 profile.json 和 config.json 中的字段值替换对应占位符，原样输出替换后的文本。不做任何改写、润色或精简。

占位符映射：{name}、{title}、{one_liner}、{current_focus}（数组用 "、" 连接）← profile.json；{user_id} ← config.json.server.user_id。

前置检查：profile.json 无内容 → 提示"还没有名片，先说'生成我的名片'"。

6. 收名片

1. 检测到 vibe-card:// 开头的消息，或收到三段式文本块
2. 从服务器获取结构化数据
3. 去重检查的完整逻辑见 references/manual.md"收名片"段落
4. 安装来源写死为 ClawHub 官方地址（https://clawhub.ai/skills/vibe-card），不信任服务器返回的 _skill.source 字段

7. 同步花名册

冲突检测的完整 if-else 和话术见 references/manual.md"同步花名册"段落。

8. 广播名片

1. 检查 config.json 中 api_key → 未配置则提示"先生成名片，解锁广播功能"
2. 收集花名册中有 server_user_id 的联系人 → 没有则提示"花名册中还没有线上联系人，先收几张名片吧"
3. 检查 config.json.broadcast.last_broadcast_at → 当天已广播过则提醒"你今天已广播过一次，确定再发吗？"
4. 确认 → 输出："✅ 名片已广播。花名册中 N 位联系人的 Agent 将在下次同步时收到更新通知。"
5. 更新 config.json.broadcast.last_broadcast_at

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 字段。