WHOOP 健康看板 ShawnRen57/dsh-whoop-easy-connect

WHOOP Easy Connect

dsh-whoop-easy-connect · 在 DeepSeek Harness（dsh）里轻松连接你的 WHOOP 账号，数据自动同步，还自带一个专属健康看板。

简体中文 · English

WHOOP Easy Connect 健康看板

三个关键词

- 简单连接：不用自己拼 OAuth，不用手写配置。设置页有四步引导：打开 WHOOP 开发者平台 → 创建应用 → 粘贴 Client ID / Secret → 点一下授权。回调地址一键复制，插件自动处理本机 HTTPS 回调。
- 自动同步：连接一次，之后每次打开看板都会自动拉取最新数据；WHOOP 的访问令牌到期前会自动续期（offline scope），不用反复登录。
- 专属看板：在 DSH 主面板里用三环、趋势图、睡眠结构和训练记录，把 WHOOP 的恢复、负荷、睡眠与运动数据集中在一个页面里看。

看板里有什么

| 区域 | 内容 |
| 三环主视觉 | 恢复分数（0–100，绿/黄/红语义）、每日负荷（0–21）、睡眠表现（0–100） |
| 今日指标 | HRV、静息心率、呼吸频率、血氧、皮肤温度、步数、能量消耗、睡眠时长 / 效率 / 一致性 |
| 趋势 | 恢复 + HRV、静息心率、每日负荷、睡眠表现与一致性，支持 7 / 14 / 30 天切换 |
| 睡眠详情 | 浅睡 / 深睡 / REM / 清醒结构、实际睡眠 vs 所需睡眠、入睡/起床时间、干扰次数 |
| 训练记录 | 运动类型、时长、负荷、平均/最高心率、能量、距离、心率区间分布 |
| 身体与资料 | WHOOP 账号姓名 / 邮箱、身高、体重、最大心率 |

看板右上角可以 切换中英文、手动刷新；页面每次进入都会自动刷新一次。界面适配 DSH 的明暗主题。

安装

方式一：直接安装 GitHub 仓库（推荐）

在终端运行（把 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

安装后在 DSH 左侧栏出现 WHOOP健康 入口；如果页面没有立即刷新，刷新一次页面。

方式二：插件市场

在 DSH 的 插件 → 发现 中添加社区插件索引，搜索 “WHOOP Easy Connect” 后安装。开放插件市场索引地址：https://dshopen.org/index.json。

连接 WHOOP（四步）

连接向导

1. 登录 WHOOP 开发者平台：点按钮打开 developer-dashboard.whoop.com，用你的 WHOOP 账号登录。
2. 创建 WHOOP 应用：按喜好填写 App 名称、Logo、邮箱和隐私声明（可选）；把页面里的回调地址一键复制，填到 Redirect #1；勾选数据权限后点 CREATE APP。
3. 填写 Client ID / Client Secret：双击输入框进入编辑，粘贴应用详情里的 Client ID 和 Client Secret，点保存。凭据只保存在本机。
4. 授权绑定：点「绑定 WHOOP 账号」，在浏览器里登录并同意授权。第一次访问本机回调地址时，浏览器会提示自签名证书，选择「高级 → 继续前往 localhost」即可。

授权完成、浏览器显示「WHOOP 账号已连接」后回到 DSH，看板就会显示你的真实数据。
为什么需要自己创建 WHOOP 应用？WHOOP 要求每个应用使用自己的 OAuth 凭据。你只需要在它的开发者后台创建一次应用；回调、令牌交换和续期都由插件自动完成。

数据同步与隐私

- 同步方式：打开看板时自动拉取最近 30 天数据；右上角可随时手动刷新。令牌过期前自动用 refresh token 续期。
- 本地保存：OAuth 凭据与令牌保存在 ~/.dsh-whoop-easy-connect/state.json（文件权限 0600），自签名证书保存在同目录的 tls/ 下。
- 数据去向：插件只直接请求 WHOOP 官方 API（api.prod.whoop.com），不向其他第三方发送你的健康数据，也没有遥测。
- 解除绑定：设置页可以随时「解除绑定」，插件会调用 WHOOP 的吊销接口并删除本地令牌。

常见问题

- 浏览器提示证书不受信任：这是插件为「本机 HTTPS 回调」生成的自签名证书，只影响 https://localhost:8443，选「高级 → 继续前往 localhost」即可。
- 授权后仍显示未绑定：确认第 2 步复制到 WHOOP 应用的 Redirect #1 与页面显示的地址完全一致；再确认第 3 步的 Client ID / Secret 已保存成功。
- 部分指标显示「—」：WHOOP 没有提供该数据（例如设备不支持血氧/皮肤温度，或当天尚未评分），不是插件故障。
- 8443 端口被占用：插件会记录警告并回退。释放端口后刷新页面，或在插件配置里更换端口并重新登记回调地址。
- 修改代码后如何生效：浏览器端改动会热更新或刷新页面生效；Host 端代码修改后如果未生效，重启一次 DSH。

开发

node scripts/build-client.mjs # 生成浏览器端 lib/client.js
node --test scripts/test-host.mjs # Host 端单元测试（不联网）

插件由两半组成：Host 端负责 OAuth、令牌存储和 WHOOP API 聚合；浏览器端负责侧边栏入口、设置引导和健康看板。看板使用纯 SVG 绘制图表，不依赖第三方图表库。

许可证与声明

MIT © 2026 ShawnRen57

WHOOP、WHOOP 标志及相关名称是 WHOOP, Inc. 的商标。本项目是个人开发的第三方插件，与 WHOOP 官方无关，也未获得 WHOOP 官方背书。

dsh-whoop-easy-connect — 几分钟内把 WHOOP 账号接入 DeepSeek Harness（dsh），让数据保持同步，并在专属健康看板里查看。

为什么你会喜欢它

- 连接简单 — 不用折腾 OAuth，也不用手写配置。设置里的四步向导会带你创建 WHOOP 应用、粘贴 Client ID / Secret 并完成授权。回调 URL 一键复制，本机 HTTPS 回调由插件处理。
- 自动同步 — 连接一次，之后每次打开看板都会自动拉取最新数据。Access token 会在过期前自动续期（offline scope），你不用重新登录。
- 专属看板 — 恢复、负荷、睡眠和训练数据集中在一处：环形图、趋势、睡眠阶段和训练记录，都在 DSH 主面板里。

看板上有什么

| 区块 | 内容 |
| 主环形图 | 恢复评分（0–100，绿/黄/红）、每日负荷（0–21）、睡眠表现（0–100） |
| 今日 | HRV、静息心率、呼吸频率、SpO₂、皮肤温度、步数、能量、睡眠时长 / 效率 / 规律性 |
| 趋势 | 恢复 + HRV、静息心率、每日负荷、睡眠表现与规律性 — 7 / 14 / 30 天 |
| 睡眠 | 浅睡 / 深睡 / REM / 清醒阶段、实际睡眠与所需睡眠、入睡与起床时间、干扰次数 |
| 训练 | 运动类型、时长、负荷、平均/最大心率、能量、距离、心率区间 |
| 身体与资料 | WHOOP 姓名 / 邮箱、身高、体重、最大心率 |

右上角可以在中文和英文之间切换，也能手动刷新。每次打开页面都会刷新一次，并跟随 DSH 的浅色与深色主题。

安装

从 GitHub 安装（推荐）

bash
dsh plugin --profile desktop add github:ShawnRen57/dsh-whoop-easy-connect

也可以在 DSH 里直接让智能体安装： text plugin_manager install_bundle target=github:ShawnRen57/dsh-whoop-easy-connect

安装完成后，DSH 侧边栏会出现 WHOOP健康 入口。如果没有立刻显示，刷新一次页面即可。

从插件市场安装

在 DSH 的 Plugins → Discover 里添加社区插件索引，然后搜索 “WHOOP Easy Connect”。Open Plugin Market 的索引地址是 https://dshopen.org/index.json。

四步连接 WHOOP

1. 登录 WHOOP 开发者面板 —— 打开 developer-dashboard.whoop.com 并登录。
2. 创建 WHOOP 应用 —— 名称、logo、邮箱和隐私声明按你的喜好填写；把插件显示的 callback URL 复制到 Redirect #1；勾选数据权限，点击 CREATE APP。
3. 填写 Client ID / Client Secret —— 双击输入框，粘贴应用详情里的两个值，然后保存。凭据只留在你的机器上。
4. 授权 —— 点击「绑定 WHOOP 账号」，在 WHOOP 页面登录并同意授权。首次本地回调时浏览器会提示自签名证书，选择「Advanced → Proceed to localhost」。

浏览器显示「WHOOP account connected」后，回到 DSH，面板就会显示你的真实数据。

为什么要自己创建 WHOOP 应用？WHOOP 要求每个应用使用自己的 OAuth 凭据。你只需在开发者面板创建一次；回调、token 交换和刷新都由插件处理。

同步与隐私

- 同步 —— 打开面板会自动拉取最近 30 天的数据，也可以手动刷新。Access token 过期前会用 refresh token 刷新。
- 本地状态 —— OAuth 凭据和 token 存放在 ~/.dsh-whoop-easy-connect/state.json（权限 0600）；自签名证书放在同目录的 tls/ 下。
- 数据去向 —— 插件只与官方 WHOOP API（api.prod.whoop.com）通信。不会把你的健康数据发往别处，也不含任何遥测。
- 解绑 —— 随时可以在设置里解绑；插件会撤销 WHOOP 授权并删除本地 token。

常见问题

- 浏览器提示证书警告 —— 这是为本地 HTTPS 回调生成的自签名证书，只影响 https://localhost:8443；选择「Advanced → Proceed to localhost」即可。
- 授权后仍显示未绑定 —— 确认 WHOOP 应用里登记的 Redirect #1 与插件显示的 callback URL 完全一致，并确认 Client ID / Secret 已保存成功。
- 部分指标显示「—」 —— WHOOP 没有提供该值（例如设备不支持 SpO₂ / 皮肤温度，或当天数据尚未评分）。
- 端口 8443 被占用 — 插件会记录一条警告并回退。释放端口后刷新，或者在插件配置里改端口，再注册新的回调 URL。
- 代码改动不生效 — 浏览器侧的改动会热重载，或者刷新后生效；Host 侧的改动如果没生效，重启 DSH。

开发 bash
node scripts/build-client.mjs # build the browser bundle lib/client.js
node --test scripts/test-host.mjs # Host-side unit tests (offline)

插件分两部分：Host 侧负责 OAuth、token 存储和 WHOOP API 聚合；浏览器侧负责侧边栏入口、设置向导和仪表盘。图表用 SVG 手绘，没有引入图表库。

许可与声明

MIT © 2026 ShawnRen57

WHOOP、WHOOP 标志及相关名称是 WHOOP, Inc. 的商标。这是独立的第三方插件，与 WHOOP 无隶属关系，也未获其背书。

使用 DeepSeek Harness 构建