garmin-connect

Garmin Connect

Credit：李二牛

使用 npm 官方仓库中的社区维护、非 Garmin 官方软件包 dsh-plugin-garmin-connect。该包不指定版本，始终跟随 npm 当前的 latest 正式版本。不要抓取 Garmin 网页，也不要擅自替换成其他 Garmin 库。

连接工具

首先检查当前 WorkBuddy 会话能否使用下方列出的 Garmin MCP 工具。

• 如果工具不可用，读取 references/workbuddy-setup.md。仅下载软件包 不会给正在运行的会话增加工具；必须在 WorkBuddy 中注册 stdio MCP 服务并 重新加载。
• 如果 Garmin 工具提示凭据缺失、过期或需要浏览器认证，在展示或打开任何 内容前，先阅读同一参考文档中的认证部分。
• 将配置视为两个阶段：先配置并重新加载 WorkBuddy，再请用户重新调用本技能 进行分析。不要承诺在原会话内同时完成配置和分析。
• 在以下操作发生前分别获得用户授权：① 下载并执行 npm 软件包；② 修改 WorkBuddy 配置；③ 打开会写入会话文件的浏览器认证。不要把这些副作用 混入用户对数据分析的授权中。
• 不要在对话中索取 Garmin 密码、MFA 验证码、OAuth 令牌、会话内容或 npm 令牌。回环页面由本社区插件提供；账号、密码和验证码只能输入其嵌入的 Garmin 表单。插件会以程序方式把 frame 服务地址限定为 https://sso.garmin.cn/sso/embed 或 https://sso.garmin.com/sso/embed，并校验对应的 Web origin。浏览器地址栏 仍会显示 127.0.0.1，因此不要声称用户可仅凭地址栏独立验证 iframe 来源。 如果 Garmin 表单缺失或被拦截，立即停止输入。

用户没有指定账号时，使用已配置的默认 Garmin 服务。如果多个账号可能明显 影响答案且无法确定默认账号，询问账号别名；不要合并不同账号的数据。

获取最少必要数据

查询和分析数据时使用以下只读工具：

• get_garmin_activities
• get_garmin_sleep
• get_garmin_steps
• get_garmin_heart_rate
• get_garmin_weight
• get_garmin_workouts
• get_garmin_profile
• get_running_skill_advice

根据用户的问题选择工具，不要一次获取所有数据。按照用户 Garmin 账号或本地 日历时区，把相对日期换算成明确的 YYYY-MM-DD。确认是否需要包含尚未结束的 当天；否则优先使用完整日历日，并说明起止日期均包含在内。超过 30 天的范围 应拆成互不重叠、每批最多 30 天的数据，并标注合并后的总范围。

查询活动时默认使用 detail="compact"，只有用户确实需要扩展字段时才提高 详细程度。full 可能暴露精确路线或位置；请求前说明其隐私影响。小表格或 摘要足以回答时，不要复述原始响应。

分析时避免过度推断

结果应明确区分：

1. 数据范围以及缺失的日期或字段；
2. 带日期和单位的直接观察；
3. 明确标为推断的谨慎解释；
4. 与用户目标匹配的可行下一步；
5. 局限性，以及哪些补充数据可能改变结论。

至少比较多次测量后再称其为趋势。不要把相关性解释为因果关系，不要诊断疾病， 也不要把 Garmin 估算值当成医学结论。出现警示症状或异常测量时，应建议降低 训练强度，并在适当情况下寻求专业医疗帮助。

本插件未提供 HRV 状态、Body Battery、压力、训练准备度、恢复时间或训练负荷 工具。睡眠和静息心率趋势只能作为有限的恢复参考，不能称为完整恢复评分。

解释训练方法时，调用 get_running_skill_advice 并设置 mode="explain"。 提供个性化建议或计划时，使用 mode="personalized"，收集工具返回的全部缺失 信息，并遵守其安全停止条件。Garmin 历史数据可以补充，但不能代替用户的目标、 当前成绩、训练背景、可用时间、健康与恢复情况以及训练负荷偏好。

写操作

用户明确要求创建 Garmin 训练或下载活动 FIT 时，可以使用下列工具。仅请求 分析、建议或生成计划时，不自动向 Garmin 训练库写入，也不自动下载文件。