garmer

Garmer是一款专为Garmin智能穿戴设备用户打造的健康数据提取与分析工具，通过CLI命令行与Python API双模式，实现从Garmin Connect平台安全获取个人健康数据。

核心用法：用户首次使用需执行garmer login进行OAuth认证，token将加密存储于本地~/.garmer/目录。工具提供丰富的数据查询指令，包括garmer summary获取每日健康摘要（步数、卡路里、心率、压力）、garmer sleep分析睡眠质量与HRV数据、garmer activities导出运动记录，以及garmer export批量导出多日期数据为JSON格式。Python API层面支持更精细化的数据调用，如get_health_snapshot()获取全天健康快照、get_weekly_health_report()生成周度健康趋势报告，满足程序化分析需求。

显著优点：数据覆盖维度全面，涵盖活动、睡眠、心率、压力、步数、身体成分、饮水及呼吸频率等完整健康指标；架构设计注重隐私保护，所有敏感凭据与Token仅本地存储，无云端上传风险；采用Pydantic进行严格的类型安全验证，配合完善的错误处理机制，确保数据解析的可靠性；依赖栈精选garth（Garmin官方认证库）、httpx等成熟开源项目，版本锁定避免供应链攻击。

潜在缺点与局限性：要求Python 3.10+运行环境，对旧系统兼容性有限；作为T3来源的社区项目，虽经安全审计但长期维护稳定性不及官方产品；功能聚焦于数据提取而非分析，用户需自行编写脚本或使用第三方工具进行深度数据挖掘；依赖Garmin Connect API，若官方接口变更可能导致功能中断。

适合人群：Garmin手表/手环用户、量化健康爱好者、运动教练及科研人员。特别适合需要定期备份健康数据、进行跨平台数据分析，或希望将Garmin数据导入个人健康数据库的技术用户。对于仅需查看基础数据的普通用户，官方Garmin Connect App可能更为便捷。

使用风险：导出的JSON文件包含详细健康隐私信息，需妥善保管避免泄露；本地token文件若被恶意程序获取可能导致账户风险，建议设置适当的文件权限；garmer update功能使用git命令拉取更新，虽路径受控但建议在可信网络环境下使用；长期存储大量历史数据可能占用本地磁盘空间，需定期清理过期导出文件。