hevy

核心用法

Hevy CLI 是一款专为 Hevy Pro 订阅用户设计的命令行工具，通过调用官方 API 实现健身数据的全面管理。用户可通过简单的命令查询近期锻炼记录（hevy workouts）、浏览训练计划（hevy routines）、搜索特定动作（hevy exercises --search）以及追踪特定动作的进阶历史（hevy history）。工具支持 JSON 格式输出便于数据分析，同时提供创建训练计划和自定义动作的功能，满足从数据查询到计划管理的完整闭环。

显著优点

该工具的最大优势在于数据权威性和操作便捷性的结合。直接对接 Hevy 官方 API 确保数据实时准确，避免了第三方爬虫的数据延迟问题。命令设计遵循 Unix 哲学，支持管道操作和 JSON 输出，方便高级用户进行数据处理和可视化。特别值得一提的是其内置的重复检查机制：在创建自定义动作时会自动检测同名动作，防止数据冗余，只有在用户明确使用 --force 参数时才强制创建，有效保护数据完整性。

潜在缺点与局限性

首先，该 Skill 存在较高的使用门槛：必须订阅 Hevy Pro 才能获取 API 权限，且需要用户具备一定的命令行操作基础。其次，API 本身存在功能限制，目前不支持删除或编辑已创建的动作模板，用户仍需回到移动端应用进行此类操作。此外，来源可信度为 T3 级别（个人开发者），虽然代码质量达到 A 级标准，但长期维护和更新保障相对较弱。写操作（如创建计划）需要精确提供 JSON 数据，对非技术用户不够友好。

适合的目标群体

本 Skill 最适合以下三类用户：一是已经订阅 Hevy Pro 的健身爱好者，特别是希望深度分析自己训练数据的数据驱动型运动员；二是需要批量管理训练计划的健身教练或运动员，可通过 JSON 批量导入导出计划；三是希望将健身数据集成到个人自动化工作流中的技术用户，利用 CLI 的 JSON 输出能力配合其他数据分析工具。普通健身用户或没有 Pro 订阅的用户则不建议使用。

使用风险与注意事项

主要风险集中在 API Key 管理和写操作安全。用户需妥善保管 HEVY_API_KEY 环境变量，避免泄露导致账户数据被非法访问。虽然工具本身没有恶意代码，但创建和更新操作会直接修改云端数据，建议用户在执行 create-routine 或 create-exercise 前仔细核对 JSON 数据格式。此外，频繁使用 --all 标志获取全部历史数据可能触发 API 速率限制，建议在查询大量数据时适当使用 --limit 参数分批次获取。