概述
Samsung Health CLI 是一款面向 Samsung Galaxy Watch/Ring 用户的开源命令行工具，用于深度分析 Health Connect 备份至 Google Drive 的健康数据。该工具支持睡眠分期、步数追踪、心率监测、血氧（SpO2）及运动历史的多维度查询，适合数据敏感型用户实现健康数据的本地化掌控。
核心用法
安装后通过 shealth sync 从 Google Drive 拉取数据，支持 today、sleep、steps、heart、spo2、workout、report 等子命令，可指定时间范围（如 --days 14）并输出 JSON 格式供二次开发。配置需编辑 YAML 文件指定 Drive 文件夹 ID、账户及目标值。
显著优点
1. 数据主权：所有分析在本地执行，原始数据不经过第三方服务器，满足隐私优先需求；
2. 功能完整：覆盖睡眠分期（Light/Deep/REM/Awake）、SpO2、Energy Score 等 Samsung Health 核心指标；
3. 开源可审计：代码公开，可验证数据处理逻辑；
4. 轻量集成：依赖 Python 虚拟环境与 gog CLI，无重型服务端组件。
潜在缺点与局限性
- 硬件门槛：需 Samsung Galaxy Watch 4+ 或 Galaxy Ring 方可启用 SpO2/HRV 数据采集；
- 配置复杂：需手动配置 Google Drive API 权限、文件夹 ID 及 Health Connect 备份，入门成本高于官方 App；
- 生态封闭：仅支持 Samsung Health 数据格式，无法兼容 Apple Health 或其他品牌设备；
- 无实时同步：依赖 Google Drive 备份周期，数据存在延迟（非实时流式处理）。
适合人群
- 注重隐私、希望避免云端健康数据托管的 Samsung 穿戴设备用户；
- 开发者或数据分析师，需将健康数据导入本地分析 pipeline；
- 量化自我（Quantified Self）爱好者，追求细粒度历史数据导出与自定义报告。
常规风险
- 数据泄露风险：Google Drive 作为中转存储，需确保账户安全及分享权限最小化；
- 配置误操作：错误的
folder_id或权限设置可能导致数据同步失败或拉取他人数据； - 健康建议局限：工具仅提供原始数据展示，不具备医疗诊断资质，异常指标需咨询专业医师。