SuperAPI AI 工具集

blender-web-3d

设计与创作

查看项目

更新于 10-16 05:04

技能介绍

该技能提供一条从 Blender 到 Web 3D 的发布管线:用脚本化、可复现的 Blender 编辑构建模型,优化为小型 GLB,再由 Three.js 查看器展示。整个循环可无头运行,每次改动都是可审阅脚本,状态为版本化文件,结果通过渲染图验证。

资料附带起始资产:assets/blender 内含 demo_station.py(程序化参考模型)、render_beauty.py(EEVEE/Cycles 渲染装置)、export_glb.py(原始 GLB 导出);assets/viewer 为 Vite + three r186 模板,含 optimize-glb.mjs 与 viewer.js、quality.js、batching.js、shaders 等。新项目可复制 viewer 到应用中,将模型指向自己的 GLB,并按名称键配置选项。Blender 材质与轴心命名是模型与查看器之间的约定(如 Hull、Window、Solar、Beacon、Pivot 等)。

驱动 Blender 有两种方式:默认无头 CLI(blender --background file.blend --python script.py -- args),可复现、可版本化、适合 CI;Blender MCP(社区 BlenderMCP 插件 + uvx blender-mcp)仅在实时 GUI 会话中有效,在 --background 下不工作,适合用户观看视口时实时迭代。脚本需同时兼容两种模式:基于 bpy.data.filepath 做判断,避免需要 3D 视图上下文的 operator,并保持幂等。

迭代循环:复制前版本为下一版本,不编辑旧版本;编写版本化编辑脚本,先读 references/blender-scripting.md;无头运行并自校验输出 JSON 报告;用 render_beauty.py 渲染 2-3 个视图并查看 PNG 验证几何;导出原始 GLB 后经 optimize-glb.mjs 优化,参考 export-pipeline.md 的陷阱清单;在应用中以像素验证,通过 ?debug 暴露 window.__viewer,用 __viewer.frame(n) 与 canvas.toDataURL() 截图,检查主视图与近景;文档或营销用的精修渲染用 CYCLES,可部署(npx vercel deploy --prod --yes)。

参考资料包括 scripting、export-pipeline、lookdev-and-shaders、performance、threejs-viewer、baked-lighting 等文件,应分阶段阅读。设计要点:封闭体积优于骨架结构;所有部件应附着,避免孤立几何;细节按相机尺度分配;按区域区分光源特征;单一太阳驱动主光、天空圆盘、IBL 与行星明暗分界;三种节奏的生命感(慢旋转、中频闪光、偶发闪烁)。用户报告视觉 bug 时,先用无头探测脚本定位对象,再改脚本重渲染同一视图对比,或在浏览器中逐项开关场景特征定位。其余未在资料中提供的价格、平台支持范围等信息暂未提供。