Blender Campus Toolkit

扬飞创智园区 Blender 场景构建与 Three.js 预览项目。

本仓库用于沉淀园区数字孪生相关的 Blender 自动化脚本、区域辅助工具、模型生成记录，以及面向 Web 的 Three.js 预览工程。当前重点资产是 yangfei_chuangzhi_reference_model.glb 对应的园区模型和 yangfei-campus-threejs 交互式园区查看器。

项目内容

• *.py：Blender 场景生成、局部调整、模型验证和批量处理脚本。
• campus_tools.py：Blender 插件，用于在视图中导出选中区域的世界坐标，便于后续按区域生成或调整模型。
• yangfei-campus-threejs/：React + Vite + Three.js 园区查看器，包含模型加载、摄像头点位识别、设备信息面板和视频弹窗能力。
• threejs-viewer/、room-threejs-preview/ 等目录：较早期的 Three.js 预览实验工程。
• tools/：模型转换和辅助工具。

运行 Three.js 园区预览

进入主预览工程：

cd yangfei-campus-threejs
npm install
npm run dev

默认开发服务端口是 5178。

主工程会在启动前执行：

npm run sync:assets

该命令会把根目录的 yangfei_chuangzhi_reference_model.glb 同步到 yangfei-campus-threejs/public/models/，并同步 Jessibuca 播放器资源。

环境变量

参考 yangfei-campus-threejs/.env.example：

VITE_API_BASE_URL=http://localhost:3000/api
VITE_CAMPUS_MODEL_URL=/models/yangfei_chuangzhi_reference_model.glb
VITE_DEVICE_API_BASE_URL=/device-api
VITE_JESSIBUCA_SCRIPT_URL=/vendor/jessibuca/jessibuca.js
VITE_JESSIBUCA_DECODER_URL=/vendor/jessibuca/decoder.js

如模型文件不放在默认位置，可以通过 VITE_CAMPUS_MODEL_URL 指向外部静态资源地址。

Blender 脚本使用

大部分根目录 Python 脚本需要在 Blender Python 环境中运行，通常用于：

• 添加或调整园区建筑、绿化、道路、标识和监控点位。
• 基于指定区域生成局部模型元素。
• 导出或验证 GLB/Blend 资产。

campus_tools.py 可作为 Blender 插件安装，安装后在 3D 视图侧边栏的 Campus 面板中使用“复制选中区域坐标”。

大文件与生成物

仓库根目录存在大量 .blend、.glb、图片、日志和视频输出。首次 Git 提交默认排除了这些生成物和大文件，避免触发 GitHub 单文件限制或让仓库体积失控。

需要共享正式模型或宣传视频时，建议使用以下方式之一：

• GitHub Releases。
• 对象存储或静态文件服务器。
• Git LFS，并提前确认组织的 LFS 配额。

常用命令

# 启动园区 Web 预览
cd yangfei-campus-threejs
npm run dev

# 构建园区 Web 预览
npm run build

# 仅同步模型与播放器资源
npm run sync:assets