在 15 分钟内解锁你的 Apple Health 数据：导出、分析并向 AI 询问任何问题
I’m happy to translate the article for you, but I don’t see the article’s content in your message—only the source line is provided. Could you please paste the text (or the portion you’d like translated) that follows the source link? Once I have the content, I’ll translate it into Simplified Chinese while preserving the formatting, markdown, and any code blocks or URLs.
提取 Apple Health 数据 – 问题
Apple 并未公开 Health 数据的 REST API，因此如果想要分析这些数据（或让 LLM 使用它），基本上有两种选择：
-
使用第三方应用，利用 HealthKit 并将数据发送到服务器或云存储（Google Drive、Dropbox …）。
示例： Auto Health Export（通常为付费）。 -
使用 Apple 内置的导出功能。
- 导出可能需要几分钟，容易被中断，并且必须每天重复一次才能保持最新。
为什么我启动了这个项目
我已经使用 Apple Watch 超过 7 年了，手动导出数据的摩擦感一直让我很烦恼。
-
几年前，我和一个小团队构建了 Apple Health MCP —— 一个将可穿戴设备数据连接到大语言模型的概念验证。它运行良好，获得了关注，但需要用户手动导出数据，摩擦太大。
-
上述痛点促成了 Open Wearables 的诞生 —— 一个开源、自托管的平台，它：
- 自动导出你的数据。
- 提供后端、存储以及一个友好的 UI 来浏览数据。
- 提供 AI 层（MCP 服务器），可以将数据连接到任何 LLM 客户端。
它支持 Apple Health 以及 许多其他生态系统（Garmin、Polar、Whoop、Suunto，……）。
这适合谁？
| 受众 | 能得到什么 |
|---|---|
| 开发者 | 一个处理供应商集成、数据标准化、身份验证等的中间件层。 |
| 个人用户 | 一个集中存储和探索他们（或其家人）可穿戴设备数据的地方。 |
快速入门：将您的 Apple Health 数据导入 Open Wearables（≈ 15 分钟）
1️⃣ 运行 Open Wearables 实例
您有两种方式可以让平台启动并运行。
选项 A – 部署到 Railway（最简易）
-
点击 Deploy on Railway 按钮。
-
等待几分钟 – Railway 将会启动后端、前端、数据库、Redis 和后台工作进程。
-
第一次启动时会创建一个管理员账户：
email: admin@admin.com password: secret123
注意： Railway 是付费 SaaS（没有永久免费层）。新用户可获得一次性 $5 额度用于 30 天试用；试用结束后最便宜的套餐为 $5 / 月（Hobby）。
选项 B – 本地运行 + 使用 ngrok 暴露
# 克隆仓库
git clone https://github.com/the-momentum/open-wearables.git
cd open-wearables
# 使用 Docker 启动全部服务
docker compose up -d由于移动应用必须通过互联网访问后端，需要将本地服务器暴露出来：
ngrok http 8000您会得到类似 https://abc123.ngrok-free.app 的公共 HTTPS URL。请保存好——后面会用到。
提示： 若希望重启后 URL 不变，可使用自定义域名：
ngrok http 8000 --domain=your-custom-domain.ngrok-free.app2️⃣ 创建用户 & 邀请码
- 打开 Open Wearables 仪表盘（例如
https:///dashboard）。 - 使用管理员凭证（或您创建的任意账户）登录。
- 为移动应用创建新用户。
- 为 SDK 鉴权生成邀请码。
- 复制该码——稍后将在移动应用中粘贴。
3️⃣ 获取 Open Wearables 移动应用
该应用会在 iPhone 上连接 Apple Health，并将数据同步到您的 Open Wearables 实例。
选项 A – 自行构建应用
# 克隆 SDK 仓库
git clone https://github.com/the-momentum/open_wearables_health_sdk.git
cd open_wearables_health_sdk/example
# 安装依赖
flutter pub get
# 在真实 iOS 设备上运行
flutter run- 在 Xcode 中打开
ios/Runner.xcworkspace。 - 选择您的开发团队。
- 启用 HealthKit 能力。
- 重要： HealthKit 只能在真实设备上使用，模拟器不支持。
选项 B – 使用 TestFlight 邀请
- 加入 Open Wearables Discord。
- 申请 TestFlight 测试版邀请。
- 安装预构建的应用（免费，App Store 正式版即将上线）。
4️⃣ 将应用连接到您的后端
- 在 iPhone 上打开应用。
- 输入之前生成的邀请码。
- 输入 API URL（例如
https://api.openwearables.ai或您的 ngrok URL）。不要使用仪表盘 URL。 - 授予请求的 HealthKit 权限。
- 点击 Sync（同步）。
提示： 默认情况下，应用会同步您全部历史数据。若有 7 年数据（约 500 万条记录），首次同步可能需要约 20 分钟。
5️⃣ 在仪表盘中验证数据
返回 Open Wearables 仪表盘，您应该能看到：
- 步数
- 心率
- 睡眠
- 运动记录
- …以及许多其他时间序列指标
浏览图表、趋势和原始数据——现在您终于拥有一个可以真正处理 Apple Health 数据的地方。
6️⃣ 与 AI 对话你的数据 (MCP)
Open Wearables 附带一个 MCP（Model‑Connector‑Proxy）服务器，让你可以使用任何 LLM 客户端（ChatGPT、Claude、Llama 等）查询可穿戴设备数据。
原指南的后续章节（此处未列出）将引导你完成：
- 设置 MCP 服务器。
- 创建让 LLM 分析步数、心率趋势、睡眠质量等的提示词。
- 使用内置 UI 与自己的数据聊天。
TL;DR
- 部署 Open Wearables（Railway 或本地）。
- 创建 用户并获取邀请代码。
- 安装 移动应用（自行构建或通过 TestFlight）。
- 输入 邀请代码 + API URL → 同步。
- 在仪表盘 上浏览你的数据。
- 可选： 使用 MCP 服务器让 LLM 回答关于你健康的各种问题。
现在，你已经拥有一条从 Apple Health → Open Wearables → AI 驱动洞察的全自动流水线。祝使用愉快！
Open Wearables – 快速概览
Open Wearables 附带一个 MCP 服务器，让你可以将健康数据连接到任何 LLM 客户端（Claude、Cursor 等）。只需用自然语言提问，例如：
- “我上周的睡眠情况如何？”
- “显示我在锻炼时的心率趋势。”
- “比较本月与上月的步数。”
为什么你会喜欢它
- 全部开源 – 缺少某个功能？自行实现、提交 PR，或 fork 代码库。没有供应商锁定，也不必等路线图。
- 活跃社区 – 我们的 Discord 中有超过 100 名成员热衷于可穿戴设备数据。随时分享想法、在凌晨 2 点寻求帮助，甚至一起玩转 HRV 图表。无论你是开发者、健康爱好者，还是两者兼备，都能在这里找到归属感。
发挥创意
你可以随心所欲地使用你的数据。一个流行的示例：
在 n8n 中构建一个自动化流程，调用 Open Wearables API，检查每日活动，并在需要活动时通过你喜欢的消息应用发送提醒。
（参见我的黑客马拉松故事，获取一步步的操作指南。）
资源
- [Open Wearables GitHub repository]
- [Discord community]
- [Open Wearables walkthrough video]
行动号召
告诉我们你是否在 15 分钟 内完成了设置！我们非常重视开发者/用户体验，任何改进建议都将不胜感激。
玩得开心！