高驰(COROS)运动健康深度分析 Skill
一键拉取 COROS 手表 15 维运动健康数据,生成中文深度分析报告 + 进阶运动分析(半马/全马预测、PB 追踪、周/月报)+ 可视化图表报告。依赖官方 @coros/coros skill 提供 OAuth 登录与数据通道。
快速开始
# 1. 一键引导(安装官方依赖 + 登录 + 自检,约 30 秒)
bash <本 skill 目录>/setup.sh
# 2. 日常查询(让 Agent 在 shell 环境运行)
python3 <本 skill 目录>/scripts/coros_analysis.py
# 3. 进阶用法(按需叠加参数)
python3 <本 skill 目录>/scripts/coros_analysis.py --race # 半马/全马预测
python3 <本 skill 目录>/scripts/coros_analysis.py --pb # PB 追踪
python3 <本 skill 目录>/scripts/coros_analysis.py --weekly # 周报
python3 <本 skill 目录>/scripts/coros_analysis.py --html # 可分享图表报告
移动端无 shell 环境,不能直接跑脚本:让桌面 / 云端 Agent 运行并生成
--html报告,再把reports/*.html分享到手机查看。
文档导航
完整说明见 SKILL.md,按章节:
- 触发条件 → 什么时候该用它
- 技术边界与限额 → 并发 / 数据量 / 频次 / 超时重试 + 数据缺失与特殊运动类型的处理边界
- 进阶功能速查 → 一眼看全可深挖什么
- 完整输出样例 → 报告长什么样(
examples/sample-report.md为未删改全量版) - 前置依赖与快速开始 → 安装与登录
- 执行流程 / 可选参数 → 怎么跑、加什么参数
- ⚠️ 不要这样做(常见反模式)→ 错误用法与正确做法
- 故障排查 → 常见现象处理
- ❓ 常见问题 FAQ → 高频问答(见下)
- 数据安全 → 只读访问、OAuth 授权
常见问答 FAQ(速查)
Q:报告里某维度「无数据」/「数据维度获取失败」,是 skill 坏了吗?
多为正常现象或瞬时问题。「无数据」常为当日无对应记录(休息日无运动、当晚睡眠未同步);「获取失败」多为网络波动或 token 临时失效,脚本已自动重试并明确标出失败维度,其余分析不受影响。重试一次或加 --fresh;持续失败再查登录态。
Q:图表 / 趋势对比为什么等几天才出现? 趋势库按天本地积累,需 ≥4 天数据才自动追加「📈 趋势对比」;PB(--pb)需近 90 天有运动记录、周期分析(--weekly/--monthly)需 ≥2 个周期。这些是数据积累型功能,并非故障。
Q:移动端(手机 App)能直接查数据吗?
不能直接跑脚本(依赖 shell 执行 Python),但可查看 Agent 生成后分享的 --html 报告(单文件自带图表,手机浏览器直接渲染)。
Q:登录失效了怎么办?
重新授权一次即可,无需重装:python3 <官方skill>/coros_mcp_login.py login,浏览器点一次授权即完成,token 自动刷新。
Q:数据多久更新?会不会重复拉取很慢?
本地缓存 TTL 5 分钟,5 分钟内重复问数秒回(约 0.1s);强制刷新用 --fresh;TTL 到期或参数变化自动重新拉取。
Q:半马 / 全马预测准吗? 基于 Riegel 公式(指数 1.06,全马上限 1.08)+ COROS 乳酸阈配速推算,属科学估算。停训 / 数据不足时偏乐观,恢复规律训练 4–6 周后更可信;预测附带保守~乐观区间与分段策略,供备赛参考而非绝对成绩。
Q:报告里的 ⚠️ 提醒要管吗? 要。这些是真实数据触发的异常信号,按优先级处理:🔴 高 > 🟡 中 > 🟢 低。忽略高优先级提醒可能延误恢复或增加受伤风险。
Q:我的数据安全吗? 只读访问 COROS 官方 MCP 网关,OAuth 授权;token 由官方 skill 加密缓存,本脚本不经手、不打印;不修改任何账号数据。
常见反模式(避坑)
| 反模式 | 正确做法 |
|---|---|
| token 失效后反复直接跑脚本 | 先 login 重新授权,或加 --fresh 重试 |
| 未登录 @coros/coros 就运行脚本 | 先 bash setup.sh 完成一键登录 |
| 用移动端 App 直接跑脚本 | 让桌面 / 云端 Agent 运行,再分享 HTML 报告 |
| 训练中断 >30 天还照搬旧配速计划 | 按报告「分阶段恢复计划」循序渐进 |
| 停训后直接套用 Riegel 全马预测 | 恢复规律训练 2–4 周后再预测 |
| 忽略报告里的 ⚠️ 提醒 | 优先处理高优先级(🔴)提醒 |
| 看到「数据维度获取失败」就以为 skill 坏了 | 多为网络波动 / token 临时失效,重试或 --fresh |
微信扫一扫