Buoy-gg/buoy

Buoy – 应用内开发者工具

它是什么 – Buoy 是一个添加到 React Native、Expo、Flutter、Capacitor/Ionic 或 Three.js 应用中的库。它注入一个浮动菜单，让你在应用运行时检查和修改应用：网络请求、存储、状态缓存、导航、渲染性能、3D 场景等。

主要功能

• 实时检查网络调用、异步存储、React-Query/Zustand/Redux 缓存、路由和组件渲染。
• 即时编辑 – 更改请求负载、强制错误或加载状态、回退时间、编辑环境变量、模拟用户、切换权限等。
• 工具生态系统 – 一个核心包（@buoy-gg/core）加上可选插件，如 @buoy-gg/network、@buoy-gg/react-query、@buoy-gg/ask-buoy、@buoy-gg/scene 等。只安装你需要的工具。
• 跨设备同步 – 将应用内菜单链接到 Buoy Desktop 或 MCP 服务器，以便从桌面 UI 或 AI 驱动的编辑器控制应用。
• 平台支持 – 原生 React Native/Expo、Flutter（通过其自己的设置）、Capacitor/Ionic（测试版）和 Web/Three.js（测试版）以及 3D “场景”编辑器。

如何开始

1. 安装核心包和至少一个工具，例如

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

2. 按照快速入门指南在应用中挂载浮动菜单并加载你的 Buoy API 密钥。
3. 根据需要添加其他工具（存储、时间机器、react-query 等）。
4. 运行开发构建；免费的 Buoy 账户提供基本的 MCP 同步，而 Pro 解锁完整的服务器功能。

适用对象 – 移动和 Web 开发者，他们希望在实际运行的应用中获得类似 Chrome DevTools 的体验，尤其是在调试难以从外部复现的网络/状态问题时。

许可证 – 专有（Buoy LLC）。该仓库是产品的开源前端；使用需要 Buoy 账户，并且可能需要付费计划才能用于生产部署。