buoy:基于 React Native 的设备端开发工具项目

Devtools that live in your React Native app. And answer to your agent. 25+ tools · desktop dashboard · MCP server for AI agents

分支1Tags18
文件最后提交记录最后更新时间
30 天前
7 天前
9 天前
9 个月前
16 天前
10 个月前
9 天前

Buoy。一套工具,服务每个团队。切换环境、以客户身份登录、强制触发错误或回退状态——就在正在运行的应用内完成。

驻留在应用内部的开发者工具。

buoy.gg  ·  文档  ·  快速开始  ·  桌面端  ·  定价

npm version npm downloads legacy downloads


Buoy 会在你的应用中嵌入一个悬浮菜单。通过它可以查看网络请求、存储和查询缓存,也可以检查状态管理、路由、渲染和性能表现,应用运行期间即可实时修改。你可以将同一会话连接到 Buoy Desktop 或 MCP,也可以直接在应用中使用 Ask Buoy。

Flutter 拥有针对调试构建的独立配置方案。 Capacitor / Ionic(Beta) 在 iOS 和 Android 上使用 Web 端工具。 Solid(Beta) 适用于使用 Vite 构建的 Solid 1.9 应用。 Vue 和 Nuxt(Beta) 适用于使用 Vite 构建的 Vue 3.3 及以上版本,以及 Nuxt 4。 Three.js(Beta) 支持 R3F 和原生应用。 使用 Scene 查看和编辑 3D 对象。

在 buoy.gg 上观看 Buoy 宣传片(1 分 50 秒)

快速开始

最快捷的方式就是让你的编码代理代劳。将下方的提示词粘贴到 Claude Code、Cursor 或 Codex 中即可。它会遵循 buoy.gg/install.md 的流程,安装核心模块以及与你依赖相匹配的工具,并告诉你如何在设备上验证。

代理安装提示词
Install Buoy, the in-app devtools for React Native and Expo, in this project.

Read the full instructions first:
  curl -fsSL https://buoy.gg/install.md
Read the raw text, not a summary. If curl is unavailable, use any HTTP tool you have. Ask me to paste the document only if nothing can fetch it.

Do the install yourself: inspect the repo, run the commands, edit the files. Do not hand me steps you can run.

Work out the routine decisions from the repo: package manager, which app to target, where the menu mounts, which Buoy tools match the dependencies already installed. If Buoy is already partly installed, repair and extend it; never add a second mount, provider, or package set.

When instructions conflict, follow this order: what I say here, then the document's rules about which packages exist and what needs my permission, then this project's own constraints, then the rest of the document, then your judgment.

Ask me before: adding a native dependency, opening a browser or creating an account, changing what a production build does beyond what the document specifies, or anything hard to undo. Do not commit.

You are not done when the packages install. Run this project's existing typecheck; add no tooling. Then report what you installed and why, what you skipped and why, every file you changed, what you verified, and the exact steps I take on the device to confirm the menu appears and captures a request.

如需手动安装,请从 core 和 Network tool 开始,然后登录:

npm install @buoy-gg/core @buoy-gg/network
npx --package=@buoy-gg/core buoy login

菜单挂载、密钥加载以及添加更多工具的操作,请参见快速入门。你需要一个开发版构建,以及免费或 Pro 版 Buoy 账户。

实际效果

每个工具在文档页面都配有一段短视频,基于真实应用录制而成。

Network tool film React Query tool film Ask Buoy film
查看、计时并覆盖请求 编辑缓存数据,强制切换加载与错误状态 内置于应用中的智能代理

工具

只需安装你的应用所需的部分。每个链接都指向对应的使用指南。

Network · Storage · Time Machine · Scenarios · Clock · Lifecycle · Location · Permissions · Ask Buoy · Env · React Query · Routes · Debug Borders · Highlight Updates · Bench · JS Top · Images · Scene (Beta) · Assets · Events · Console · Sentry · Redux · Zustand · Jotai · Impersonate · TV Remote · Focus Inspector · Camera · Overlay

超越设备边界

Buoy Desktop 在桌面面板中展示你已连接的工具,并支持在多台设备间自由切换。MCP server 让 AI 编辑器能够读取并修改正在运行的应用。免费账户可使用基础版 MCP,Pro 版则解锁完整 MCP。MCP 同时驱动 Sim Farm,为 Buoy Optimize 提供大量轻量级 iOS 模拟器或 Android 手机实例,让你的 agent 能同时尝试多种提速方案。Chrome Farm 在你的 Web 应用上并行运行多个轻量级 Chrome,让测试同步执行。Buoy Web 让你的 AI 替你操作 Chrome,执行真实点击——无需在应用中添加任何代码。Desktop 和 MCP 的应用工具需要在你的应用中引入 @buoy-gg/external-sync,连接方式详见桌面端指南。

Buoy 默认在开发构建中启用。若要在已发布的应用中开启,需要 Pro 版以及自定义的访问控制,操作前请先阅读组件参考。

反馈

发现了 bug,或者想要一个尚不存在的工具?提交 Issue。功能需求将决定我们下一步的构建方向。

许可证

专有软件。© Buoy LLC. 版权所有。详见服务条款。