SuperAPI AI 工具集

google_health_connect

数据与分析

查看项目

更新于 10-15 17:19

技能介绍

用途:通过 health-cli 二进制读取用户 Android 设备同步的 Google Health Connect 数据。仅服务 Android 设备;若配对设备非 Android,则无数据,可用 device.list 返回的 platform 字段确认。

主要能力:按数据形态分三类命令,均须带 --provider healthconnect(无默认值,省略即用法错误)。query metrics 返回全天指标汇总(步数、距离、卡路里、心率、HRV、VO2max),默认按日分桶,可用 --interval hourly|daily|weekly;query samples 返回原始未分桶数据点(日内心率/步数、GPS、睡眠阶段时间线);query sessions --category sleep|workout 返回离散会话(睡眠阶段、质量、效率、觉醒;锻炼类型、时长、卡路里、距离、心率)。status 查看同步状态,auth connect/disconnect 管理连接,delete 删除已存记录。

用法要点:命令需 --start-date(YYYY-MM-DD),--end-date 默认今天。用 --list-fields 发现字段,observed:true 表示该用户数据中存在。查询返回 { coverage, records } 信封;coverage.complete 为 false 表示窗口内部分日期未同步,coverage.warning 给出应执行的 backfill_data_source 命令,需转告用户或执行后重查。密集读取用 --output <path> 写 CSV,避免大量行进入上下文。多设备窗口会加 multi_node:true,切勿跨设备求和或重复计数。

限制:数据可用性取决于 Android 设备上 Health Connect 权限获批及同步;无登录。Health Connect 无法通过 CLI 或聊天组件断开,需用户在 Android 设置中撤销权限。delete 为破坏性且不可逆操作,需一次性审批,按请求执行一次;拒绝返回退出码 3 且不删除,属最终结果。删除后若设备仍保留记录,后续同步可能恢复。GPS 为原始经纬度,不应推断地名。资料未提供价格、平台支持范围等更多信息。