OpenVGAL Vibe 项目

项目简介

OpenVGAL 是一个基于 Babylon.js 的开源 3D 虚拟美术馆平台，当前版本 v4.3.6，MIT 协议，GitHub 53 星。它要解决的问题很具体：把一堆图片文件夹变成可以在浏览器里行走参观的 WebGL 展厅，不需要 3D 建模技能、不需要展厅设计经验、也不需要写前端代码。项目由摄影师兼生成艺术家 LB（nostromophoto.com 作者）在 2022 年 6 月作为个人项目启动，历经四个大版本：v1 要求 Python 和手动配置，v2 引入可执行文件与 Electron 应用降低门槛，v3 把一切搬进浏览器，v4 则带来全新的光照系统。作者把产品哲学写得很清楚——你拥有自己的画廊：输出是纯 HTML 加 JS 文件，没有锁定、没有订阅、没有追踪，放到任何一台 Web 服务器上就能直接跑。开源之外另有一项可选的付费托管服务，不使用它也不影响任何功能。

核心功能

• 浏览器生成器：打开 openvgal.com/create，把图片文件夹拖进去（一个文件夹对应一个展厅房间），点击 Build Gallery 即可在 3D 视图里实时预览，再点 Download ZIP 拿到成品。
• 自包含 ZIP 输出：压缩包内含图片、3D 房间模板、PBR 材质、查看器与配置文件，解压到任意 Web 服务器打开 viewer.html 即可，不依赖外部 CDN、不发任何外部请求；另有 CDN-first 瘦包模式，模板与查看器运行时从 cdn.openvgal.com 加载，体积更小且能自动跟进查看器更新。
• 多种展厅风格：Classic、Minimalist、Dark 三种风格各自配成套模板与光照，v4.3 又新增 School 与 Warm 两种，生成器里可逐个切换挑选。
• 作品定制与真实尺寸：下载前可在 Customize 页面编辑每件作品的标题、副标题，用 S/M/L 档位或自由滑块（厘米或英寸，上限 250 cm）调整尺寸；尺寸以真实厘米写进 building_v2.json，访客看到的就是你设定的大小。
• 展厅级体验组件：画廊地图（房间卡片带缩略图、点击跳转）、博物馆式作品铭牌（标题与副标题，可开关）、自动导览，以及可替换的自定义 logo（materials/logo.png，建议 1024x512 白图黑底）。

技术实现

OpenVGAL 用一个 building_v2.json 描述互相连通的展厅房间，每个房间引用一个 GLB 模板，并包含作品与门两类条目。加载时查看器读取模板、套用 Babylon.js 节点材质、把作品贴图摆到计算好的坐标上，再通过门网格在房间之间导航。作品排布由模板 GLB 中烘焙的 Occupancy 平面决定：每面墙或面板对应一个平面，标注可用条带的中心、法线与宽度，生成器据此按宽度做适配、按密度做均衡铺排，超出容量时自动溢出到下一个房间，因此新增房间只需改 Blender 模板和 catalog.json，不必动一行 JavaScript。光照是 v4 的重头戏——模板加载时，查看器把射灯、面光源、半球环境光与柔和接触阴影一次性烘焙进每个表面的专用 lightmap 通道，随后关闭运行时灯光，灯泡只作为场景装饰物保留；烘焙结果比旧版实时灯具更柔和也更扎实，而且因为只算一次，非游戏级硬件同样跑得动。模板带专用 lightmap UV 通道校验，检测到陈旧或损坏的模板会直接拒绝渲染，避免出现半个坏房间；从完整 GLB 资源加载的自包含画廊则原样渲染，不参与运行时烘焙。工程结构上，site/ 是主应用（落地页、查看器、生成器、编辑器），cdn/ 存放 GLB 模板、catalog.json 与节点材质，Python 命令行版本仍保留在 GitHub Releases 中供偏好终端的用户使用。

快速上手

1. 把图片按展厅房间整理成文件夹，一个文件夹对应一个房间，单个文件夹内不建议堆几百张图。
2. 打开 openvgal.com/create 进入浏览器生成器；本地跑源码则进入仓库的 site/ 目录。
3. 把文件夹拖进生成器，点击 Build Gallery，在 3D 视图里预览效果。
4. 点击 Customize 微调作品标题、副标题与尺寸，然后点击 Download ZIP。
5. 把 ZIP 解压到任意 Web 服务器并打开 viewer.html；本地开发执行 python -m http.server 8000 --directory site 后访问 localhost:8000（file:// 协议在 Chrome 下不可用）。

适用人群

数字艺术家与摄影师，可以把作品集做成可漫游的线上展览；画廊与美术馆机构，用于举办线上分展；艺术院校与毕业展学生，低成本搭建线上展厅；收藏者与策展人，用于整理与分享藏品；以及希望给客户交付永久链接的创意工作者。托管服务是可选项，不开源之外的收费功能并不存在，所有能力都能免费自托管获得。

出品方与开源

出品方是 LB（GitHub 用户 lbartworks），nostromophoto.com 的摄影师与生成艺术家，项目自 2022 年 6 月起持续维护，靠 GitHub Sponsors 赞助支撑开发。仓库 github.com/lbartworks/openvgal 目前 53 星、14 fork、MIT 协议，主要语言 JavaScript，最近一次提交为 2026 年 10 月 7 日；官方主页 openvgal.com 同时提供在线生成器与可选托管服务。

更新动态

v4.3（2026 年 9 月）：新增 School 与 Warm 两种展厅风格；风格选择器改为单个展示，支持箭头、滑动与点击风格名跳转；超过 1600 像素的大图可一键缩放，并按原格式重新编码以去掉元数据。v4 系列：引入烘焙光照与烘焙模板校验，v4 之前的旧画廊需用新版生成器重建。v3 系列：Occupancy 驱动布局、单一 catalog.json、真实厘米尺寸、浏览器内生成器、自包含 ZIP 与 CDN-first 双模式。

官网与链接

项目主页：github.com/lbartworks/openvgal；在线生成器：openvgal.com/create；可选托管服务：openvgal.com；在线演示：nostromophoto.com/virtual/virtual.html。