自動化
了解 HealthyApps 中的自動化功能。
Last updated: June 9, 2026
本頁內容
自動化概覽指南
自動化可讓您無需手動操作，即可將 Apple 健康資料自動匯出並同步到各種目的地。本指南概述自動化功能，並提供各自動化類型的詳細指南連結。
概覽
自動化是已設定的工作流程，可將健康資料自動匯出到外部服務、雲端儲存或其他目的地。設定完成後，自動化可在背景自動執行。
優點：
- 自動備份與同步資料
- 無需手動操作
- 可設定同步頻率
- 多種自動化類型，適用於不同情境
- 背景執行（無需開啟 App）
使用情境：
- 自動雲端備份
- 與居家自動化系統整合
- 自訂應用程式的 API 整合
- 資料分析與視覺化平台
- 與醫療服務提供者分享健康資料
限制：
- 健康資料存取： iPhone 鎖定時，App 無法存取健康資料。自動化僅在裝置解鎖期間執行。這是 Apple 施加的限制，無法繞過。更多資訊
- 背景處理： iOS 為節省電力會限制背景處理。自動化依賴「背景 App 重新整理」，在以下情況可能不會立即執行：
- 已為該 App 關閉「背景 App 重新整理」
- 裝置處於低耗電模式
- 裝置長時間未使用
- 系統資源不足
- 多個 App 競爭背景執行時間
- 排程： 與背景處理相關，iOS 也不允許 App 在指定時間於背景執行。因此即使設定了特定同步頻率，也無法保證在精確時間執行。裝置必須處於解鎖狀態，由 iOS 決定背景何時執行自動化。也可透過以下方式手動觸發：
- 自動化小工具： 點一下小工具圖示以觸發自動化
- 捷徑 — 執行自動化： 使用執行自動化動作觸發已設定的自動化（參閱使用捷徑排程自動化）
- 在 App 內手動觸發： 在 Health Auto Export 中開啟該自動化，然後執行手動匯出
- 前景同步： 當 Health Auto Export 在前景開啟時，符合條件的自動化可能依固定節奏（約每 60 秒）再次執行。前景使用時裝置保持喚醒，同步可繼續。僅當裝置達到嚴重過熱狀態時，前景迴圈才會暫停；較熱（非嚴重）狀態仍可能允許前景同步。App 不在前景時，仍適用上述背景排程限制。
效能
請注意，iOS 針對行動裝置上限制嚴格的短時間工作進行了最佳化。背景工作通常須在 30 秒內完成，且可用記憶體有限。Health Auto Export 提供很高的彈性與自訂能力，因此了解某些設定如何影響 App 效能與結果很重要。
- 設定： 產生大量資料的自動化可能導致系統終止程序，使自動化無法在背景執行。以下設定可能產生大量資料：
- 設定為匯出所有健康指標的自動化。
- 建議： 僅選擇 Apple 健康中已有資料的健康指標，以及您實際計畫使用的資料。即使是空的資料類型也會影響效能。您也可以考慮將所選健康指標拆分到多個自動化中，便於系統處理。
- 使用秒或分鐘時間分組，或關閉資料摘要的自動化。如此細緻的查詢可能耗時較長，並與系統限制衝突。
- 建議： 儘管盡可能詳細的資料看似理想，請考慮每個指標或資料類型是否真的需要該粒度。可考慮使用不同設定的多個自動化。
- 匯出戶外運動（如騎車、跑步、健行等）並包含路線資料時，GPS 及相關健康指標資料可能產生很大的承載量。
- 設定為匯出所有健康指標的自動化。
- 承載大小： 尤其是使用 REST API 匯出時，過大的承載可能導致伺服器錯誤。請確保後端能處理可能達數百 MB 的承載。
- 同步頻率： 將自動化小工具加入主畫面，有助於確保自動化在背景成功執行（參閱設定自動化小工具）。
可用的自動化類型
Health Auto Export 支援多種自動化類型，每種針對特定情境設計：
REST API
將健康資料傳送到接受 HTTP POST 請求的任何 Web 服務。適合自訂後端、Webhook 和第三方 API。
指南： REST API 自動化指南
Home Assistant
將健康指標同步為 Home Assistant 的感測器狀態。適合將健康資料融入智慧居家自動化。
MQTT
將健康資料發佈到 MQTT 代理程式。適合 IoT 平台和基於 MQTT 的系統。
指南： MQTT 自動化指南
Dropbox
自動將健康資料備份到 Dropbox。檔案依資料夾整理，可在任意裝置存取。
指南： Dropbox 自動化指南
Google 雲端硬碟
自動將健康資料備份到 Google 雲端硬碟。CSV 可轉換為 Google 試算表以便檢視。
指南： Google 雲端硬碟自動化指南
iCloud 雲碟
將健康資料直接儲存到 iCloud 雲碟。設定簡單，無需驗證。
指南： iCloud 雲碟自動化指南
行事曆
根據健康資料建立行事曆事件。在行事曆中檢視運動、健康里程碑等。
指南： 行事曆自動化指南
建立第一個自動化
- 從主導覽進入「自動匯出」畫面
- 點一下「新增自動化」
- 選擇自動化類型
- 設定該類型專屬選項（見各指南）
- 設定通用選項（資料類型、同步頻率等）
- 點一下「更新」儲存
- 啟用自動化
備份與還原自動化
Health Auto Export 可將自動化設定備份到 iCloud 雲碟，以便在新裝置上或重新安裝 App 後還原。這與自動化匯出的健康資料是分開的。
- 備份位置： 自動化設定以 JSON 檔案儲存在 iCloud 雲碟的 Auto Export/Automations 資料夾中（可在「檔案」App 中查看）。
- 備份時機： 每次儲存自動化（點一下更新或離開編輯畫面）時，該自動化會自動備份。
- 開啟或關閉： 開啟自動化清單，進入自動化設定，然後使用備份到 iCloud 雲碟。預設為開啟。若關閉，系統會詢問是否刪除 iCloud 雲碟中的現有備份檔案；無論哪種情況，自動化都會保留在裝置上。
還原
若開啟「自動匯出」時尚無自動化，但 iCloud 雲碟中有可用備份，會顯示從 iCloud 雲碟還原按鈕。點一下即可還原自動化。
還原後須知：
- 重新連接帳戶： 為保護隱私，Dropbox、Google 雲端硬碟等服務的登入權杖不會包含在備份中。還原後請在每個自動化中重新連接這些服務。
- 重新啟用自動化： 還原的自動化預設停用，避免使用過時設定意外執行。請逐一檢查並在準備好後啟用。
- 部分還原： 若部分自動化無法還原（例如檔案尚未下載、加密金鑰尚不可用，或由較新版本 App 建立），其餘仍會還原，並會顯示略過的項目。
注意：您在自動化中輸入的請求標頭與憑證（如 MQTT 密碼）在 iCloud 雲碟備份檔案中會加密儲存。在新裝置上還原需要 iCloud 鑰匙圈，以便 App 解密。手動分享/匯出的檔案仍為未加密的純 JSON。
活動記錄
每個自動化都有用於執行紀錄的活動記錄。
- 開啟自動化，點一下檢視活動記錄。
- 事件依執行分組（最新執行在上）。展開某次執行可檢視各事件。
- 警告（例如健康資料查詢較慢）表示執行已完成，但某步驟耗時超出預期。錯誤表示某步驟失敗（上傳、HealthKit 讀取、驗證等）。
- 清除（工具列）僅刪除該自動化的活動紀錄，不會刪除 App 範圍的診斷記錄。
- 分享（工具列）匯出完整的 App 事件記錄診斷 ZIP，與設定 → 進階 → 匯出事件記錄相同。參閱 App 事件記錄指南。
活動記錄中的慢查詢
- 若取得健康資料耗時較長，活動記錄可能顯示健康資料查詢較慢警告（非錯誤）。
- 加快執行：選擇更少健康指標、縮短日期範圍、開啟彙總資料、選擇更大的時間分組（小時、天或週）。
- 即時自動化設計上使用更細的分組，可能更常出現慢查詢警告。
匯出設定警告
設定健康指標自動化（非 Home Assistant）時，若設定可能較慢，匯出設定下方可能出現頁尾：
- 彙總資料已關閉，或時間分組為分鐘或秒，且
- 已選擇超過 10 個健康指標
頁尾建議減少指標、縮短日期範圍、開啟彙總資料或採用更粗的時間分組，並連結到本指南。慢查詢警告在活動記錄中單獨顯示，於執行後查詢超過閾值時出現。
最佳實務
- 自動同步：
- 為裝置充電並使用 iPhone 鏡像輸出
- 充電時 iOS 對效能限制較少，資料可更頻繁同步
- 使用 iPhone 鏡像輸出時，裝置行為與解鎖時相同，Health Auto Export 可存取健康資料以執行自動化
- 同步頻率：
- 在資料新鮮度與資源使用之間取得平衡
- 多數情境每日同步即可
- 即時需求可提高頻率
- 彙總資料可降低頻率
- 資料選擇：
- 僅選擇需要的指標
- 減少處理時間與資料量
- 可為不同指標群組設定單獨自動化
- 測試：
- 執行手動匯出
- 確認目的地出現資料
- 在活動記錄中查看錯誤
- 密切關注初始同步
- 監控：
- 定期查看活動記錄
- 檢查自動化狀態指示
- 為重要自動化設定通知
- 在目的地確認已收到資料
- 安全：
- 使用安全的驗證方式
- 保持憑證最新
- 可用時使用 HTTPS/TLS
- 檢查隱私設定
- 效能：
- 使用合適的時間分組
- 考慮雲端儲存的日期範圍設定
- 監控電量與資料用量
- 在活動記錄中查看慢查詢警告
- 備份策略：
- 使用多種自動化類型實現冗餘
- 將雲端儲存與 API 整合結合
- 盡可能保留本機備份
- 測試還原流程
- 疑難排解：
- 先查看活動記錄
- 檢查網路連線
- 檢查驗證憑證
- 查閱各自動化指南中的具體問題
自動化小工具
將「自動化」小工具加入主畫面即可：
- 一目了然地查看自動化狀態
- 手動觸發自動化
- 最佳化背景上傳
取得協助
若需要特定自動化類型的協助：
- 查閱對應的自動化指南
- 在活動記錄中查看錯誤訊息
- 閱讀疑難排解章節
- 若問題仍存在，請聯絡支援