App 事件記錄指南
匯出診斷用 App 事件記錄，以排解自動化與匯出問題。
Last updated: May 20, 2026
本頁內容
App 事件記錄指南
當自動化或匯出未如預期運作時，App 事件記錄有助於排解問題。你可以從 App 匯出記錄並分享俾支援團隊調查。
活動記錄與 App 事件記錄
活動記錄係單一自動化嘅使用者可見執行歷史。從自動化嘅設定畫面（檢視活動記錄）開啟。按時間分組顯示執行，以及只屬於該自動化嘅資訊、警告同錯誤事件。你喺 App 內檢視；按自動化分別儲存。
App 事件記錄係成個 App 嘅技術診斷記錄（自動化、手動匯出、HealthKit 查詢、上傳及相關流程）。以 JSONL 儲存，並作為 ZIP 匯出俾支援使用。匯出 App 事件記錄唔可以取代喺 App 內閱讀活動記錄——回報問題時請同時使用兩者。
App 事件記錄包含嘅內容
App 事件記錄包含由 App 流程產生嘅診斷事件，例如：
- 自動化執行
- 手動匯出
- 伺服器活動
- 匯出處理與驗證錯誤
- HealthKit 查詢與上傳診斷
匯出嘅 ZIP 用於故障排除。可能包含時間戳記、事件名稱，以及非健康類診斷內容。套件仲可能包含：
- 含 App 與環境中繼資料嘅 manifest
- 經編輯嘅 automations 快照（設定中唔含憑證或密鑰）
- 用於購買支援診斷嘅 IAP 原始安裝與 grandfathering 欄位
匯出嘅記錄唔包含原始 HealthKit 樣本或你嘅健康資料值。
匯出位置
有三種方式可以匯出診斷記錄。請按所需詳細程度選擇。
完整診斷 ZIP（建議用於聊天支援）
完整套件包含 App 範圍嘅 events.jsonl（若存在則含輪替區塊）、manifest.json，以及編輯過嘅 automations.json。
可以從以下任一位置匯出：
- 設定 → 進階 → Export Event Logs
- 自動化 → 檢視活動記錄 → 分享（工具列）— 匯出與「進階」相同嘅完整 ZIP，而唔係只針對單一自動化嘅檔案
透過郵件、AirDrop 或其他分享目標分享 ZIP。
僅自動化網域記錄
Automation Settings → Export Automation Logs 只會從 App 事件記錄匯出與自動化相關嘅列（按子系統篩選）。當你需要較細、以自動化為主嘅套件時使用。大多數支援個案請改用「進階」或活動記錄分享入面嘅完整診斷 ZIP。
幾時匯出 App 事件記錄
喺能夠重現問題時匯出記錄，例如：
- 自動化執行唔穩定
- 向雲端目標重複上傳失敗
- 非預期嘅匯出失敗
- 無法解釋嘅伺服器連線行為
- 自動化執行緩慢（亦請查看活動記錄入面嘅慢查詢警告）
點樣匯出 App 事件記錄（逐步說明）
完整診斷 ZIP：
- 開啟 Health Auto Export。
- 前往 設定 → 進階 → Export Event Logs，或者開啟某個自動化 → 檢視活動記錄 → 喺工具列點按分享。
- 透過郵件、AirDrop 或其他分享目標分享產生嘅 ZIP。
僅自動化網域：
- 開啟 Automation Settings（從自動化區域）。
- 點按 Export Automation Logs。
- 分享產生嘅 ZIP。
分享記錄之前
請喺匯出記錄時一併提供以下資訊：
- 你預期發生嘅情況
- 實際發生嘅情況
- 問題發生嘅大致時間
- 涉及嘅自動化或匯出類型
- iOS 版本與裝置型號
- 喺相關時，受影響自動化嘅活動記錄螢幕截圖
呢啲背景有助支援將你嘅回報同匯出嘅事件對應起來。