eas-observe

EAS Observe

EAS 服务需付费。 EAS Observe 是 Expo Application Services 的产品。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() hook 或 <ObserveInteractiveMarker />）、通过 Expo Router / React Navigation 集成添加可选的逐路由导航指标、通过 Observe.logEvent（SDK 56+）记录用户定义的事件、错误报告和运行时配置（采样、分发、环境、自定义端点）。
• 从终端查询指标 → ./references/queries.md。eas observe:* 命令——metrics-summary、metrics、routes、events、session、versions、errors、event——以及对应的标志、指标别名、表格布局、JSON 结构和常见工作流。还介绍 Expo MCP Server 中对应的 observe_* 工具，以及它们的输入与 CLI 标志的差异。
• 查看仪表板或 CLI 输出 → ./references/metrics.md。各项指标的目标阈值、自动 TTI 参数（frameRate.*、device.*、network.*）的含义，以及用于区分启动缓慢但流畅、主线程争用、严重阻塞或设备降频的诊断模式。
• 报告库集成产生的问题 → ./references/library-integrations.md。当前和未来的集成会将库检测到的问题报告为事件或错误，文档介绍了它们的选项、限制以及如何查询报告。目前包括：expo-image（针对解码尺寸远超屏幕大小的图片生成 expo-image.oversized 事件）和 react-native-reanimated（生成 reanimated.error 错误，以及可选的 reanimated.warning 事件）。
• 在库中发布 Observe 集成 → ./references/third-party.md。仅适用于软件包作者（SDK 57+）：可选的 peer dependency、配置声明合并、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/
• 使用 Expo MCP Server 查询：https://docs.expo.dev/eas/observe/mcp/
• 指标参考：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/
• Expo Image 集成：https://docs.expo.dev/eas/observe/integrations/expo-image/
• Reanimated 集成：https://docs.expo.dev/eas/observe/integrations/react-native-reanimated/
• 用户自定义事件：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" "<actionable feedback>"

仅在有具体且可操作的反馈时提交。请尽可能提供相关背景信息。 如果 Agent 反复无法完成 Expo 任务，或用户不得不介入，请简要报告任务内容、预期结果以及问题所在，并使用 --category evals，同时将相关 Expo 包或命令作为 --subject。