← 返回 Skills 市场
Garmin Connect Sync (国际→国内)
作者
BruceTangc
· GitHub ↗
· v2.0.0
· MIT-0
40
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install garmin-connect-sync
功能描述
佳明国际账号数据同步到国内账号（基于 garminconnect 开源库）
使用说明 (SKILL.md)
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()
同步原理
- 🔐 登录国际版 Garmin Connect，获取活动列表
- ⬇️ 下载每条活动的原始 FIT 文件
- 📤 登录国内版 Garmin Connect，上传 FIT 文件
- 💾 记录已同步的活动 ID，避免重复
环境变量配置
| 变量 | 必填 | 说明 |
|---|---|---|
GARMIN_INTL_USERNAME |
✅ | 国际版 Garmin 账号（邮箱） |
GARMIN_INTL_PASSWORD |
✅ | 国际版 Garmin 密码 |
GARMIN_CN_USERNAME |
✅ | 国内版 Garmin 账号（邮箱/手机） |
GARMIN_CN_PASSWORD |
✅ | 国内版 Garmin 密码 |
GARMIN_SYNC_DIR |
❌ | 数据存储目录（默认 ~/.garmin-sync） |
⚠️ 注意事项
- API 限流: Garmin API 有请求频率限制，同步间隔会自动处理
- 重复检测: 已同步的活动会自动跳过，不会重复上传
- FIT 缓存: 下载的 FIT 文件保存在本地，可定期清理
- 首次使用: 建议先用
auth-test验证账号配置是否正确
版本历史
v2.0.0 (2026-04-29)
- 全面重写，基于 python-garminconnect 真实 API
- 支持完整的认证流程（含 OAuth token 持久化）
- 支持 FIT 文件下载 + 国内版上传
- 支持活动去重和状态记录
v1.0.0 (2026-04-16)
- 初始版本（模拟实现，未对接真实 API）
安全使用建议
Install only if you are comfortable giving the agent access to Garmin credentials or tokens and personal fitness history. Before first use, confirm exactly which accounts are accessed, where FIT files or tokens are stored, how to delete cached data, and require explicit confirmation before any download, upload, or cross-account sync.
能力标签
能力评估
Purpose & Capability
The stated behavior of transferring Garmin activity data between accounts coherently explains credential use, OAuth tokens, downloads, uploads, and FIT file handling, but those are sensitive health/account data flows that need explicit disclosure.
Instruction Scope
The reported trigger wording is broad for common Garmin, syncing, and watch-related discussions, which raises unintended-activation risk for a credential-backed workflow unless the skill requires explicit user confirmation before login, download, upload, or writes.
Install Mechanism
No concerning install-time behavior, package hooks, background setup, or hidden installer actions were supplied or found in the available workspace review.
Credentials
Network account access and local FIT files are proportionate for Garmin account migration or synchronization, but users should understand that personal fitness history may be read, cached, and transmitted between services.
Persistence & Privilege
The scanner-reported local caching of FIT files and token/credential-backed operations create a persistence and privacy concern because the supplied materials do not show clear retention, deletion, or local storage guidance.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install garmin-connect-sync - 安装完成后，直接呼叫该 Skill 的名称或使用
/garmin-connect-sync触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.0.0
基于 python-garminconnect 的真实 Garmin API 同步，支持国际版→国内版 FIT 文件上传
元数据
常见问题
Garmin Connect Sync (国际→国内) 是什么？
佳明国际账号数据同步到国内账号（基于 garminconnect 开源库）. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 40 次。
如何安装 Garmin Connect Sync (国际→国内)？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install garmin-connect-sync」即可一键安装，无需额外配置。
Garmin Connect Sync (国际→国内) 是免费的吗？
是的，Garmin Connect Sync (国际→国内) 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Garmin Connect Sync (国际→国内) 支持哪些平台？
Garmin Connect Sync (国际→国内) 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Garmin Connect Sync (国际→国内)？
由 BruceTangc（@brucetangc）开发并维护，当前版本 v2.0.0。
推荐 Skills