Garmin Connect Sync (国际→国内)

佳明国际账号数据同步到国内账号（基于 garminconnect 开源库）

Garmin 国际→国内账号同步技能 v2.0

基于 python-garminconnect 开源库， 从 Garmin Connect International 读取活动数据，下载 FIT 文件后上传到 Garmin Connect China。

功能

功能	命令	说明
🔄 同步	sync	执行一次完整同步（读取国际版→下载FIT→上传国内版）
📊 状态	status	查看同步状态和统计
📋 列表	list	查看最近活动记录
🔧 认证测试	auth-test	测试国际版和国内版账号认证

使用方式

javascript

// 完整同步（最近7天）
sync()

// 同步最近30天
sync({ days: 30 })

// 查看同步状态
status()

// 列出最近活动
list()

// 测试认证
auth-test()

同步原理

1. 🔐 登录国际版 Garmin Connect，获取活动列表
2. ⬇️ 下载每条活动的原始 FIT 文件
3. 📤 登录国内版 Garmin Connect，上传 FIT 文件
4. 💾 记录已同步的活动 ID，避免重复

环境变量配置

变量	必填	说明
GARMIN_INTL_USERNAME	✅	国际版 Garmin 账号（邮箱）
GARMIN_INTL_PASSWORD	✅	国际版 Garmin 密码
GARMIN_CN_USERNAME	✅	国内版 Garmin 账号（邮箱/手机）
GARMIN_CN_PASSWORD	✅	国内版 Garmin 密码
GARMIN_SYNC_DIR	❌	数据存储目录（默认 ~/.garmin-sync）

⚠️ 注意事项

1. API 限流: Garmin API 有请求频率限制，同步间隔会自动处理
2. 重复检测: 已同步的活动会自动跳过，不会重复上传
3. FIT 缓存: 下载的 FIT 文件保存在本地，可定期清理
4. 首次使用: 建议先用 auth-test 验证账号配置是否正确

版本历史

v2.0.0 (2026-04-29)

• 全面重写，基于 python-garminconnect 真实 API
• 支持完整的认证流程（含 OAuth token 持久化）
• 支持 FIT 文件下载 + 国内版上传
• 支持活动去重和状态记录

v1.0.0 (2026-04-16)

• 初始版本（模拟实现，未对接真实 API）