介绍
# Fitbit CLI
从 Fitbit 可穿戴设备查询健康和健身数据。
## 命令
### 健康数据
```bash # Sleep logs (deep, light, REM, awake times) fitbit-cli -s # today fitbit-cli -s yesterday # yesterday fitbit-cli -s last-week # last 7 days fitbit-cli -s 2026-01-01 # specific date
# Heart rate time series fitbit-cli -e # today fitbit-cli -e last-week # last 7 days
# Blood oxygen (SpO2) fitbit-cli -o # today fitbit-cli -o last-3-days # last 3 days
# Active Zone Minutes fitbit-cli -a # today fitbit-cli -a last-month # last month
# Breathing rate fitbit-cli -b # today
# Daily activity (steps, calories, distance, floors) fitbit-cli -t # today fitbit-cli -t yesterday # yesterday ```
### 账户与设备
```bash # User profile fitbit-cli -u
# Connected devices (battery, sync status) fitbit-cli -d ```
### 日期格式
- 无参数：今天 - 具体日期：`2026-01-05` - 日期范围：`2026-01-01,2026-01-05` - 相对时间：`yesterday`（昨天）、`last-week`（上周）、`last-month`（上个月） - 自定义相对时间：`last-2-days`（过去 2 天）、`last-3-weeks`（过去 3 周）、`last-2-months`（过去 2 个月）
## 使用示例
**用户问：“我昨晚睡得怎么样？”** ```bash fitbit-cli -s yesterday ```
**用户问：“我这周的心率情况如何？”** ```bash fitbit-cli -e last-week ```
**用户问：“今天走了多少步？”** ```bash fitbit-cli -t ```
**用户问：“显示我的血氧水平”** ```bash fitbit-cli -o ```
**用户问：“我的 Fitbit 同步了吗？”** ```bash fitbit-cli -d ```
**用户问：“我上个月活跃度如何？”** ```bash fitbit-cli -a last-month ```
## 注意事项
- 对 Fitbit 数据的只读访问 - 令牌自动刷新（8 小时后过期） - 数据可能会因设备同步而延迟 - 首次设置：`fitbit-cli --init-auth`