前言¶
跑高驰手表的用户,设备、训练记录、恢复和每日健康数据都在 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。