Files
Astral3D/Astral3D/README.md
lyf cda4999325 完善项目文档和SDK功能
- 更新 README 文档和许可证文件
- 完善编辑器使用手册,包括BIM浏览、CAD查看等功能说明
- 更新文档配置和首页内容
- 优化编辑器环境配置
- 完善 WebSocket 通信和 API 接口
- 增强 glTF 处理器和点云重建功能
- 优化 SDK 核心模块:
  - 更新 App 和 Config 配置
  - 添加 Billboard、HtmlPanel 等对象支持
  - 完善粒子系统和天气效果
  - 优化相机管理和漫游工具
  - 改进材质着色器效果
- 更新服务层 README 文档

Made-with: Cursor
2026-03-14 00:26:51 +08:00

2.6 KiB
Raw Blame History

NeonVision 3D Editor

简体中文 | English

概述

NeonVision 3D Editor美术馆数字驾驶舱是一款专业的 Web 端三维场景编辑器,基于 WebGL/Three.js 技术构建支持多格式三维模型导入、场景编辑、动画制作、BIM/CAD 解析等专业功能。

核心功能

  • 多格式支持:支持 GLTF、GLB、OBJ、FBX、RVT、IFC 等 30+ 三维模型格式
  • BIM 模型轻量化:支持 Revit(RVT) 和 IFC 格式的轻量化展示
  • CAD 图纸解析:支持 DWG/DXF 格式的二维图纸解析与三维联动
  • 场景分包存储:支持场景分包打包、增量加载,提升大规模场景性能
  • 动画编辑器:支持关键帧动画、时间轴编辑、骨骼动画
  • 实时预览:即时渲染预览,所见即所得

扩展能力

  • 插件系统:支持插件扩展,满足定制化需求
  • 脚本运行时:支持 JavaScript 脚本注入,实现业务逻辑
  • 粒子系统:丰富的粒子效果编辑器
  • 天气系统:雾、雨、雪等天气效果模拟
  • 云存储集成:支持本地存储和又拍云对象存储
  • 资源中心:统一资产管理,支持模型、材质、纹理等

技术栈

类别 技术
前端框架 Vue 3.5+ / Vue Router / Pinia
3D 引擎 Three.js r176+
GIS 引擎 Cesium 1.107+
UI 组件库 Naive UI
CSS 框架 UnoCSS / Tailwind CSS
构建工具 Vite
编辑器 Monaco Editor

项目结构

Astral3D/
├── packages/
│   ├── editor/          # Web 编辑器
│   ├── sdk/             # 3D 引擎 SDK
│   ├── examples/       # 示例项目
│   └── docs/           # 文档站点
├── common/             # 公共构建配置
└── astral-service/     # 后端服务 (Java/SpringBoot)

快速开始

前置需求

  • Node.js ≥ 23.0.0
  • PNPM ≥ 10.8.1
  • Java 8+ (后端服务)
  • MySQL 5.7+ (后端服务)

本地运行

# 克隆项目
git clone http://code-server:3000/lyf/Astral3D.git
cd Astral3D

# 安装依赖
pnpm install

# 构建 SDK
pnpm run sdk:build

# 启动开发服务器
pnpm run editor:dev

访问 http://localhost:5173

生产构建

pnpm run editor:build

后端服务(可选)

# 进入后端目录
cd ../astral-service

# 配置数据库
# 修改 astral-web/src/main/resources/application-dev.yml

# 启动服务
mvn spring-boot:run

许可协议

基于 Apache 2.0 许可证开源。

贡献指南

欢迎提交 Issue 和 Pull Request。