首次配置

打开 DSH 设置 → Garmin Coach
选择账号区域（CN 或国际）
输入邮箱 + 密码
登录后如需要 MFA，输入短信验证码
点击保存配置
等待几秒，token 会自动保存（加密）
点击立即同步 → 按设置中的"回看天数"拉取（默认 14 天，可在 Garmin Coach 设置页修改）

⚠️ 首次同步后，数据存到 ~/data/garmin.json（macOS/Linux 用户 Home 目录）。Windows 用户在 DSH 启动目录下的 data\garmin.json。

🚀 使用

运动看板

点击侧栏 Garmin Coach → 打开运动看板。

默认显示：

运动总览（总距离/次数/时长/配速/最长）
健康数据（步数/心率/压力/Body Battery）
AI 训练建议（💡⚠️🔴）
训练计划（折叠）+打卡
各项分析 section

AI 对话

直接用自然语言提问，AI 自动调用工具：

自然语言	AI 调用
"六月份报告"	`garmin_report(month)`
"我十公里最好成绩"	`garmin_best_pace(10000)`
"本周跑量"	`garmin_distance_stats(week)`
"帮我制定半马破2计划"	`garmin_training_plan` + `garmin_save_training_plan`
"记录今天的训练：跑了 6km，4星"	`garmin_log_diary`
"我的训练进度"	`garmin_plan_progress`

训练计划工作流

对话："帮我制定 10km 进 5:30 的计划"
  → AI 调 garmin_training_plan（基于您的基线数据）
  → AI 生成 4 周计划 + 16 个训练任务
  → AI 调 garmin_save_training_plan 保存

打开看板 → 看到训练计划（默认折叠）→ 点 ▶ 展开 → 勾选完成的任务

误操作：AI 误覆盖 → 对话："找回之前的计划" → AI 调 garmin_plan_history + garmin_restore_plan

⚙️ 配置

账号区域

CN：sso.garmin.cn（中国账号）
国际：sso.garmin.com（其他地区）

数据存储位置

所有数据存到 DSH 用户的 data/ 目录（macOS/Linux 是 Home 目录，Windows 是 DSH 启动目录）：

~/data/                                              # macOS/Linux
%USERPROFILE%\data\  或  \data\            # Windows
├── garmin.json            # 活动 + 每日健康（同步数据）
├── training-plan.json     # 当前训练计划 + 打卡状态
├── training-diary.json    # 训练日记
└── training-plan-history/ # 计划历史（自动备份）

同步策略

手动同步（推荐）：点击卡片"立即同步"按钮或对话"同步数据"
增量：每次只拉上次同步后的新数据（从 lastSyncAt 前一天到今天），但若距上次同步已超过"回看天数"配置，则至少回看该配置值（默认 14 天）
防行为指纹：无定时同步（避免被 Garmin 检测为自动化）

dsh-garmin-coach

安装

说明文档

首次配置

🚀 使用

运动看板

AI 对话

训练计划工作流

⚙️ 配置

账号区域

数据存储位置

同步策略