# @buoy-gg/three 中文文档

规范地址：https://npmcn.com/package/%40buoy-gg/three/

版本：7\.0\.87
npm 元数据更新时间：2026-11-07T01:58:16.841Z
中文译文更新时间：2026-11-08T20:17:47.935Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40buoy-gg/three
原文对照：https://npmcn.com/package/%40buoy-gg/three/?lang=original
项目主页：https://buoy.gg/buoy/latest/docs/tools/three
源码仓库：https://github.com/LovesWorking/react-native-buoy

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：61.8 kB，23 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react \*，three \>=0\.170\.0
- 首次发布：2026-10-09T13:23:42.696Z
- 最新版本发布：2026-11-07T01:58:16.650Z
- 近 30 天下载量：3972（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

参见并编辑了"三.j"一幕.

## 安装

```sh
npm install @buoy-gg/three
```

也可以使用：`pnpm add @buoy-gg/three`、`yarn add @buoy-gg/three`、`bun add @buoy-gg/three`

## README

* * *

## 标题: 场景 (Beta) 说明:见并编辑一个 3.js 场景.

# 场景 (Beta)

在您的 3D 应用程序中看到对象树 。 选个节点来画一个盒子 藏取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 你可以改变网状的颜色.

## 准备好了

三.j支持在贝塔. 使用 `beta` 船一开就挂了. 保持所有Buoy包在同一β放出上. 安装 `@buoy-gg/three@beta` 与 `three` 在你的网络应用程序。 将其模块添加到Buoy的 `modules` 地图.

```tsx
import * as threeTools from '@buoy-gg/three/web';
import * as perfMonitor from '@buoy-gg/perf-monitor/web';
import * as assets from '@buoy-gg/assets/web';
import * as events from '@buoy-gg/events/web';
import { registerThree } from '@buoy-gg/three/web';

const modules = { three: threeTools, 'perf-monitor': perfMonitor, assets, events };
// Add these modules to your FloatingDevTools or mountBuoy options.
const stop = registerThree({ renderer, scene, camera, loadingManager });
// Call stop() when the scene is replaced or torn down.
```

打电话 `stop()` 热重装也。 每个渲染器都有自己的组. 在 R3F 中,请使用 `useThree()`。通过 `gl` 作为 `renderer`返回时 `stop` 从效果.

早期的靴子钩可以找到场景和渲染器. 它无法分辨哪些人属于一起。 使用 `registerThree` 联系他们 装入 `@buoy-gg/core/web/register` 三.j之前,如 [网络指南](https://buoy.gg/buoy/latest/docs/web/three)。 。 。 .

## 计数和负载

Perf 监视器显示在应用程序制作后数 。 WebGL和WebGPU有不同的字段. 无数据的字段显示为未知 。 计数是对象,不是字节. 一个不断上升的点数说"不断增长". 缓存也能引起这种情况.

Buoy 不重设计数或更改 `autoReset`数数跟随你的重设规则 没有新的渲染, 最后一个数留在屏幕上.

资产与事件显示文件负载. 麻烦表 `DefaultLoadingManager`通过自定义管理器到 `registerThree` 看着它。 大小和时间来自浏览器的资源时间. 如果数据缺失,则数据不为人知。 缓存点击显示当缓存或浏览器证明击中时 .

## 场景编辑

每棵树最多有500个节点. 长名被删. 面板告诉你,当它到达节点极限。 转换值使用弧度. 输入一个动作、转动或大小的3个数字。 颜色使用六位数十六进制, 如 `#ff8800`。 。 。 .

每个领域都需要一个价值。 Live 更改保留您的草稿直到您按下 Save .

一个盒子标记了选取的节点的界限 在你选的时候。 用"清箱"来清除. App代码可能覆盖其下帧的编辑.

桌面使用同样的面板 。 MCP已经 `get_three_scene`, (中文(简体) ), `get_three_stats`,以及 `three_action`. MCP需要付费账户. 先读出场景才能得到ID进行编辑.

不支持工人和WebXR. 做为全屏,用包装布围住画布. 光帆布无法显示Buoy的 DOM 面板 .

## 常见问题

### @buoy-gg/three 是什么？

参见并编辑了"三\.j"一幕\.

### 如何安装 @buoy-gg/three？

在项目目录运行 npm install @buoy-gg/three，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、three（\>=0\.170\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @buoy-gg/three 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @buoy-gg/three 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @buoy-gg/three 可以商用吗？

@buoy-gg/three 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @buoy-gg/three 的下载量有多少？

根据 npm 官方下载统计，@buoy-gg/three 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,972 次，日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @buoy-gg/three 还在维护吗？

最新版本 7\.0\.87 发布于 2026/11/07（1 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 25 个；首次发布于 2026/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。