HealthKit数据同步

技能简介

healthkit-sync 是一套用于在 iPhone 与 Mac 之间通过本地网络安全同步 Apple HealthKit 数据的 CLI 命令与模式。采用 mTLS 双向认证、证书 SHA256 指纹固定（TOFU 模型）及 macOS Keychain 令牌存储，确保健康数据（步数、心率、睡眠、运动等）传输过程的机密性与完整性。

能做什么

• 发现本地网络中的 iOS 设备并完成首次配对
• 扫描 QR 码或从图片文件导入配对信息
• 按时间范围获取指定健康数据类型（CSV/JSON 格式）
• 查询连接状态与已启用的数据类型列表
• 管理 ~/.healthsync/config.json 配置与 Keychain 令牌

使用说明

安装前提：macOS 系统，已安装 healthsync CLI（~/.healthsync/config.json）。

安装步骤：

1. 克隆项目仓库并进入 macOS/HealthSyncCLI 目录
2. 执行 swift build 编译，或使用预构建二进制文件
3. 将生成的可执行文件加入 PATH，或直接使用 ./.build/debug/healthsync

首次配对流程：

# 1. 发现局域网设备
healthsync discover

# 2. 在 iOS 应用中点击"Share"生成 QR 码，选择"Copy"
# 3. 从剪贴板扫描（依赖通用剪贴板）
healthsync scan

# 或从图片文件扫描
healthsync scan --file ~/Desktop/qr.png

获取健康数据：

# 检查连接状态
healthsync status

# 列出已启用数据类型
healthsync types

# 获取步数 CSV
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-12-31T23:59:59Z --types steps

# 获取多类型 JSON 并格式化
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-12-31T23:59:59Z \
  --types steps,heartRate,sleepAnalysis --format json | jq

# 输出到文件
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-12-31T23:59:59Z \
  --types steps > steps.csv

配置文件位置：~/.healthsync/config.json（权限 0600），Token 存储于 macOS Keychain（service: org.mvneves.healthsync.cli）。

输入与输出

见下方输入与输出表格。

风险提示

• 配对码 5 分钟过期，超时需重新生成 QR 码
• 证书指纹不匹配时连接被拒绝，可能因服务器证书重置，需删除配置重新配对
• config.json 权限必须为 0600，避免其他用户读取主机地址与指纹
• 仅支持本地网络连接，跨网段或公网访问被架构限制
• iOS 应用未运行或防火墙阻断 mDNS（5353 端口）会导致设备发现失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mneves75/healthkit-sync/SKILL.md
来源类型：GitHub 开源项目文档