ghealth 是 Google Health API v4 的 CLI，覆盖 40 种经验证的数据类型，用于查询与写入个人健康数据。使用前需完成认证与全局标志配置。
用途与选择操作：每日总量（步数、距离、卡路里）用 daily-rollup，例如 ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29；单次读数（心率、体重、血氧）用 list；会话（运动、睡眠）用 list；每日摘要（静息心率、HRV、呼吸率）用 list；多源合并数据用 reconcile。注意 steps list 返回分钟级区间，总量需用 daily-rollup 的 countSum。
主要类型：daily-rollup 处理 steps、distance、total-calories、floors、active-minutes 等；list 处理心率、体重（可写）、体脂、身高、血氧、HRV、血糖、核心体温、睡眠呼吸率等；会话含 exercise（可写）与 sleep（可写，加 --detail 看分期）；心脏类 electrocardiogram、irregular-rhythm-notification 需专用 scope。营养日志 nutrition-log 支持 list/get/rollup/reconcile，food 与 food-measurement-unit 为参考目录。
分页与导出：list 默认 500 行，返回 nextPageToken 时用 --page-token 续取。导出用 -o 写文件，stdout 仅显示列结构与摘要，便于直接写分析代码；不要用管道重定向。
限制与注意事项：缺失日期不等于 0。--filter 仅支持 >= 和 <，时间字段语法因类型而异。写入为异步，返回 Operation；体重等可写类型有已知 API 缺陷（如身高更新报 400、体脂删除报 500）。日期敏感查询前建议先获取账户时区。