Snap-O：Android 应用调试工具

项目简介

Snap-O 是一款 macOS 上的 Android 应用调试工具，用来检查运行中的 Android 应用：截图与录屏、查看网络流量、覆盖响应、实时修改应用内的数值。它围绕「实时预览」组织，连接设备或启动模拟器后 Live Preview 会自动启动。

主要功能

• 屏幕截图与录屏：在 Live Preview 中按住 Command 拖拽可分享截图，按 ⇧⌘V 开始或停止录制；录制可立即播放并逐帧查看动画。截图与录制保存在 Capture History（⌘Y）中，按日期浏览、可重新打开，也能直接拖进 pull request、聊天或文档。
• 网络检查：查看 HTTP 请求与响应、JSON body、Server-Sent Events 和 WebSocket 消息。设备端会缓存最近的流量，因此能查看打开工具之前发出的请求。被处理程序改写的请求标记为 Overwritten，原样返回上游的标记为 Watched，并可对比原始响应与应用实际收到的响应。
• Tweaks：无需重新构建或重启应用，即可修改 Compose、Views 及其他 Kotlin 代码中的数字、颜色、布尔值、字符串、枚举和贝塞尔曲线，或执行应用注册的动作。可通过 Tool 面板、可选的设备端面板、CLI 和 REST API 使用。
• CLI 与 Codex skill：Network 和 Tweaks 各自提供独立的 CLI 和面向 macOS / Linux 的 Codex skill，依赖 Python 3、Android Platform Tools 和对应的 Android 集成，使用时 macOS 应用无需运行。
• 插件：Android 应用可以打包工具插件，插件包含 Android 实现和可选前端，Snap-O 会在 Tool 面板中显示所选工具的前端。

安装与使用

需要 macOS 26 或更高版本，以及 Android Platform Tools 中的 adb。若尚未安装 adb，可通过 Android Studio 或 brew install android-platform-tools 安装。

1. 下载 Snap-O 并移动到「应用程序」。
2. 连接已开启 USB 调试的设备，或启动模拟器。
3. 打开 Snap-O，Live Preview 会自动启动。

屏幕截图无需在 Android 应用中集成任何库；Network 和 Tweaks 需要在应用中接入对应的 Android 集成，具体步骤见官方文档。

从源码构建需要 Xcode 26.4.1 或更高版本和 Android Platform Tools：克隆仓库后用 Xcode 打开 app-macos/Snap-O.xcodeproj 构建运行。构建 Android 工具前端时 Gradle 会下载 Node.js 与 npm。

注意事项

• Capture History 默认保留 30 天，存储上限 5 GB，可在 History Storage 中调整，或用 Save As…（⌘S）保存永久副本。
• 使用 CLI 或 Codex skill 时，macOS 应用不必处于运行状态。
• 项目按维护者时间维护，没有正式路线图，欢迎问题和小的补丁。

本作品整理自 GitHub 开源项目 openai/snap-o，原作者 @openai，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。