核心用法
Fitbit CLI 是一款命令行工具，用于读取 Fitbit 可穿戴设备的健康与健身数据。支持查询睡眠阶段（深睡、浅睡、REM、清醒）、心率时序、血氧饱和度（SpO2）、呼吸频率、活跃区间分钟数及日常活动（步数、卡路里、距离、楼层）等多维度指标。
命令结构简洁，支持多种时间参数：无参数默认为当天，可指定具体日期（2026-01-05）、日期范围、相对时间（yesterday、last-week、last-month）或自定义周期（last-2-days、last-3-weeks）。首次使用需执行 fitbit-cli --init-auth 完成 OAuth 授权，令牌每 8 小时自动刷新。
显著优点
- 数据维度全面：覆盖睡眠、心率、血氧、呼吸、运动五大核心健康指标，满足健身爱好者与健康管理者的追踪需求
- 查询灵活：支持从单日到多月的时间跨度，适配日常快速查看与周期性回顾场景
- 自动化授权：令牌自动刷新机制降低手动维护成本
- 设备状态同步：可检查设备电量与同步状态，确保数据时效性
潜在局限
- 只读权限：无法修改或写入数据，纯查询工具
- 数据延迟：依赖设备与云端同步，可能存在数分钟至数小时的延迟
- 硬件依赖：必须有 Fitbit 设备才能产生数据，无法独立运行
- 生态封闭：仅支持 Fitbit 生态，不兼容 Apple Health、Garmin 等其他平台
适合人群
Fitbit 设备用户、健身追踪爱好者、关注睡眠质量的亚健康人群、需要量化健康指标进行生活方式管理的用户。
常规风险
- 隐私敏感：涉及心率、睡眠等高度个人化健康数据，需注意本地环境与传输安全
- 授权管理：OAuth 令牌需妥善保管，避免泄露导致数据被未授权访问
- 数据解读风险：非医疗级设备，指标异常时不可替代专业医疗诊断