让 Agent 读懂你的身体：数据获取篇
内容提要
作者计划用 AI Agent 管理健身数据，第一步是持续获取已记录的健康数据。他将数据分为事实、算法解释、自述三层，来源分为聚合平台、厂商 App、手工记录三类，并介绍七种获取路径：直接用 AI 产品读取、现成连接器、从 Apple Health 或 Health Connect 导出、调用官方 API 或 SDK，同时对比 Oura、Whoop、三星及国内厂商的开放程度与门槛。
延伸解读
数据分层：理解健康数据的客观性差异
作者将运动健康数据分为事实、算法解释和自述三层。事实层是步数、心率等直接记录，相对客观；算法解释层如 readiness、strain 是厂商算法加工的结果，可能因算法更新而变化；自述层如饮食、训练感受依赖手动输入，主观性强。这一分层提醒我们，在让 AI 分析时，需注意数据来源的可靠性，避免将算法解释误当作事实。
聚合平台导出：平衡便利与数据控制权
从 Apple Health 或 Health Connect 等聚合平台导出数据，能统一获取多设备信息，但平台字段可能不全，且部分厂商特色指标不会同步。作者介绍了快捷指令、第三方工具和自建 App 三种方式，其中快捷指令灵活但需配置，第三方工具省事但可能收费，自建 App 自由度最高但门槛也最高。选择时需权衡自身技术能力和对数据控制的需求。
厂商 API 开放度：个人开发者的机会与限制
Oura 和 Whoop 对个人开发者较开放，但需订阅且接口有变化（如 Oura 弃用 PAT，Whoop 改用生理周期）。三星可通过 Health Connect 或 Data SDK 获取部分数据。国内厂商如华为、小米、OPPO、vivo 的开放平台主要面向企业或机构，个人接口有限，仅华为允许个人申请。若依赖厂商 API，需关注其政策变动和门槛。
数据获取的长期考量：可持续性与数据主权
无论选择哪种方式，都需考虑长期可持续性。直接使用 AI 产品省心但受地区限制且数据不在自己手中；连接器服务方便但数据存于第三方，停止订阅后可能无法完整导出；自建方案可控但需维护。作者建议，若希望长期积累和自由查询，应将数据保存到自己能控制的位置，并注意增量同步、去重和错误处理。
Q&A
健康数据可以分为哪几层？各层有什么特点？
文章将运动健康数据分为三层：第一层是事实，如步数、心率、睡眠时段和运动轨迹等基础记录；第二层是解释，如 readiness、strain、resilience 等经过算法计算的指标；第三层是自述，包括饮食、训练感受和其他手工记录。这三层依次远离传感器，也依次远离客观。
健康数据通常来自哪些类型的来源？
健康数据大致分散在三类来源：聚合平台（如 Apple Health、Health Connect、Google Health），负责汇集设备和第三方 App 写入的通用数据；厂商或专业 App（如 Oura、Whoop、Samsung Health、Garmin、训记、Hevy 等），通常还保留平台里没有的特色指标；报告或手工记录（如饮食、体成分、体检报告等），未必有稳定的数字化入口。
如何直接在 AI 产品中使用健康数据？
ChatGPT 与 Claude 都支持在 iOS App 内接入 Apple Health，符合开放条件的用户可以授权读取健康数据并直接提问。但这类功能受地区、账号和开放进度影响，一般只在美国先上线。国内的蚂蚁阿福 App 也可以接入 Apple Health 并做问答，但功能较基础，适合简单查询。这种方式省心，但更适合临时查询和轻量分析。
有哪些现成的连接器或中转服务可以获取健康数据？
文章提到几种：Strava 上线了官方 MCP 连接器，面向订阅用户；训记向买断用户提供 API Skill，支持回写；Hevy 可以在 Settings > Developer 中生成 API Key，需要 Hevy Pro 订阅；Freddy 像健康数据中转服务器，可同步多个平台数据并通过 MCP 或 API 提供访问，第一个数据源免费，多数据源需订阅。选择时需确认能读取哪些字段、数据存放位置以及停止订阅后能否完整导出。
从 Apple Health 持续导出数据有哪些方法？
文章介绍了三种方法：一是使用快捷指令，可以直接读取 Apple Health 数据并支持条件筛选，实现增量导出，甚至上传到云端，有现成方案如 Aimee1129/apple-health-shortcuts-mcp；二是使用现成工具，如 Health Push 可将数据导出为 JSON，Health Auto Export 功能更完整，支持自动发送到 REST API 或云存储；三是自己写 App，需要 Mac 和开发者账号，可利用 GitHub 上的 SDK 如 the-momentum/open_wearables_ios_sdk，自由度最高但门槛也最高。
Google Health、Health Connect 和 Google Fit 有什么区别？
Google Health 既是 App 也是云端服务，由 Fitbit App 更名而来，2026 年 5 月完成替换，Fitbit 与 Pixel Watch 的数据直接汇入，对外提供 Google Health API（v4）。Health Connect 是 Android 系统层的数据中转站，在本地存储数据并管理授权，从 Android 14 起已并入系统框架。Google Fit 是上一代产品，正在退场，官方说明 Fit API 支持到 2026 年底，App 本身也将并入 Google Health。
如何通过官方 API 或 SDK 获取 Oura 和 Whoop 的数据？
Oura 和 Whoop 的开发者接口对个人较为开放，前提是订阅有效。可以在开发者中心注册应用，取得 client_id 和 client_secret，再按文档完成授权。然后让 AI Agent 协助建立数据抓取、存储和分析程序。Oura 已弃用 Personal Access Token，需采用 OAuth 2.0；Whoop 已迁移到新版 API，旧版 webhook 已移除。Whoop 的数据按 physiological cycle 组织，不是自然日，处理时需注意。
国内厂商（华为、小米、OPPO、vivo）对个人开发者开放健康数据接口的情况如何？
华为、小米、OPPO、vivo 都有面向合作方的健康开放平台，但普通用户和个人开发者能使用的范围有限。华为的 Health Service Kit 允许个人开发者申请，不一定需要公司主体，可拿到基础数据，但需按项目申请，权限有使用期限；小米的健康云开放平台主要面向生态链企业及合作伙伴；OPPO 的 Health Research Kit 面向健康行业与科研机构；vivo 的 Health Kit 位于开发者开放平台，个人接入路径不明确。
