幫助中心 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 轉為試算表
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 控制。

取得協助

請先查看活動記錄與目的地的疑難排解部分。若仍需協助,請參閱取得協助。