用途:通过 healthsync CLI,在本地网络内将 iPhone 的 Apple HealthKit 数据同步到 Mac,采用 mTLS 与证书固定保障传输安全。
主要能力:支持设备发现与配对;按时间范围抓取多种健康数据类型,输出 CSV(默认)或 JSON;查看连接状态与已启用数据类型。数据类型覆盖活动(steps、distanceWalkingRunning、distanceCycling、activeEnergyBurned、basalEnergyBurned、exerciseTime、standHours、flightsClimbed、workouts)、心脏(heartRate、restingHeartRate、walkingHeartRateAverage、heartRateVariability)、体征(血压、血氧、呼吸频率、体温、vo2Max)、睡眠(sleepAnalysis 及分项)与身体(weight、height、bodyMassIndex、bodyFatPercentage、leanBodyMass)。
使用方式:首次配对先运行 healthsync discover 发现设备,在 iOS 应用点击 Share 生成二维码并复制,再运行 healthsync scan(也可 healthsync scan --file 图片路径);随后用 healthsync status、healthsync types 检查状态与类型,用 healthsync fetch --start ... --end ... --types ... 抓取数据,可加 --format json 并用 jq 处理或重定向到文件。配置存于 ~/.healthsync/config.json(权限 0600),Token 存于 macOS Keychain(服务 org.mvneves.healthsync.cli)。
限制与安全:仅限本地网络,主机校验只允许 localhost、*.local、私有 IPv4 段与 IPv6 回环/链路本地地址;服务器证书按 SHA256 指纹以 TOFU 模型固定,指纹不匹配即拒绝连接以防中间人攻击;配对码约 5 分钟过期,证书不匹配时需删除配置文件重新配对。其余细节(如平台版本、安装方式、收费)暂未提供。