用途：google-health-cli 是 Google Health API v4 的命令行客户端，面向 AI 智能体与开发者，用于读取和写入个人健康数据。支持 40 多种数据类型，包括步数、心率、运动、睡眠、体重、SpO2、HRV、ECG、血糖和营养等。
主要能力：读取数据支持 list、rollup、daily-rollup、reconcile 等操作；运动与睡眠、体重等类型支持 create、update、delete；运动轨迹可导出为 TCX 或 CSV。所有读取命令输出确定性 JSON，包含 dataPoints、_hints 和可选的 nextPageToken，并配有 0 至 5 的退出码区分成功、一般错误、认证/校验错误、API 错误、数据未找到和配置错误。
安装与认证：通过 git clone 仓库后执行 go build -o ghealth . 构建，并将二进制移动到 PATH。认证可用 ghealth setup 交互式完成，或在 CI/智能体中用 --project-id、--client-secret、--scopes-preset、--skip-enable-api、--no-prompt 等参数非交互式完成；无头环境可用 ghealth auth login --non-interactive 获取 auth_url，再用 ghealth auth login --complete 完成。凭据默认存于 ~/.config/ghealth/，可用 GHEALTH_CONFIG_DIR 覆盖；也支持 GHEALTH_ACCESS_TOKEN、GHEALTH_CREDENTIALS_FILE 环境变量，优先级为访问令牌 > 凭据文件 > 已存凭据 > 应用默认凭据。
使用方式：读取示例包括 ghealth data heart-rate list --from today --limit 10、ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29。注意步数、距离等区间类型应使用 daily-rollup 获取实际汇总值，list 只返回时间区间。写入示例包括 ghealth data exercise create、ghealth data sleep create、ghealth data weight create，删除用 delete。可用 --dry-run 预览请求，--raw 获取原始响应，--page-token 翻页。
适用场景：适合智能体或脚本做每日健康看板、周步数汇总、批量导出运动数据、数据对账等自动化任务。
限制：需要自行配置 Google Cloud 项目、启用 Health API 并创建 OAuth 桌面应用凭据；API 存在速率限制，批量操作需加延迟；缺失日期表示设备未佩戴或未同步，不应按 0 处理，也不应对缺失日做平均；时间使用 ISO 8601 或 today、yesterday 等快捷写法。具体收费、价格与平台支持范围资料未提供。