帮助中心 HealthyApps
简体中文
帮助中心
主网站 ↗

搜索帮助主题

自动化

将 Apple 健康数据导出到您配置的目标,包含后台限制、提醒和共享设置。

最后更新: 2026年10月31日

本页目录
创建或编辑自动化可用的自动化类型
限制 限制 排程同步频率打开 App
手动触发排程提醒
通用导出设置 通用导出设置 数据选择导出格式和版本日期范围汇总数据与时间分组运行通知
检查自动化状态性能
备份与恢复自动化 备份与恢复自动化 恢复
活动日志 活动日志 活动日志中的慢查询
自动化小组件获取帮助

自动化会将 Apple 健康数据导出到您配置的目标。自动运行取决于 Apple 的健康数据访问权限和后台限制。

创建或编辑自动化

  1. 在 iPhone 上打开 导出 → 自动化。在 iPad 上打开边栏中的 自动化。
  2. 选择 新建自动化,或打开现有自动化。
  3. 输入自动化名称,选择目标,并按下方指南完成设置。
  4. 选择所需的数据和导出设置,打开 启用,然后选择 更新 以保存。

您可以返回未完成的自动化继续设置。

可用的自动化类型

目标 作用
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 控制。

获取帮助

请先查看活动日志和目标的故障排除部分。若仍需帮助,请参阅获取帮助。