前言¶
DeepSeek Harness（DSH）把能力拆成插件，主面板可以掛自定義入口。若你日常用 WHOOP 追蹤恢復、負荷、睡眠和訓練，常見做法是單獨打開 WHOOP 應用或網頁，或在別的項目裏自己接 OAuth、調 WHOOP API v2。後者要處理回調、令牌續期和前端展示，工作量不小。下面介紹的 dsh-whoop-easy-connect（維護者 ShawnRen57）面向已在 DSH 裏工作的開發者：在設置頁用四步向導完成 OAuth，連接後自動同步，並在 DSH 左側欄提供 WHOOP健康 專屬看板。
這是什麼¶
dsh-whoop-easy-connect 是 DSH 社區插件，分類爲聯網工具。它依賴 DeepSeek Harness（README 標註 ≥ 0.2.1）、Node.js 24+，對接 WHOOP API v2。一句話定位：輕鬆連接 WHOOP 賬號、自動拉取數據，在 DSH 主面板集中查看恢復、負荷、睡眠與運動記錄。許可證爲 MIT（package.json 版本 1.0.0）。WHOOP 相關商標歸 WHOOP, Inc.；該項目爲個人開發的第三方插件，與 WHOOP 官方無關。
核心功能¶
簡單連接¶
不需要手寫 OAuth 配置。設置頁提供四步引導：打開 WHOOP 開發者平臺 → 創建應用 → 粘貼 Client ID / Client Secret → 授權綁定。回調地址可一鍵複製；插件在本機處理 HTTPS 回調（默認涉及 https://localhost:8443 與自簽名證書）。
自動同步¶
連接一次後，每次進入看板會自動拉取最近 30 天數據；訪問令牌在過期前通過 offline scope 自動續期，無需反覆登錄。看板右上角支持手動刷新；每次進入頁面也會自動刷新一次。
專屬健康看板¶
看板在 DSH 主面板內展示 WHOOP 數據，適配 DSH 明暗主題，右上角可切換中英文。README 中列出的區域包括：
| 區域 | 內容 |
|---|---|
| 三環主視覺 | 恢復分數（0–100）、每日負荷（0–21）、睡眠表現（0–100） |
| 今日指標 | HRV、靜息心率、呼吸頻率、血氧、皮膚溫度、步數、能量、睡眠時長 / 效率 / 一致性 |
| 趨勢 | 恢復 + HRV、靜息心率、每日負荷、睡眠表現與一致性，支持 7 / 14 / 30 天 |
| 睡眠詳情 | 淺睡 / 深睡 / REM / 清醒、實際 vs 所需睡眠、入睡 / 起牀、干擾次數 |
| 訓練記錄 | 運動類型、時長、負荷、心率、能量、距離、心率區間等 |
| 身體與資料 | 賬號姓名 / 郵箱、身高、體重、最大心率 |
圖表由純 SVG 繪製，不依賴第三方圖表庫。Host 端負責 OAuth、令牌與 WHOOP API 聚合；瀏覽器端負責側邊欄、設置嚮導與看板。
數據與隱私（README 說明）¶
- OAuth 憑據與令牌保存在
~/.dsh-whoop-easy-connect/state.json（權限0600），自簽名證書在同目錄tls/下。 - 插件僅請求 WHOOP 官方 API（
api.prod.whoop.com），README 寫明不向其他第三方發送健康數據、無遙測。 - 設置頁可「解除綁定」，會調用 WHOOP 吊銷接口並刪除本地令牌。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證。
方式一：從 GitHub 安裝（README 推薦）
在終端執行（將 desktop 換成你的 DSH profile 名稱）：
dsh plugin --profile desktop add github:ShawnRen57/dsh-whoop-easy-connect
也可在 DSH 內讓 Agent 執行：
plugin_manager install_bundle target=github:ShawnRen57/dsh-whoop-easy-connect
安裝後左側欄應出現 WHOOP健康；若未出現，刷新頁面一次。
方式二：插件市場
在 DSH 插件 → 發現 中添加社區插件索引，搜索 “WHOOP Easy Connect” 後安裝。開放插件市場索引：https://dshopen.org/index.json。社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
典型用法：四步連接 WHOOP¶
WHOOP 要求每個應用使用自己的 OAuth 憑據，因此需在 developer-dashboard.whoop.com 創建一次應用；回調、令牌交換與續期由插件完成。
- 登錄 WHOOP 開發者平臺：在插件設置頁打開開發者後臺並用 WHOOP 賬號登錄。
- 創建 WHOOP 應用：填寫 App 信息；將插件頁面顯示的回調地址複製到應用的
Redirect #1；勾選數據權限後CREATE APP。 - 填寫 Client ID / Client Secret：在設置頁雙擊輸入框編輯，粘貼並保存；憑據只保存在本機。
- 授權綁定：點擊「綁定 WHOOP 賬號」，在瀏覽器完成授權。首次訪問本機回調時，瀏覽器可能提示自簽名證書，選擇「高級 → 繼續前往 localhost」即可。
瀏覽器顯示「WHOOP 賬號已連接」後回到 DSH，看板即可顯示真實數據。
適用場景與注意¶
適合誰：已在 DSH（≥ 0.2.1）環境中工作、使用 WHOOP 設備，希望在同一主面板查看恢復 / 負荷 / 睡眠 / 訓練趨勢，且願意在 WHOOP 開發者後臺創建個人 OAuth 應用的開發者。
常見問題（摘自 README）：
- 部分指標顯示「—」：多爲 WHOOP 未提供該數據（設備或當日未評分），不一定是插件故障。
- 授權後仍顯示未綁定：覈對
Redirect #1與插件顯示的回調地址完全一致，並確認 Client ID / Secret 已保存。 - 8443 端口被佔用：插件會記錄警告並回退；釋放端口或於插件配置更換端口後重新登記回調地址。
- 修改 Host 端代碼後若未生效，可重啓 DSH。
參考鏈接¶
- 社區目錄頁：skillhub.cn/plugins/ShawnRen57/dsh-whoop-easy-connect
- 源碼與完整說明：github.com/ShawnRen57/dsh-whoop-easy-connect
經過上面的步驟，你可以在 DSH 內完成 WHOOP 連接與日常數據查看，而無需單獨維護一套 OAuth 與看板前端。
