让 Agent 读懂你的身体：数据获取篇

某一天，我站在健身房里，发现自己似乎已经有一阵子没什么进步了，隐约生出一种「怎么练来练去还是这样」的顿感。我知道，这多半是平台期。理论上，我要做的无非是调整训练量、换动作、看恢复、查饮食，必要时调整周期安排。但前提是，我得先知道自己卡在哪一环。

于是，我开始琢磨一件事：能不能让 AI Agent 来「接管」我的身体？这个需求可以拆分成三个问题：

1. AI Agent 怎么才能方便地拿到我的数据？
2. 拿到数据后，怎么让 AI Agent 正确地处理？
3. AI 的处理结果在多大程度上可信？

由于篇幅问题，这三个问题，我准备分开来写。本文处理第一个问题：怎样让 AI 持续拿到我已经在记录的数据。

需要承认的是，我个人的精力与手边的设备都有限，只能实测从 Apple Health 与 Oura 获取数据的方法；其余厂商的部分，均来自公开资料的整理。如果有实际跑不通的地方，欢迎在评论区指正。

先判断数据在哪里

不同的获取方式之所以显得复杂，是因为健康数据并不只存在于一个地方。有些是手表直接记录的，有些经过厂商算法计算，还有一些本来就需要手动填写。为了便于理解，我个人粗浅地将运动健康数据分为三层：

第一层通常是步数、心率、睡眠时段和运动轨迹等基础记录；第二层是 readiness、strain、resilience 一类经过算法计算的指标；第三层则包括饮食、训练感受和其他手工记录。

这些数据大致分散在三类来源：

• 聚合平台：Apple Health、Health Connect 与 Google Health，负责汇集设备和第三方 App 写入的通用数据；
• 厂商或专业 App：Oura、Whoop、Samsung Health、Garmin、训记、Hevy 等，通常还保留平台里没有的特色指标；
• 报告或手工记录：饮食、体成分、体检报告等，未必有稳定的数字化入口。

厂商或 App 大多能把第一层以及部分第二、三层信息同步给平台，但不会交出原应用里的全部内容。一方面，Apple Health 或 Health Connect 未必有对应字段；另一方面，某些复合指标本来就是订阅产品的核心卖点。因此，选择获取方式时，可以先问自己两个问题：数据是否已经进入聚合平台，以及平台里的字段够不够用。

在此基础上，下面，我将介绍七种获取数据的路径，供读者按情况参考。

方法一、直接在 AI 产品里使用

如果你只想做些轻量分析，不愿花太多心力配置，最直接的选择是让 AI 产品读取现成的数据。

ChatGPT 与 Claude 都支持在 iOS App 内接入 Apple Health。以 ChatGPT 为例，符合开放条件的用户可以授权读取健康数据，然后直接提问。

不过，这类功能的可用性受地区、账号和开放进度等条件影响，一般只在美国先上线。如果你不在美国，也没有办法获得「假装在美国」的环境，国内的蚂蚁阿福 App 也可以接入 Apple Health 并做问答。按我的实测，相关功能还比较基础，能够应付一些简单的睡眠与运动问题，复杂分析的表现则较为有限。从产品呈现来看，它更侧重体检报告解读与 AI 问诊，健康管理功能似乎并不成熟。

总的来说，这种方式胜在省心，但更适合临时查询和轻量分析；如果希望长期积累、自由查询或者更换模型，还是需要把数据保存到自己能够控制的位置。

方法二、使用现成连接器或中转服务

另一种省事的路径，是使用厂商已经做好的连接器，或者让第三方服务替你完成数据汇集。得益于 AI 的火热，「能被 AI Agent 读取」正在变成这类服务的一项卖点。例如：

• Strava 上线了官方 MCP 连接器，面向订阅用户，可以让 AI Agent 直接获取数据。
• 训记向买断用户提供 API Skill，入口在「我的」>「数据导出和导入」。这个 API 还支持回写，Agent 可以把训练记录写回 App。
• Hevy 可以在 Settings > Developer 中生成 API Key，需要 Hevy Pro 订阅。
• Freddy 则更像一台健康数据的中转服务器：它可以把多个平台的数据同步到自己的服务器，再通过 MCP 或 API 提供访问。第一个数据源免费，多数据源需要订阅，也提供价格较高的终身买断。此外，配置省事的代价，是数据需要存储在第三方服务器上。

如果选择连接器服务，需要确认它能读取哪些字段、数据存放在哪里，以及停止订阅后能否完整导出。

方法三、从聚合平台持续导出

如果多个设备和 App 已经把数据写入同一个平台，从平台统一导出，往往比逐个连接厂商更省事。Apple Health、Health Connect 与 Google Health 都承担了这样的角色，但三者的工作方式并不完全相同。

Apple Health

想到要把健康数据和 AI Agent 对接，我的第一反应就是从 Apple Health 入手。一方面，Apple Watch 是我的主要数据来源之一；另一方面，Apple Health 本身就是一个汇总平台，支持相当丰富的数据类型。除了手表记录的数据外，一些第三方 App 写入的营养和训练记录，也可以汇集在这里。你甚至可以手动在「健康」App 中添加数据。

支持 Apple Health 生态的第三方厂商也比较多。根据我的查询，至少小米、Zepp、OPPO、佳明等都支持同步，Keep、Nike Run Club 等运动 App 也可以接入。至于是否写入你看中数据，建议读者根据自身情况进一步核实。

得益于其完善的生态，读取和导出 Apple Health 的工具也已相当丰富。下面介绍快捷指令、第三方 app 和自己 vibe 工具三种方法。

快捷指令

快捷指令是 iOS 自带的自动化工具，少数派社区里已经有很多介绍和攻略文章，这里就不过多赘述。

快捷指令可以直接读取 Apple Health 的数据，并且支持日期、时间等条件筛选。于是，「只导出你真正关心的那几项指标」以及「增量导出」成为可能；若你已经备好服务器或数据库，甚至可以让它把数据直接送上云端。

这同样有现成的方案，例如Aimee1129/apple-health-shortcuts-mcp。你可以跟着教程搭建适合自己的快捷指令，一键把所需数据上传到云端数据库，再让 AI Agent 通过 MCP 读取。

在我的实际体验中，这个方法能够覆盖我需要的大多数数据类型。主要门槛在于需要一些动手配置的耐心，当然，这个过程也可以请 AI 协助：

我想用快捷指令持续导出特定的 Apple Health 数据。请先完整读这篇教程再回答，不要凭记忆推测操作步骤。我的环境：iPhone ___，iOS ___，有/没有 Apple Watch，有/没有 Cloudflare 账号。我要导出的指标：___。请先告诉我这些是否都在该项目默认支持的范围内；如果有超出的，说明需要改哪些地方，以及改动难度。我的最终目标是 ___（例如：每天睡醒自动同步昨天的睡眠数据，每天运动完自动同步运动数据，每天 0 点自动同步状态数据）。请说明如何处理迟到的数据、重复记录和后续修改。交付方式：一步一步来，每步给一个动作，我做完回复「好了」或发截图，你再给下一步。如果文档里的步骤和我实际看到的界面对不上，指出差异并给替代路径。

现成工具：花一点钱，少做一些配置

如果不想自己搭快捷指令，可以使用专门的导出工具。

例如，Health Push 是一个简单的小工具，可以将数据导出为 JSON，供 AI Agent 读取和分析。

Health Auto Export 的功能则更完整。它支持选择数据类型、时间范围和导出格式，也可以把数据自动发送到 REST API 或云存储（需要高级版）。接收端可以放在电脑、NAS、服务器上，也可以使用 Supabase、Cloudflare 一类云服务。数据库建表和数据清洗等工作，可以交给 AI Agent 协助完成。可惜的是，国区目前不支持终身买断。

自己写 App：自由度更高，门槛也最高

倘若你有一台 Mac，并且拥有开发者账号，又稍微懂一点 iOS 应用开发，也可以自己做一个自用 App 来导出数据，甚至同步到自己的服务器或电脑。

GitHub 上有可用的 SDK，例如 the-momentum/open_wearables_ios_sdk。所谓 SDK，就是别人写好、封装好的一段可复用功能，你只要调用它，不必从零写起，交给 AI 稍作修改包装即可上手。

可以先让 Agent 按 SDK 文档做出一个最小应用，在真机上完成授权和一次同步，再增加数据类型与更新机制。

请基于这个 SDK，帮我开发一个个人自用的 iOS App：https://github.com/the-momentum/open_wearables_ios_sdk

请先阅读项目文档，确认支持范围，不要凭记忆编写接口。

我的环境：Mac ___，Xcode ___，iOS ___，开发者账号类型 ___。需要读取的 Apple Health 数据：___。历史范围：___。保存目标：本地文件／自己的电脑／服务器？

先做最小版本：真机安装 > 读取授权 > 按日期查询 > 导出 JSON。保留时间、单位、来源和记录标识，确认数据正确后，再增加上传、增量同步、去重和失败重试。后台同步以 iOS 实际支持的能力为准。

先给方案，我确认后再执行。遇到文档缺失或权限限制，明确说明，不要猜测。

不过，开发、安装和长期稳定使用是不同的事情。苹果允许通过 Xcode 的 Personal Team 在个人设备上测试应用，只是免费签名有有效期等限制。

Google Health 与 Health Connect

Android 这边，首先需要理清几个容易混淆的名字：

• Google Health：既是 App，也是云端服务。它由 Fitbit App 更名而来，2026 年 5 月完成替换；Fitbit 与 Pixel Watch 的数据直接汇入其中，对外提供 Google Health API（v4，即 Fit API 的继任者）。
• Health Connect：Android 系统层的数据中转站，在本地存储数据并管理授权，让不同的健康类 App 读写同一份记录。从 Android 14 起，它已并入系统框架，无需另装。
• Google Fit：上一代产品，正在退场。官方说明 Fit API 支持到 2026 年底，App 本身也将并入 Google Health。

如果你使用 Fitbit 或 Pixel Watch，数据会直接进入 Google Health。其他品牌则要看对应 App 能否把所需数据写入 Health Connect。

从公开信息和网上讨论看，OPPO、vivo、小米等国内厂商的国际版，以及非国行的三星设备，都支持向 Health Connect 写入数据。以小米为例，可以在 Mi Fitness 的「账号—添加账号」中授权。但我手上没有真机，无从逐一确认。部分国行三星设备也可以通过开发者设置与地区调整启用 Health Connect；这类方法依赖具体系统版本，不能直接视为通用方案。

在 Health Connect 一侧，老牌工具 Health Sync 和开源项目 Health Data Export 都是现成的选择。前者可以把数据导出到网盘或者服务器，支持多种格式；后者支持导出到 Google 表格并增量更新。

如果想自己定制，可以参考 Health Connect 官方文档 或第三方项目 the-momentum/open_wearables_android_sdk。相比 iOS，Android 自用应用的安装通常更灵活，调试和安装到自己的手机上不需要商店开发者账号。

方法四、直接调用官方 API 或 SDK

如果平台不能提供你需要的数据，就要回到数据来源。厂商提供的 API、SDK 或官方连接器，能够直接读取原服务里的数据，通常也更适合自动更新。

Google Health API

Google Health 提供了一条与 Apple Health 本地接入不同的路径：通过 API 从 Google Health 云端直接获取数据。大致流程是：创建 Google Cloud 项目、启用 API、配置 OAuth 应用和所需权限，再完成账号授权。个人自用可以全程自助；只有支持超过 100 名用户时，才会触发安全审核。

谷歌还提供了 Google-Health-API/google-health-cli。它覆盖四十余种数据类型，可输出 JSON、CSV 或终端表格，仓库里也附有 Agent Skill 文件。对于想让 Agent 直接读取自己数据的人，这算得上是一种官方适配。

Oura 与 Whoop

Oura 与 Whoop 的生态位颇为相近：硬件价格较高，完整体验依赖订阅，生态相对封闭，但开发者接口对个人较为开放，前提是订阅仍然有效。

如有开发需求，可以直接在 Oura 和 Whoop 的开发者中心注册应用，取得 client_id 和 client_secret，再按文档完成授权。接下来，就可以让 AI Agent 协助建立数据抓取、存储和分析程序。

以 Oura 为例：

请先读一遍 Oura 官方文档再回答，不要凭记忆写端点和参数：https://cloud.ouraring.com/v2/docs。认证部分：https://cloud.ouraring.com/docs/authentication。

目标：写一个本地脚本，定期把我自己的 Oura 数据拉下来，存进本地 SQLite。

环境：脚本跑在 ___（Mac / Docker），语言用 Python，依赖可以自由安装。

认证：我已在 Oura 后台创建了 OAuth 应用，拿到了 client_id 和 client_secret。

我要拉的数据：___（例：daily_sleep、daily_readiness、daily_activity、sleep、workout；heartrate 暂不拉／只拉最近 N 天）。历史回补范围：___。之后的更新频率：___。

方案里请明确处理这几点：

1. 授权码流程怎么在本地跑通；
2. token 的有效期和刷新机制是什么，刷新后如何持久化新 token，以及失效时的恢复路径；
3. 增量拉取的判重键和断点续传。

先给方案，把你的不确定点和默认假设一次性列出来，我确认后再写代码。

（安全提示：令牌更适合在本地配置，不要直接粘贴进对话。）

如果开发基础薄弱，也没必要重复造轮子。spxrogers/oura-toolkit 面向 AI Agent 使用场景，直接把仓库地址交给 Agent 即可开始配置；Whoop 也有现成的社区项目，如 dpshde/whoop-mcp。

需要留意的是，Oura 已于 2025 年 12 月弃用 Personal Access Token（PAT），目前需要采用 OAuth 2.0；WHOOP 也已迁移到新版 API，旧版 webhook 已移除。网上不少旧脚本和教程已经不再适用。

WHOOP 还有一个容易忽略的细节：它不按自然日组织数据，基本单位是 physiological cycle（生理周期）。让 Agent 处理数据前，需要明确这个定义，否则它可能直接按日历日期聚合，得到一份时间错位的分析。

三星：Health Connect 或 Data SDK

按官方文档，Samsung Health 与 Health Connect 之间支持双向同步，但只覆盖有限的类别。

如果想读取 Energy Score 等特色数据，可以使用 Samsung Health Data SDK。在 Samsung Health 里连点十次版本号打开开发者模式，再按 SDK 要求申请权限并读取数据。

具体做法与前文类似：让 Agent 创建一个Android 应用，接入 SDK，申请所需权限，读取后保存为文件或上传到接收端。

国内厂商：个人接口普遍有限

华为、小米、OPPO、vivo 都有面向合作方的健康开放平台，但普通用户和个人开发者能够使用的范围有限。四家的情况可以归纳如下：

厂商 面向个人的接口 个人能拿到什么 门槛 华为 有限开放 基础数据 按项目申请，权限有使用期限，并有应用相关要求 小米 暂未找到 — 健康云开放平台主要面向生态链企业及合作伙伴 OPPO 暂未找到 — Health Research Kit 面向健康行业与科研机构 vivo 暂未找到 — Health Kit 位于开发者开放平台，个人接入路径不明确

可以看出，只有华为的 Health Service Kit 允许个人开发者申请，不一定需要公司主体。理论上，你可以自己写一个 App，持续把自己的数据导出。