dsh-garmin-coach: Garmin Connect 運動 AI 教練插件

前言¶

DeepSeek Harness (DSH) 採用「一切皆插件」的架構。dsh-garmin-coach 是由開發者 csustyang 維護的一款插件，旨在將用戶的 Garmin Connect 運動數據接入 DSH，通過本地 AI 分析生成訓練建議和計劃。

該插件通過逆向分析 Garmin Connect 的內部接口進行數據同步，數據完全本地化存儲。使用前需注意：佳明賬號存在因異常登錄被限流或封禁的風險，且 DSH 在沙箱模式下需要特殊權限才能寫入本地數據。

核心功能¶

數據同步與認證¶

插件支持 CN 賬號與國際賬號登錄，通過 DI OAuth2 實現認證。Access Token 有效期約 1 小時，支持自動刷新。同步採用增量策略，避免重複拉取全量數據，並支持手動觸發同步以防止被 Garmin 行爲指紋檢測。

運動看板與分析¶

同步後，插件會在 DSH 側欄提供運動看板，展示 30+ 維度的分析指標，包括距離、配速、心率、HR-Pace、步頻、TRIMP 指數、時段分佈及一致性等。

AI 訓練能力¶

基於同步的數據，AI 可以生成訓練建議（如 PB 變化趨勢、跑量建議）以及結構化的訓練計劃。用戶可以在對話中直接下達指令生成計劃並保存，或在訓練後記錄日記。

本地持久化¶

所有數據（同步數據、訓練計劃、訓練日記）均存儲在本地 ~/data/ 目錄下，不上傳服務器。密碼和郵箱僅在登錄時通過 HTTP Body 傳遞，不會持久化保存。

安裝與啓用¶

DSH 啓動時只顯式加載 dsh.profile.bundles 列表中的包，因此安裝後需手動添加。

1. 安裝插件¶

打開終端，進入 DSH 的 web profiles 目錄並安裝：

cd ~/.dsh/profiles/web
pnpm add dsh-garmin-coach

2. 配置 bundles¶

編輯 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 數組末尾添加 "dsh-garmin-coach"。

"dsh": {
  "profile": {
    "bundles": [
      ...其他包,
      "dsh-garmin-coach"
    ]
  }
}

或者使用命令行直接追加：

cd ~/.dsh/profiles/web
node -e "
const fs = require('fs');
const p = JSON.parse(fs.readFileSync('package.json', 'utf8'));
if (!p.dsh.profile.bundles.includes('dsh-garmin-coach')) {
  p.dsh.profile.bundles.push('dsh-garmin-coach');
  fs.writeFileSync('package.json', JSON.stringify(p, null, 2) + '\n');
}
"

3. 重啓 DSH¶

ddsh restart

首次配置¶

打開 DSH 設置，找到 Garmin Coach 卡片。
選擇賬號區域（CN 或國際）。
輸入郵箱與密碼。
如需短信 MFA，輸入驗證碼。
點擊保存配置，等待 token 自動刷新保存。
點擊「立即同步」拉取歷史數據。

典型用法¶

在 DSH 對話中，可以直接使用自然語言調用工具：

查看報告：garmin_report(month) （查看某月報告）
查詢成績：garmin_best_pace(10000) （查詢 10km 最佳配速）
生成計劃：garmin_training_plan + garmin_save_training_plan （生成並保存訓練計劃）
記錄日記：garmin_log_diary （記錄今日訓練感受與評分）

重要注意事項¶

沙箱文件訪問權限¶

插件需要將訓練計劃、日記等寫入 ~/data/ 目錄。如果 DSH 運行在沙箱模式下，默認沒有寫入權限，會導致數據保存失敗。
* macOS：首次寫入時需在系統彈窗中允許「完整文件訪問」權限。
* Windows：需在 DSH 設置的沙箱/安全選項中開啓「完整文件訪問」並重啓。
* Linux：通常默認有權限，如有問題請檢查目錄權限。

賬號安全與合規¶

插件通過逆向接口調用，非佳明官方客戶端。頻繁使用或批量操作可能導致賬號被限流或封禁。插件僅支持學習與個人研究使用，請勿用於違反佳明服務條款的場景。

數據存儲¶

所有數據存儲在本地 ~/data/ 目錄（Windows 爲 DSH 啓動目錄下的 data 文件夾），包括 garmin.json、training-plan.json 和 training-diary.json。

總結¶

dsh-garmin-coach 爲 DSH 用戶提供了將個人運動數據轉化爲 AI 上下文的方案。它不需要依賴雲端同步服務，完全在本地處理數據，適合希望用 AI 輔助制定訓練計劃的開發者。

項目地址：https://github.com/csustyang/dsh-garmin-coach
目錄頁：https://www.skillhub.cn/plugins/csustyang/dsh-garmin-coach