SuperAPI AI 工具集

apple_healthkit

数据与分析

查看项目

更新于 10-16 07:24

技能介绍

用途:读取用户同步的 Apple Health(HealthKit)数据,覆盖全天指标、睡眠、锻炼与原始样本,并查看同步状态或删除已存记录。仅服务 iOS 设备;若配对设备不是 iPhone 则无数据,可用 device.list 的 platform 字段确认。数据虽来自 HealthKit,但可能源自其他共享数据的设备或来源。

主要能力:query metrics 返回全天指标汇总(步数、距离、卡路里、心率、HRV、VO2max 等),按 hourly/daily/weekly 分桶,默认 daily;query sessions 按 --category sleep|workout 返回离散会话(睡眠阶段、质量、效率、觉醒;锻炼类型、时长、卡路里、距离、心率);query samples 返回未分桶原始数据点(日内心率/步数、GPS、睡眠阶段时间线),GPS 为原始经纬度,不应推断地名;status 返回各类别记录数与时间范围,加 --check-missing-entries 可做每 30 分钟间隔的缺口报告;auth connect/disconnect 管理连接;delete 删除已存记录。

使用方式:所有命令必须带 --provider healthkit,且 --start-date 必填,--end-date 默认今天。示例:health-cli query metrics --provider healthkit --start-date <YYYY-MM-DD> [--end-date <YYYY-MM-DD>] [--interval hourly|daily|weekly] [--fields a,b,c];health-cli query sessions --provider healthkit --category sleep|workout --start-date <YYYY-MM-DD>;health-cli query samples --provider healthkit --start-date <YYYY-MM-DD> [--fields ...] [--limit n] [--format stdout|csv] [--output <path>];health-cli status --provider healthkit;health-cli auth connect --provider healthkit;health-cli delete --provider healthkit --all 或 --device NODE_ID 或 --start-date/--end-date。用 --list-fields 发现字段,--list-categories 发现会话类别。

适用场景:查询同步的 HealthKit 指标、睡眠、锻炼、同步状态与数据来源;需要日内原始样本时用 samples,趋势优先用 metrics。

限制:Apple Health 无法通过 CLI 或聊天组件断开,需在设置→连接器→Apple Health 中手动断开。查询返回 coverage 信封,complete 为 false 表示窗口内部分日期未同步,warning 会给出 backfill_data_source 命令,需先回填再查询。多设备窗口会标记 multi_node,metrics 返回按设备分组的 node_groups,samples/sessions 每条记录带 node_id,不可跨设备求和或重复计数。delete 为破坏性且不可逆,需一次性审批,按请求执行一次;拒绝返回退出码 3 且不删除任何内容,不应重试其他过滤条件或另一提供方;零匹配是成功而非遗漏,应报告 deleted.records 而非 total_rows;设备上仍存在的记录可能在后续同步中重新出现。删除不跨提供方,需分别执行。auth disconnect 无法通过 CLI 完成。其余细节暂未提供。