hevycli

🏋️ Hevy 健身数据智能分析助手

基于 Hevy API 的命令行健身数据管理工具,支持训练历史查询、数据导出与进度分析,助力科学健身追踪。

收藏
5.3k
安装
1.8k
版本
v0.0.1
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

Hevy CLI Skill 是一款面向 Hevy 健身平台用户的文档型数据管理助手,通过结构化的命令行操作指南,帮助用户高效访问和分析个人训练数据。作为纯文档型 Skill,它本身不包含任何可执行代码,而是以详尽的指令手册形式,指导用户使用外部 hevycli 工具完成健身数据的查询、导出与分析。

核心用法聚焦于健身数据的读取与导出场景。用户完成 hevycli 安装、API 密钥配置及 Hevy Pro 订阅验证后,即可通过标准化命令查看训练历史、获取特定锻炼详情、浏览训练计划模板及统计总训练量。Skill 特别强化了数据导出能力,支持通过 --format json 参数将结构化数据输出至本地文件,为后续的深度分析(如训练容量计算、力量增长曲线绘制、训练频率统计)奠定基础。文档还提供了短 ID 快速查询、分页导航等实用技巧,显著提升了大数据量场景下的操作效率。

显著优点体现在安全性与灵活性的完美结合。由于采用纯文档架构,该 Skill 彻底消除了代码执行风险,所有操作均需用户手动确认后执行,极大降低了自动化攻击面。JSON 输出支持与详细的错误处理指引,使其成为技术型健身爱好者连接 Hevy 平台与数据分析工具(如 Python、R 或 Excel)的理想桥梁。此外,只读操作特性确保了用户数据的完整性,不会因误操作而意外修改或删除训练记录。

潜在缺点主要集中于依赖关系与功能限制。该 Skill 强制依赖外部 hevycli 工具,用户需自行处理安装、版本更新及环境配置,技术门槛较高。Hevy Pro 订阅要求也限制了用户群体。功能层面,Skill 仅支持数据读取,无法实现训练记录的创建或同步,且 API 分页限制(每页 10 条)在处理多年历史数据时效率受限。来源可信度方面,T3 级个人开发者背景意味着缺乏企业级质量保障与长期维护承诺。

适合的目标群体包括:已订阅 Hevy Pro 且习惯命令行操作的重度健身用户、希望通过数据分析优化训练表现的量化健身爱好者、需要将健身数据集成至个人数据管道的开发者,以及追求数据自主控制的技术人员。对于仅依赖手机应用查看训练的普通用户,该 Skill 的学习成本可能过高。

使用风险方面,尽管 Skill 本身安全,但用户需警惕 API 密钥泄露风险,避免在共享终端或脚本中硬编码密钥。依赖外部开源工具意味着需关注 hevycli 仓库的安全更新,防范供应链攻击。数据隐私层面,用户应了解 Hevy 平台的 API 数据政策,并确保导出后的本地数据存储安全。性能上,大规模历史数据导出可能受限于 Hevy API 的速率限制,建议分批次获取以避免服务限流。

安全解读

核心用法

Hevy CLI Skill 是一个纯文档型工具指南,帮助用户通过 hevycli 命令行工具与 Hevy 健身应用的数据进行交互。核心功能分为四类:

1. 配置管理:设置 API 密钥 (hevycli config set-api-key) 和查看当前配置
2. 训练记录:列出历史训练 (workouts list)、查看单次训练详情 (workouts get <id>)、获取总训练次数 (workouts count)

3. 训练计划:浏览保存的训练计划 (routines list) 及详情 (routines get <id>)

4. 动作模板:查看 Hevy 内置的 exercises 数据库 (exercises list)

输出支持 table(默认)和 json 两种格式,推荐使用 JSON 进行数据分析和导出。支持短 ID(8 位)简化操作,API 分页上限为 10 条。

显著优点

  • 纯文档零风险:无可执行代码,仅为使用说明文档,100% 透明可审计
  • 数据来源专业:基于 Hevy Pro 的官方 API,数据准确性有保障
  • 灵活分析能力:JSON 导出支持自定义分析(训练容量计算、进度追踪、频率统计)
  • 效率优化:支持短 ID 快速查询,避免复制冗长 UUID
  • 隐私友好:本地 CLI 操作,数据不经过第三方中转

潜在缺点与局限性

  • 订阅门槛:必须拥有 Hevy Pro 订阅才能使用 API
  • 只读限制:无法创建或修改训练记录,仅支持数据查看和导出
  • 技术门槛:需要用户自行安装 Go 编译的 CLI 工具并配置 API 密钥
  • 分页限制:单次最多返回 10 条记录,大量历史数据需多次分页
  • 单位固定:重量强制为公斤、距离为米,需自行转换习惯单位
  • 依赖外部工具:Skill 本身仅为文档,功能完全依赖 hevycli 程序的可用性

适合人群

  • 已订阅 Hevy Pro 的健身爱好者,希望脱离手机 App 进行数据分析
  • 需要将训练数据导入 Excel/Python/R 进行深度统计的进阶用户
  • 偏好命令行工作流的开发者和技术用户
  • 希望备份个人训练数据的用户

常规风险

  • API 密钥安全:用户需自行保管 API 密钥,泄露可能导致他人访问其 Hevy 数据
  • 订阅失效风险:Hevy Pro 过期后 API 访问将中断
  • 第三方工具依赖hevycli 为社区开发工具,非 Hevy 官方维护,更新和维护存在不确定性
  • 数据解读责任:Skill 提示可计算训练容量等指标,但实际运动科学分析需专业判断

hevycli 内容

手动下载zip · 1.9 kB
Skill.mdtext/markdown
请选择文件