自动化
将 Apple 健康数据导出到您配置的目标,包含后台限制、提醒和共享设置。
最后更新: 2026年10月31日
本页目录
自动化会将 Apple 健康数据导出到您配置的目标。自动运行取决于 Apple 的健康数据访问权限和后台限制。
创建或编辑自动化
- 在 iPhone 上打开 导出 → 自动化。在 iPad 上打开边栏中的 自动化。
- 选择 新建自动化,或打开现有自动化。
- 输入自动化名称,选择目标,并按下方指南完成设置。
- 选择所需的数据和导出设置,打开 启用,然后选择 更新 以保存。
您可以返回未完成的自动化继续设置。
可用的自动化类型
| 目标 | 作用 |
|---|---|
| REST API | 将导出发送到 HTTP 端点 |
| Home Assistant | 将健康指标发布为实体状态 |
| MQTT | 将 JSON 发布到代理主题 |
| Dropbox | 将导出文件保存到 Dropbox |
| Google Drive | 保存文件,可选将 CSV 转为 Sheets |
| iCloud Drive | 将导出文件保存到 iCloud Drive |
| 日历 | 创建或更新日历事件 |
| 电子邮件 | 将导出作为电子邮件附件发送 |
限制
- 健康数据访问: iPhone 锁定时,App 无法访问健康数据。自动化仅在设备解锁期间运行。这是 Apple 施加的限制,无法绕过。更多信息
- 后台处理: iOS 为节省电量会限制后台处理。自动化依赖后台 App 刷新,在以下情况可能不会立即运行:
- 已为该 App 关闭后台 App 刷新
- 设备处于低电量模式
- 设备长时间未使用
- 系统资源紧张
- 多个 App 竞争后台执行时间
排程
iOS 不保证在指定时间执行后台运行。若要在选定时间触发自动化,请参阅使用快捷指令排程自动化。操作读取健康数据时,设备必须处于解锁状态。
同步频率
选择数字和时间单位(例如 每 15 分钟)以设置期望的后台同步节奏。这并不保证 App 会按该间隔打开或运行。 后台执行何时可用由 iOS 决定。
打开 App
自动化和同步到 Mac 在 Health Auto Export 保持打开时运行。
手动触发
您可以使用以下方式开始运行:
- 自动化小组件: 点按主屏幕小组件上的云按钮。请参阅自动化小组件。
- 快捷指令: 使用 运行自动化 触发已配置的自动化。请参阅快捷指令设置。
- 在 App 内: 在 导出现有数据 下选择 手动上传,设置 开始 和 结束 日期,然后选择 开始导出。用于在开始自动化时导出历史数据、补齐自动同步遗漏的日期,或检查设置。
排程提醒
每项自动化可选择提醒您解锁设备并打开 Health Auto Export。打开 启用提醒,然后将 提醒频率 设为 每小时、每天 或 选定日期。每小时提醒使用 每小时的第几分钟;每天和选定日期提醒使用 提醒时间。提醒并不表示自动化已运行,即使后台同步已成功仍可能出现。
- 提醒更改在保存自动化后生效。编辑器会显示 保存后的下次提醒。
- 点按提醒会打开该自动化。
- 打开并同步 是通知上的操作。它会打开 App 并立即运行该自动化。自动化必须已启用。
- 如果自动化已删除、已禁用、正在运行,或在当前访问权限下无法运行,App 会返回自动化屏幕。
- 使用提醒需要通知权限。通知访问 显示当前状态。若通知被拒绝,请使用 打开通知设置。
通用导出设置
数据选择
选择 数据类型,然后选择要包含的健康指标、锻炼类型或症状。可用的数据类型和格式取决于目标。覆盖范围请参阅支持的数据。
对于健康指标,每项自动化都有自己的来源偏好。
对于锻炼,包含锻炼指标 会添加心率或步数等选定读数。包含路线数据 会在锻炼数据中包含可用路线。字段可用性和锻炼时间分组请参阅锻炼格式参考。
导出格式和版本
- JSON 为集成保留结构化数据。
- CSV 适合电子表格。
- Markdown 生成可读的笔记和表格。
Home Assistant 和 MQTT 使用 JSON;日历创建事件而不是文件。Google 表格转换仅适用于 Google Drive 的 CSV 导出。
对当前导出结构使用 版本 2;现有工作流需要时使用 版本 1。格式详情请参阅 JSON 和 Markdown。
日期范围
Dropbox、Google Drive、iCloud Drive 和日历按 日、周、月 或 年 整理数据。每个选定周期包含直到该周期结束(含最后一秒)的读数。
REST API、MQTT 和电子邮件提供:
| 选择 | 包含的时段 |
|---|---|
| 默认 | 前一天以及运行时刻之前的今天 |
| 自上次同步以来 | 自上次同步至运行时刻 |
| 今天 | 运行时刻之前的今天 |
| 昨天 | 前一天 |
| 过去 7 天 | 过去完整的七天 |
Home Assistant 提供 默认、今天 和 昨天。
汇总数据与时间分组
对于 JSON 健康指标导出,汇总数据 会将读数合并到选定的 时间分组。需要单独读数时(在支持的情况下)请关闭。CSV 自动化导出使用汇总数据。可用的时间分组取决于目标和日期范围。
指标特定的平均值、合计和每日摘要请参阅健康指标。
运行通知
缓存更新时通知 报告数据已准备好;运行时通知 报告目标操作成功。这些与提示您打开 App 的排程提醒不同。
检查自动化状态
在自动化中打开 查看活动日志 以查看运行记录。自动化运行时,在导出或自动化屏幕上选择 停止,并确认是否要取消运行。
性能
较长的日期范围、大量选定指标、详细的锻炼路线,以及按分钟或秒级的读数,可能耗时更长,并超过后台运行可用的时间或资源。
- 仅选择所需数据。
- 使用更短的日期范围或更粗的时间分组以缩小导出。
- 适当时将大型导出拆分到多个自动化。
- 对于大型 REST 负载,可考虑批量请求。
备份与恢复自动化
Health Auto Export 可将自动化 设置 备份到 iCloud Drive,以便在新设备或重新安装 App 后恢复。这与自动化导出的健康数据无关。
- 备份位置: 自动化设置以 JSON 文件保存在 iCloud Drive 的 Auto Export/Automations 文件夹中(可在“文件”App 中查看)。
- 备份时机: 每次保存自动化时(点按 更新,或离开编辑屏幕),该自动化都会自动备份。
- 打开或关闭: 打开自动化列表,进入 自动化设置,然后使用 备份到 iCloud Drive。默认开启。若关闭,系统会询问是否删除 iCloud Drive 中的现有备份文件——无论选择哪项,设备上的自动化都会保留。
恢复
如果打开 自动化 时还没有任何自动化,但 iCloud Drive 中有可用备份,会出现 从 iCloud Drive 恢复 按钮。点按即可恢复自动化。
恢复后需注意:
- 重新连接账户: 出于隐私考虑,Dropbox、Google Drive 等服务的登录令牌 不会 包含在备份中。恢复后请在每项自动化中重新连接这些服务。
- 重新启用自动化: 恢复的自动化以 禁用 状态开始,以免使用过时设置意外运行。请逐一检查,准备好后再启用。
- 部分恢复: 若某些自动化无法恢复(例如文件尚未下载、加密密钥尚不可用,或由更新版 App 创建),其余仍会恢复,并显示跳过的项。
注意:您在自动化中输入的请求标头和凭据(例如 MQTT 密码)在 iCloud Drive 备份文件中是 加密 的。在新设备上恢复需要 iCloud 钥匙串,以便 App 解密。
活动日志
打开自动化并选择 查看活动日志。展开一次运行以查看其事件。
- 警告 标记潜在问题(例如数据检索缓慢);并不表示整次运行已成功。
- 错误 标识失败步骤,例如读取数据、身份验证或上传。
- 清除 会删除该自动化的活动历史记录。
- 共享 导出卖给支持的全 App 诊断。请参阅App 事件日志。
活动日志中的慢查询
如果某次运行报告健康数据查询缓慢,请减少指标、缩短日期范围,或打开 汇总数据 并使用更粗的 时间分组。
自动化小组件
添加自动化小组件,以便从主屏幕查看状态或触发已启用的自动化。后台刷新时机由 iOS 控制。
获取帮助
请先查看活动日志和目标的故障排除部分。若仍需帮助,请参阅获取帮助。