前言¶
跑高馳手錶的用戶，設備、訓練記錄、恢復和每日健康數據都在 COROS 賬號裏。若要在 DeepSeek Harness（DSH）桌面端裏把這些信息交給智能體參考，常見做法是打開 App 或網頁複製粘貼，或自己對接 OAuth 與 MCP。維護者 lyy-hast 發佈的 dsh-coros-sport（倉庫 lyy-hast/dsh-coros-plugin）是面向 DSH 的 Cordis 插件：在應用內完成高馳登錄，用官方 MCP 讀賬號數據，並在二次確認後可將一份固定的四周跑步計劃寫入賬號。當前版本爲 1.0.4，許可證 MIT。
下面按安裝、日常使用、訓練計劃與配置說明可覈對的操作步驟。
這是什麼¶
dsh-coros-sport 在 DSH 桌面端左側面板增加「高馳運動」入口（位於「插件市場」之後、「自動化任務」之前）。點擊後可在面板內登錄高馳賬號，查看設備、運動記錄、恢復與體能、健康與訓練安排；登錄不彈系統瀏覽器、不跳外部應用、不需要手工粘貼令牌。
數據讀取走高馳官方 MCP；寫入能力僅一處——「訓練安排 → 詳細」裏，經預覽與兩步確認後調用 createTrainingPlan 創建內置的四周計劃（16 節課）。/coros-plan 指令只生成文本計劃，不會自動寫入賬號。
核心功能¶
安裝並登錄後，看板七個區塊並行加載；任一區塊失敗隻影響對應卡片，不會整頁白屏。
| 區塊 | 內容 | MCP 工具 |
|---|---|---|
| 賬號 | 暱稱、性別、身高、體重、生日 | queryUserInfo |
| 設備 | 設備名稱、藍牙 ID、型號、序列號、保修到期 | queryDevices |
| 恢復 | 恢復百分比、狀態等級、預計完全恢復時間 | queryRecoveryStatus |
| 體能 | VO₂max、跑力等級、閾值配速、5K/10K/半馬/全馬預測 | queryFitnessAssessmentOverview |
| 運動記錄 | 近 7 天活動類型、日期、地點、距離、時長、配速、平均心率、卡路里 | querySportRecords |
| 健康 | 步數、卡路里、鍛鍊時長、壓力、睡眠分期，靜息心率與 HRV 基線 | queryDailyHealthData |
| 訓練安排 | 本週訓練課；是否已有訓練計劃（四周詳情在「詳細」頁） | queryTrainingSchedule、queryTrainingPlanLibrary |
除看板外，插件提供 /coros-plan 斜槓指令：讀取賬號相關數據整理成簡報，連同你在指令後寫的目標一併交給當前會話模型，輸出逐周訓練表（文本）。
安裝與啓用¶
前提：DeepSeek Harness 桌面端已安裝並至少啓動過一次（profile 目錄已初始化）。
從 npm 安裝（一般用戶）
在 Harness 會話中執行：
plugin_manager action=install_bundle target=dsh-coros-sport
安裝結果裏 application 爲 applied 纔算生效；若出現 warnings，按提示處理後再重啓桌面端。重啓後左側應出現「高馳運動」。
本地目錄安裝（開發）
README 說明需將插件目錄的絕對路徑作爲 target，由安裝工具處理依賴與 profile 註冊，不要手工改 profile 的 package.json 或 cordis.patch.yml：
plugin_manager action=install_bundle target=D:\path\to\dsh-coros-sport
（路徑示例來自 README，Linux/macOS 上換成對應絕對路徑即可。）
插件以當前 DSH 進程權限運行；安裝前建議閱讀 倉庫源碼 與 MIT 許可證，確認符合你的環境與合規要求。
典型用法¶
登錄與看板¶
- 點擊左側「高馳運動」。
- 首次進入點「登錄高馳賬號」；表單在面板內展開，輸入郵箱/手機號與密碼並按提示授權。
- 授權成功後表單收起，數據加載；之後打開直接顯示數據，直到令牌過期。
- 令牌過期後按頁面提示重新登錄；右上角菜單可清除本機令牌（退出登錄）。
用 /coros-plan 生成文本計劃¶
在任意會話輸入指令並附上目標，例如：
/coros-plan 6 周後跑完 10 公里，每週能練 4 次
插件會讀取個人信息、恢復、體能、近期訓練、本週安排與已有計劃，整理後與你的目標一起交給模型。若提示「現在打不開新會話」，需先在左側工作區新建會話，再手動輸入 /coros-plan。
當賬號裏沒有任何訓練計劃時，看板「訓練安排」卡片會出現「創建訓練計劃」按鈕：點擊會打開新會話並在輸入框預填 /coros-plan，你補全目標後發送。若只是「本週暫無訓練課」但已有計劃，不會出現該按鈕，避免重疊計劃。
將四周計劃寫入高馳¶
生成結果僅爲文本。要寫入賬號：看板「訓練安排」右上角點「詳細」，查看內置四周計劃（共 16 節、約 149 km）及與計劃庫重疊的舊計劃提示，確認後點「創建訓練計劃」，再點「確認創建，寫入 16 節」纔會調用 createTrainingPlan。計劃從下一個週一起算；寫請求由宿主機按內置 lib/plan-workouts.js 重建 payload，不接受客戶端改過的課程內容。
區域與配置¶
高馳 MCP 分三個集羣，區域選錯可能登錄失敗或查不到數據：
| 區域 | 端點 |
|---|---|
| 中國大陸（默認） | https://mcpcn.coros.com |
| 歐洲 | https://mcpeu.coros.com |
| 北美 | https://mcpus.coros.com |
可在 profile 的 bundle patch 中覆蓋：
| 鍵 | 類型 | 默認 | 說明 |
|---|---|---|---|
region |
"cn" \| "eu" \| "us" |
"cn" |
服務區域 |
issuer |
string |
空 | 指定 issuer，覆蓋 region 推導 |
overviewDays |
number |
7 |
運動記錄與健康默認回溯天數 |
適用場景與注意¶
適合：已在 DSH 桌面端工作、希望在本機面板內查看高馳數據，或希望模型結合賬號上下文生成訓練建議（/coros-plan）的用戶。
讀寫邊界（README 明確說明）：
- 密碼不落盤；僅令牌存於 Harness
credentials（coros-sport:oauth），不可用時退回~/.dsh-coros-sport/token.json（權限0600）。請求直連高馳官方端點，無自建後端。 - 使用
/coros-plan時，賬號摘要會作爲用戶消息進入當前會話模型；不用該指令則不會因指令向模型發送賬號數據。 - MCP 無刪除訓練計劃工具；寫入不可撤銷，日期重疊時新舊計劃並存。
createTrainingPlan無開始時間字段，說明裏的 18:30 / 17:30 不會變成日曆或手錶提醒。 - 令牌 access 30 天、refresh 180 天且刷新會輪換 refresh token，插件側串行刷新。
故障排查要點：側欄無入口時確認 application=applied 並已重啓；登錄白屏檢查能否訪問 opencn.coros.com 與對應區域 MCP 域名；登錄後立即失效多爲 region 錯誤；單區塊「加載失敗」可重載頁面，全部失敗且未授權則重新登錄。
結尾¶
dsh-coros-sport 把高馳 OAuth + MCP 收進 DSH 插件：面板內登錄、七塊數據並行讀取、可選的四周計劃寫入與 /coros-plan 對話輔助。社區目錄頁：lyy-hast/dsh-coros-plugin；源碼與完整說明：GitHub — lyy-hast/dsh-coros-plugin。
