@buoy-gg/three

中文文档
7.0.87发布于 2026/11/07TypeScriptESM + CJS近 30 天下载 3972

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

中文使用文档
文档目录4 节
  1. 标题: 场景 (Beta) 说明:见并编辑一个 3.js 场景.
  2. 准备好了
  3. 计数和负载
  4. 场景编辑

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

场景 (Beta)

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

准备好了

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

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之前,如 网络指南。 。 。 .

计数和负载

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 共发布 25 个版本,首次发布于 2026/10/09;过去 12 个月发布了 25 个版本。

版本发布日期距今
7.0.87latest2026/11/071 天前
7.0.862026/11/062 天前
7.0.852026/11/053 天前
7.0.842026/11/035 天前
7.0.832026/11/035 天前
7.0.822026/11/036 天前

关于 @buoy-gg/three 的常见问题

@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 和提交记录判断。