blender-threejs-product-skills：四个 Skill 把工程模型变成 Web 3D
blender-threejs-product-skills: Four Skills to Turn Engineering Models into Web-Ready 3D
CAD 工程模型导入 Blender 之后想跑进浏览器，通常要经历：几何体清理（CAD 面片混乱，布线不适合实时渲染）→ UV 展开 → 贴图烘焙 → Three.js 场景布光 → 导出 GLB。每一步都有坑，加在一起对不熟悉 Blender 的人来说门槛很高。
blender-threejs-product-skills 把这四步封装成了四个 AI agent skill 文件——告诉 AI Agent 在 Blender 里应该按什么顺序做什么、用什么参数、检查什么。
GitHub: https://github.com/doofly/blender-threejs-product-skills | MIT
四个 Skill 构成一条流水线
设计意图非常明确：四个 Skill 不是四个独立提示词，而是一条 Blender → Three.js 产品资产流水线的四个阶段，每一步以上一步的输出为前提。
Skill 1：$threejs-product-lowpoly — 几何降面
输入：高模 / CAD 导出 / 扫描模型
输出：适合实时渲染的低多边形几何体
核心思路：
- 优先重建简单机械零件（比平铺 Decimate 好），而不是全局一刀切降面
- 保留产品轮廓、比例、机械关系、层级结构和动画轴心点
- 删除低价值 CAD 特征（小圆角、装饰细节），清理拓扑
- 全局 Decimate 是最后手段，优先用共面溶解 + 局部 Decimate
输出结果是一个”几何检查点”，经过下游 UV、贴图、glTF 和 Three.js 工作前可以在此锁定。
Use $threejs-product-lowpoly to optimize the current Blender product model for Three.js.Skill 2：$threejs-product-basecolor — UV + Base Color 烘焙
输入：已通过 lowpoly 检查点的几何体
输出：干净的 UV 展开 + 无光照 Base Color 贴图
关键点：
- 只有在拓扑稳定之后才创建最终 UV（lowpoly 阶段可能改变布线）
- 烘焙的是实际材质颜色，不含光照/阴影/AO/反射
- 烘焙设置：
Color: ON, Direct: OFF, Indirect: OFF - 严格控制 UV atlas padding，检查 mip 级别下的颜色渗漏
Use $threejs-product-basecolor to rebuild UVs and bake a clean Base Color texture for the approved low-poly asset.Skill 3：$threejs-product-lighting — 产品中性布光
输入：低模 + 材质
输出：适合任意视角旋转的产品布光方案，以及对应的 Three.js 运行时布光策略
核心要求：
- 支持产品任意角度旋转（不能只对一个视角好看）
- 检查多个视点，控制过曝高光和死黑阴影
- 保持形体轮廓和曲率可读性
- 同时输出等效的 Three.js 运行时布光方案文档
Use $threejs-product-lighting to create neutral multi-angle product lighting suitable for Three.js.Skill 4：$threejs-product-light-bake — 光照预烘焙
输入：通过 basecolor + lighting 两步的资产
输出：Base Color + 直接光 + 间接光 合并到一张贴图
适用场景：固定展示的产品（不需要动态照明），比如电商产品页、工业说明文档、嵌入式展示屏。
烘焙设置：Color: ON, Direct: ON, Indirect: ON
这条路径支持使用 Unlit glTF 或 Three.js 的 MeshBasicMaterial，运行时几乎不需要 GPU 算力，跨设备显示稳定。
Use $threejs-product-light-bake to bake Diffuse Color + Direct + Indirect lighting into the final presentation texture.适用场景
这套流水线明确针对以下类型的资产：
- CAD 导出模型（SolidWorks/Fusion360/CATIA 出来的网格）
- 工业机械和设备
- 工程产品展示（网站/嵌入式屏/VR 展厅）
- 高面数产品扫描
不适合：游戏角色、有机体、需要精细骨骼动画的资产。
如何使用
将这四个 .md Skill 文件配置到支持 SKILL.md 格式的 AI Agent 工具里（如 AI Art Engine、DSH 等），然后按顺序在聊天窗口里调用对应的 Skill 命令。每个 Skill 会指导 AI Agent 完成对应阶段的 Blender 操作。
MIT 开源。doofly 维护，适用于 CAD/工程模型的 Three.js 实时可视化资产准备。开源仅供学习参考。
blender-threejs-product-skills: Four Skills to Turn Engineering Models into Web-Ready 3D
Getting a CAD engineering model from Blender into a browser requires: geometry cleanup (CAD meshes have messy topology unsuitable for real-time rendering) → UV unwrap → texture bake → Three.js lighting → GLB export. Each step has pitfalls; combined, they’re a steep barrier for anyone not fluent in Blender.
blender-threejs-product-skills encapsulates these four steps into four AI agent skill files — each tells the AI agent exactly what to do in Blender, in what order, with what parameters, and what to check.
GitHub: https://github.com/doofly/blender-threejs-product-skills | MIT
Four Skills, One Pipeline
These four skills are not four independent prompts — they are four stages of a Blender → Three.js product asset pipeline, each taking the previous stage’s output as its input.
Skill 1: $threejs-product-lowpoly — High-poly/CAD/scanned model → optimized low-poly geometry. Prefers reconstruction over global Decimate; preserves silhouette, proportions, mechanical relationships, hierarchy, and animation pivots; removes low-value CAD features.
Skill 2: $threejs-product-basecolor — Approved geometry → UV + Base Color atlas. UV creation happens only after topology is stable. Bake settings: Color: ON, Direct: OFF, Indirect: OFF — pure diffuse color, no lighting baked in.
Skill 3: $threejs-product-lighting — Neutral multi-angle product lighting + equivalent Three.js runtime lighting strategy. Must look correct from any rotation angle; documents the Three.js equivalent setup.
Skill 4: $threejs-product-light-bake — Base Color + Direct + Indirect → one pre-lit texture. Bake settings: Color: ON, Direct: ON, Indirect: ON. Supports Unlit glTF or Three.js MeshBasicMaterial for stable cross-device appearance at minimal runtime GPU cost.
Target Use Cases
CAD-exported models (SolidWorks/Fusion360/CATIA), industrial machinery, engineering product visualization (websites, embedded displays, VR showrooms), high-poly product scans. Not designed for game characters, organic meshes, or assets requiring skeletal animation.
Usage
Add these four .md skill files to any AI agent tool supporting the SKILL.md format (AI Art Engine, DSH, etc.), then call the corresponding skill commands in chat in sequence.
MIT. Maintained by doofly, designed for CAD/engineering model preparation for Three.js real-time visualization. For technical reference only.
关于本站 · 免责声明
🍄 Mushroom Research Blog 是非营利、免费公开的个人科技观察博客与公众号 XStack18，不接受商业合作、不代表任何企业或机构立场，也不谋求商业利益。我们以个人视角客观中立地记录和分析 AI、Web3 等领域的最新模型发布与技术动态——不止转述新闻标题或二手信息，而是给出有独立思考的深入分析，希望帮更多人获得有价值的一手科技认知。
⚠️ 文中介绍的开源代码与模型，仅供学习交流与技术借鉴。它们大多仍处于早期阶段，有待进一步研究和验证，请勿直接用于工作或生产环境；如需采用，请先自行充分测试，并核实其许可证与安全性。
Open-source code and models featured here are shared for learning and reference only. Most are early-stage and still need further study and verification — please don't use them directly in your work or in production. Test them thoroughly and check their licenses and security first.
- 本站文章均为作者基于公开信息的个人研究与观点整理，不代表文中提及的任何公司、产品、模型的官方立场，未与其构成商业关联或合作关系。
- 科技行业信息更新极快，我们尽力保证内容准确、及时，但不对完整性、实时性做绝对保证，具体请以相关企业/项目官方公告为准。
- 文中引用的第三方商标、产品名称、图片、数据等版权归原权利人所有，我们会尽量注明来源；如你认为存在版权疑问或侵权，请通过下方邮箱联系我们，收到通知后会尽快核实处理（更正、加注来源或删除）。
- 文章内容仅为技术科普与个人观点，不构成投资、法律或其他专业建议，据此进行任何决策的后果需自行判断和承担。
📮 侵权 / 勘误 / 合作咨询：[email protected]
💬 评论与讨论
使用 GitHub 账号登录后发表评论