Fitbit

核心用法

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 令牌需妥善保管，避免泄露导致数据被未授权访问
• 数据解读风险：非医疗级设备，指标异常时不可替代专业医疗诊断

Fitbit 健康数据查询 Skill 评估

核心用法

本 Skill 是一个纯文档型工具，提供通过 fitbit-cli 命令行工具查询 Fitbit 穿戴设备健康数据的完整使用指南。支持查询的数据类型包括：睡眠日志（深睡、浅睡、REM、清醒时长）、心率时间序列、血氧饱和度（SpO2）、活跃区间分钟数、呼吸频率以及每日活动数据（步数、卡路里、距离、楼层）。

使用方法为在终端执行带参数的 fitbit-cli 命令，通过 -s、-e、-o、-a、-b、-t 等选项指定数据类型，支持 today、yesterday、last-week、last-month 等相对时间表达式，以及 2026-01-01 具体日期和日期范围查询。

显著优点

1. 零代码执行风险：纯 Markdown 文档型 Skill，不含任何可执行代码，不存在命令注入或恶意执行风险
2. 只读访问设计：所有功能均为只读查询，不修改用户健康数据，符合数据最小化原则
3. 功能覆盖全面：涵盖 Fitbit 主流健康指标，支持灵活的时间范围查询
4. Token 自动管理：依赖的外部 CLI 工具自动处理 OAuth Token 刷新（8 小时有效期）
5. 隐私合规良好：通过 GDPR 数据最小化、CCPA 透明度要求等合规检查

潜在缺点与局限性

1. 外部依赖风险：实际功能依赖外部 fitbit-cli 二进制工具，Skill 本身无法控制该工具的安全性和更新
2. 数据同步延迟：健康数据存在设备同步延迟，非实时数据
3. 首次配置复杂：需要用户执行 fitbit-cli --init-auth 完成 OAuth 授权初始化
4. 许可证缺失：当前未声明开源许可证，影响长期可信度
5. 用户同意机制待完善：隐私合规检查中用户同意机制项为警告状态

适合人群

• Fitbit 穿戴设备用户，需要快速查询历史健康数据
• 注重隐私安全、偏好本地 CLI 工具的技术用户
• 需要进行睡眠、心率、活动量长期追踪的健康管理者
• 对穿戴设备数据有分析需求但不愿使用官方 App 的用户

常规风险

1. 凭证管理风险：外部 CLI 工具持有用户 Fitbit 账户 OAuth Token，需确保该工具可信
2. 数据泄露风险：虽然 Skill 不存储数据，但 CLI 工具可能在本地缓存 Token 或健康数据
3. 第三方工具风险：fitbit-cli 非 Fitbit 官方工具，需从可信渠道安装并定期更新
4. 同步延迟导致误判：基于非实时数据做健康决策可能存在偏差