Vital Agent Sync

要解决的问题

WorkBuddy 读 iPhone 健康数据的常见卡点，往往不在 MCP 本身，而在四处分散的动作：装运行时、扫码配对、等首次同步落库、等 MCP 审批通过。用户经常被要求自己找终端命令、改 shell 配置、起后台进程，或者在多个窗口之间复制粘贴深链。这个技能把这些步骤收敛成一条可确认的引导流程。

技能如何工作

• 一次性确认：安装固定版本 vitalmcp@0.5.3 到用户目录 ~/.vitalmcp/npm-global，创建私有状态目录 ~/.vital-agent-sync 与本地 SQLite，把 MCP 合并进 ~/.workbuddy/mcp.json，在当前会话启动局域网接收进程，并生成短时配对页面。
• 本机与局域网分离：浏览器只通过 127.0.0.1 打开页面，二维码内部携带的是 Mac 在可信局域网中的地址，iPhone 实际连接走 0.0.0.0:8787 上的接收端。
• 按返回类型推进：根据 next_action.type 在 MCP 审批、iOS 配对、会话托管三类状态间切换，审批不阻塞二维码显示；WorkBuddy 重启后只要 vital_agent_status 可调用，就用带 --mcp-verified 的恢复流程直接续上。
• 工具分层：宽泛问题先走 get_personal_context，具体问题按需取日摘要、睡眠趋势、训练负荷、恢复信号、周摘要和设备管理。
• 故障定位有顺序：先查 MCP 配置 JSON 与绝对路径是否存在，再查局域网可达性，再处理接收端身份冲突。

适用边界与注意点

• 这是用户控制的数据网关，不是医疗服务，不做诊断、开药或训练处方。
• 首发的一句话安装与后台服务只在 macOS 验证过，其他平台不会假装可用。
• 遇到 receiver_identity_conflict 时只给出脱敏诊断，不自动停旧进程、迁移数据库或换端口。
• 未批准 MCP 之前不读健康数据，也不通过 SQLite、CLI 内部 API 或手写 JSON-RPC 绕过权限边界。
• 只请求回答当前问题所需的最少数据，缺失或过期的数据直接说明，不推测补全。