SuperAPI AI 工具集

apple_healthkit

数据与分析

查看项目

更新于 10-15 17:19

技能介绍

用途:通过 health-cli 二进制读取用户同步的 Apple Health(HealthKit)数据,每条命令都必须带 --provider healthkit。仅服务 iOS 设备;若配对设备不是 iPhone 则无数据,可用 device.list 返回的 platform 字段确认。数据虽同步自 HealthKit,但可能来自其他共享数据的来源或设备。

主要能力:query metrics 获取全天指标汇总(步数、距离、卡路里、心率、HRV、VO2max),按 hourly/daily/weekly 分桶,默认 daily;query samples 获取原始未分桶数据点(日内心率/步数、GPS、睡眠阶段时间线);query sessions --category sleep|workout 获取离散会话(睡眠、锻炼);status 查看同步状态,加 --check-missing-entries 可生成每 30 分钟间隔的缺口报告;auth connect/disconnect 管理连接;delete 删除已存记录。

使用方式:命令形如 health-cli query metrics --provider healthkit --start-date <YYYY-MM-DD> [--end-date <YYYY-MM-DD>] [--interval hourly|daily|weekly] [--fields a,b,c] [--timeout-secs N]。--start-date 必填,--end-date 默认今天。用 --list-fields 发现字段,--list-categories 发现会话类别。密集读取用 --output <path> 写 CSV 到文件系统,仅打印摘要。

限制:查询返回 { "coverage": {...}, "records": [...] },coverage.complete 为 false 表示窗口内部分日期未同步,coverage.warning 会给出 backfill_data_source 命令,需告知用户并执行后重查。多设备窗口会加 multi_node: true,切勿跨设备求和或重复计数。GPS 为原始经纬度,不应推断地名。delete 具破坏性且不可逆,需一次性审批,拒绝后退出码 3 且不删除,零匹配也算成功。Apple Health 无法通过 CLI 或聊天组件断开,需在设置→连接器→Apple Health 中操作。数据为设备同步,无登录,可用性取决于设备端 Health 权限与同步。