360 Secure SkillHub
360 安全技能中心

Garmin Connect Sync (国际→国内)

基于 garminconnect 库,登录佳明国际版账号读取活动列表,下载 FIT 文件后上传到国内版账号;提供 sync/status/list/auth-test 命令,支持按天数同步、活动去重和 token 持久化,账号凭证通过环境变量配置。

brucetangc
brucetangc
热度 16.02
最近更新 2026-05-29 10:28:36
分类:生活依赖:第三方 API / 代码执行 / 读写文件应用场景:健康 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add garmin-connect-sync
Metadata
name
garmin-sync
description
佳明国际账号数据同步到国内账号(基于 garminconnect 开源库)
author
assistant
version
2.0.0
homepage
https://github.com/cyberjunky/python-garminconnect
triggers
["佳明","Garmin","同步","运动数据","手表"]
metadata
{"clawdbot":{"emoji":"⌚","requires":{"bins":["python3"],"pip":["garminconnect"]},"config":{"env":{"GARMIN_INTL_USERNAME":{"description":"佳明国际版账号","required":true},"GARMIN_INTL_PASSWORD":{"description":"佳明国际版密码","required":true},"GARMIN_CN_USERNAME":{"description":"佳明国内版账号","required":true},"GARMIN_CN_PASSWORD":{"description":"佳明国内版密码","required":true},"SYNC_INTERVAL_HOURS":{"description":"同步间隔(小时)","default":"24"}}}}}

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

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

功能

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

使用方式

// 完整同步(最近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)