如何基于 three.js 编辑器做二次开发

本文围绕three.js 编辑器（一款基于 Three.js 的 AI 驱动可视化低代码编辑器）展开。

- 🌐 在线预览： https://z2586300277.github.io/threejs-editor/

- 📦 GitHub 开源仓库： https://github.com/z2586300277/three-editor

- 📚 文档地址： https://z2586300277.github.io/three-editor/docs/dist

three.js 编辑器不仅是一个可在线使用的 3D 场景工具，更是一套可嵌入、可扩展、可私有化的工程底座。对于希望快速拥有数字孪生、可视化组态或 3D 配置能力的企业与开发者来说，基于它做二次开发能显著降低从 0 到 1 的成本，同时保留足够的业务定制空间。

一、为什么要基于 three.js 编辑器二次开发

传统 Three.js 项目需要自行处理渲染器、相机、控制器、事件、资源加载与场景序列化，而 three.js 编辑器已经把这些通用能力沉淀到three-edit-cores。二次开发时，开发者只需关注业务组件与行业场景，把重复工作交给内核。更重要的是，编辑器内置了 AI 协同能力，能够把自然语言转化为场景操作，进一步提升开发效率。

二、起步：引用 three-edit-cores

最轻量的集成方式是将three-edit-cores作为 npm 依赖引入到现有 Vue3、React 或原生工程中，替换默认的src/editor/lib.js导出。通过暴露的ThreeEditor类即可在自己的容器内初始化画布。对于不想携带完整 Vue 外壳的项目，这种方案可以把核心 3D 能力压缩到最小。

三、扩展组件：compoents 约定

src/editor/compoents/下的每个组件都遵循同一套接口：name、label、initParameters、create(storage)、createPanel(group, folder)。新增业务组件时，只需要创建一份 JS 文件并按约定实现方法，编辑器左侧资源面板与右侧属性面板会自动识别。这种插件机制让团队可以像搭积木一样扩展光效、粒子、图表、动画等行业元素。

四、定制面板与快捷键

通过监听emitThreeEditor事件拿到threeEditor实例后，可以挂载自定义 Vue 面板、注册新的快捷键行为，或者替换顶部工具栏。内核提供的handler、transformControls、modelCores、lightCores等对象几乎覆盖了所有交互入口，业务层可以在不改动内核的情况下完成深度定制。

五、AI 工作流接入

编辑器 AI 模块已经封装好动作注册与调用机制。二次开发时，只需在src/editor/ai/core.js中新增EDITOR_ACTIONS描述，并在运行时实现对应函数，即可让大模型用自然语言操作你的自定义组件。这意味着行业专家无需编写代码，也能通过对话完成初步场景搭建。

六、私有化部署建议

在企业落地时，建议把 AI 请求走后端代理，避免前端直接暴露大模型 API Key。场景 JSON 与模型资源可以存放在企业私有对象存储或内部 CDN，通过权限网关控制访问。同时关闭或替换默认的统计分析脚本，确保数据不出域。

七、典型落地场景

基于 three.js 编辑器的二次开发已经在多个场景中验证其价值：智慧园区的 3D 大屏、工业设备的数字孪生运维、电商商品的 3D 配置器、教育行业的虚拟实验室等。这些场景共同的特点是：需要快速搭建 3D 场景、需要与业务数据联动、需要非专业用户也能参与编辑。

代码一瞥

// src/editor/ai/chat.js
export function mountSceneAI(threeEditor) { window.sceneAI = { list: () => listObjects(threeEditor), getSettings: () => getEditorSettings(threeEditor), run: (action, params) => runEditorAction(threeEditor, { action, params: params || {} }), openPanel: (panel) => openEditorPanel(threeEditor, typeof panel === 'string' ? { panel } : panel || {}), } }

结语

基于 three.js 编辑器二次开发的核心思路是「复用内核、替换外壳、扩展组件、接入 AI」。无论你想搭建私有云数字孪生平台，还是想为现有 SaaS 增加 3D 配置能力，这套架构都能让研发投入更聚焦在业务价值上，而不是重复建设底层引擎。