HealthyApps Help Center

自动化

了解 HealthyApps 中的自动化功能。

Last updated: May 20, 2026

本页目录

自动化概览指南

自动化可让您无需手动操作，即可将 Apple 健康数据自动导出并同步到各种目标。本指南概述自动化功能，并提供各自动化类型的详细指南链接。

概览

自动化是已配置的工作流，可将健康数据自动导出到外部服务、云存储或其他目标。配置完成后，自动化可在后台自动运行。

优势：

  • 自动备份与同步数据
  • 无需手动操作
  • 可配置同步频率
  • 多种自动化类型，适用于不同场景
  • 后台运行（无需打开 App）

使用场景：

  • 自动云备份
  • 与家庭自动化系统集成
  • 自定义应用的 API 集成
  • 数据分析与可视化平台
  • 与医疗服务提供者共享健康数据

限制：

  • 健康数据访问： iPhone 锁定时，App 无法访问健康数据。自动化仅在设备解锁期间运行。这是 Apple 施加的限制，无法绕过。更多信息
  • 后台处理： iOS 为节省电量会限制后台处理。自动化依赖“后台 App 刷新”，在以下情况下可能不会立即运行：
    • 已为该 App 关闭“后台 App 刷新”
    • 设备处于低电量模式
    • 设备长时间未活动
    • 系统资源紧张
    • 多个 App 竞争后台执行时间
  • 计划任务： 与后台处理相关，iOS 也不允许 App 在指定时间于后台运行。因此即使设置了特定同步频率，也无法保证在精确时间运行。设备必须处于解锁状态，由 iOS 决定后台何时运行自动化。也可通过以下方式手动触发：
    • 自动化小组件： 点按小组件图标以触发自动化
    • 快捷指令 — 运行自动化： 使用运行自动化操作触发已配置的自动化（参见使用快捷指令计划自动化）
    • 在 App 内手动触发： 在 Health Auto Export 中打开该自动化，然后执行手动导出
  • 前台同步： 当 Health Auto Export 在前台打开时，符合条件的自动化可能按固定节奏（约每 60 秒）再次运行。前台使用时设备保持唤醒，同步可继续。仅当设备达到严重发热状态时，前台循环才会暂停；较热（非严重）状态仍可能允许前台同步。App 不在前台时，仍适用上述后台计划限制。

可用的自动化类型

Health Auto Export 支持多种自动化类型，每种针对特定场景设计：

REST API

将健康数据发送到接受 HTTP POST 请求的任何 Web 服务。适合自定义后端、Webhook 和第三方 API。

指南： REST API 自动化指南

Home Assistant

将健康指标同步为 Home Assistant 的传感器状态。适合将健康数据融入智能家居自动化。

指南： Home Assistant 自动化指南

MQTT

将健康数据发布到 MQTT 代理。适合 IoT 平台和基于 MQTT 的系统。

指南： MQTT 自动化指南

Dropbox

自动将健康数据备份到 Dropbox。文件按文件夹整理，可在任意设备访问。

指南： Dropbox 自动化指南

Google 云端硬盘

自动将健康数据备份到 Google 云端硬盘。CSV 可转换为 Google 表格以便查看。

指南： Google 云端硬盘自动化指南

iCloud 云盘

将健康数据直接保存到 iCloud 云盘。设置简单，无需身份验证。

指南： iCloud 云盘自动化指南

日历

根据健康数据创建日历事件。在日历中查看锻炼、健康里程碑等。

指南： 日历自动化指南

创建第一个自动化

  1. 从主导航进入“自动导出”屏幕
  2. 点按“新建自动化”
  3. 选择自动化类型
  4. 配置该类型专属设置（见各指南）
  5. 配置通用设置（数据类型、同步频率等）
  6. 点按“更新”保存
  7. 启用自动化

活动日志

每个自动化都有用于运行历史的活动日志。

  1. 打开自动化，点按查看活动日志。
  2. 事件按运行分组（最新运行在上）。展开某次运行可查看各事件。
  3. 警告（例如健康数据查询较慢）表示运行已完成，但某步骤耗时超出预期。错误表示某步骤失败（上传、HealthKit 读取、身份验证等）。
  4. 清除（工具栏）仅删除该自动化的活动历史，不会删除 App 范围内的诊断日志。
  5. 共享（工具栏）导出完整的 App 事件日志诊断 ZIP，与设置 → 高级 → 导出事件日志相同。参见 App 事件日志指南。

活动日志中的慢查询

  • 若获取健康数据耗时较长，活动日志可能显示健康数据查询较慢警告（非错误）。
  • 加快运行：选择更少健康指标、缩短日期范围、开启汇总数据、选择更大的时间分组（小时、天或周）。
  • 实时自动化设计上使用更细的分组，可能更常出现慢查询警告。

导出设置警告

配置健康指标自动化（非 Home Assistant）时，若配置可能较慢，导出设置下方可能出现页脚：

  • 汇总数据已关闭，或时间分组为分钟或秒，且
  • 已选择超过 10 个健康指标

页脚建议减少指标、缩短日期范围、开启汇总数据或采用更粗的时间分组，并链接到本指南。慢查询警告在活动日志中单独显示，于运行后查询超过阈值时出现。

最佳实践

  1. 自动同步：
  • 为设备充电并使用 iPhone 镜像
    • 充电时 iOS 对性能限制较少，数据可更频繁同步
    • 使用 iPhone 镜像时，设备行为与解锁时相同，Health Auto Export 可访问健康数据以运行自动化
  1. 同步频率：
  • 在数据新鲜度与资源使用之间取得平衡
  • 多数场景每日同步即可
  • 实时需求可提高频率
  • 汇总数据可降低频率
  1. 数据选择：
  • 仅选择需要的指标
  • 减少处理时间与数据量
  • 可为不同指标组设置单独自动化
  1. 测试：
  • 执行手动导出
  • 确认目标端出现数据
  • 在活动日志中查看错误
  • 密切关注初始同步
  1. 监控：
  • 定期查看活动日志
  • 检查自动化状态指示
  • 为重要自动化设置通知
  • 在目标端确认已收到数据
  1. 安全：
  • 使用安全的身份验证方式
  • 保持凭据最新
  • 可用时使用 HTTPS/TLS
  • 检查隐私设置
  1. 性能：
  • 使用合适的时间分组
  • 考虑云存储的日期范围设置
  • 监控电量与数据用量
  • 在活动日志中查看慢查询警告
  1. 备份策略：
  • 使用多种自动化类型实现冗余
  • 将云存储与 API 集成结合
  • 尽可能保留本地备份
  • 测试恢复流程
  1. 故障排除：
  • 先查看活动日志
  • 检查网络连接
  • 检查身份验证凭据
  • 查阅各自动化指南中的具体问题

自动化小组件

将“自动化”小组件添加到主屏幕即可：

  • 一目了然地查看自动化状态
  • 手动触发自动化
  • 优化后台上传

获取帮助

若需要特定自动化类型的帮助：

  1. 查阅对应的自动化指南
  2. 在活动日志中查看错误信息
  3. 阅读故障排除章节
  4. 若问题仍存在，请联系支持