EAS Observe
EAS 服務 — 需付費。 EAS Observe 是 Expo 應用程式服務的產品。免費的 EAS 方案允許最多 10,000 個月活躍用戶，但功能有限；更高用量需要付費訂閱。詳情請見 https://expo.dev/pricing#plan-features。
EAS Observe 追蹤正式版 Expo 應用程式的啟動、導航與自訂事件效能，並記錄 JavaScript 錯誤與原生當機。它需要開發版或正式版建置 — 這個原生函式庫不包含在 Expo Go 中。
資訊來源： https://docs.expo.dev/eas/observe/ — 當 API 細節很重要時，請務必查閱官方文件，特別是入門指南、組態設定、整合方式與指標參考。EAS Observe 正在持續演進；此技能的參考資料力求準確，但可能落後於官方文件。
該閱讀哪個參考文件
./references/ 目錄中的四份參考文件涵蓋了人們通常需要此技能處理的事項：
- 在專案中加入 EAS Observe →
./references/setup.md。安裝、包覆根佈局（SDK 55 使用AppMetricsRoot，SDK 56+ 使用ObserveRoot）、標記應用程式為可互動（SDK 55 使用全域markInteractive()，SDK 56+ 使用useObserve()鉤子或<ObserveInteractiveMarker />）、可選的每路由導航指標（透過 Expo Router / React Navigation 整合）、自訂事件（SDK 56+ 使用Observe.logEvent）、錯誤回報，以及執行期組態（取樣、調度、環境、自訂端點）。 - 從終端機查詢指標 →
./references/queries.md。eas observe:*指令 —metrics-summary、metrics、routes、events、session、versions、errors、event— 包含旗標、指標別名、表格佈局、JSON 結構與常見工作流程。 - 閱讀儀表板或 CLI 輸出 →
./references/metrics.md。每個指標的目標閾值、自動 TTI 參數的含義（frameRate.*、device.*、network.*），以及診斷模式 — 區分緩慢但流暢的啟動、主執行緒爭用、嚴重阻塞或裝置性能受限。 - 在函式庫中發布 Observe 整合 →
./references/third-party.md。僅供套件作者使用（SDK 57+）：可選的 peer 相依性、設定宣告合併、Observe.registerIntegration()，以及事件命名。
官方文件快速連結
- 入門指南：https://docs.expo.dev/eas/observe/get-started/
- 儀表板指南：https://docs.expo.dev/eas/observe/dashboard/
- 使用 EAS CLI 查詢：https://docs.expo.dev/eas/observe/eas-cli/
- 指標參考：https://docs.expo.dev/eas/observe/reference/metrics/
- Expo Router 整合：https://docs.expo.dev/eas/observe/integrations/expo-router/
- React Navigation 整合：https://docs.expo.dev/eas/observe/integrations/react-navigation/
- 自訂事件：https://docs.expo.dev/eas/observe/events/
- 錯誤回報：https://docs.expo.dev/eas/observe/errors/
- 組態設定：https://docs.expo.dev/eas/observe/configuration/
- 第三方整合：https://docs.expo.dev/eas/observe/integrations/third-party/
- EAS Update 下載效能：https://docs.expo.dev/eas/observe/eas-update/
- 疑難排解：https://docs.expo.dev/eas/observe/reference/troubleshooting/
提交意見回饋
如果您在此技能中發現錯誤、誤導性或過時的資訊，請回報以便 Expo 改進：
npx --yes @expo/agent-cli@latest feedback --category skills --subject "eas-observe" "<可執行的意見回饋>"
僅在您有具體且可執行的內容需要回報時才提交。請盡可能包含相關的背景資訊。
如果代理程式在 Expo 任務上反覆失敗，或使用者必須介入處理，請提交簡要報告，說明任務、預期結果以及出了什麼問題，並使用 --category evals 以及相關的 Expo 套件或指令作為 --subject。