自動化
將 Apple 健康資料匯出到你設定的目的地,包含背景限制、提醒與共用設定。
最後更新: 2026年10月31日
本頁內容
自動化會將 Apple 健康資料匯出到你設定的目的地。自動執行取決於 Apple 的健康資料存取權限與背景限制。
建立或編輯自動化
- 在 iPhone 上開啟 匯出 → 自動化。在 iPad 上開啟側邊欄中的 自動化。
- 選擇 新增自動化,或開啟現有自動化。
- 輸入自動化名稱、選擇目的地,並按下方指南完成設定。
- 選擇所需的資料與匯出設定,開啟 啟用,然後選擇 更新 以儲存。
你可以返回未完成的自動化繼續設定。
可用的自動化類型
| 目的地 | 作用 |
|---|---|
| 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 控制。
取得協助
請先查看活動記錄與目的地的疑難排解部分。若仍需協助,請參閱取得協助。