DesignOS 3D Blender Skill 技能

DesignOS 3D Blender 是一款专为 Blender 5.2 LTS 构建的 AI Agent 操作系统，旨在让 AI 编程助手（Claude Code、Codex、Google Antigravity 等）能够自主完成从建模、绑定、动画到渲染的完整 3D 制作流程，并输出通过生产规格验证的 3D 可打印零件。它不是生成图片或视频，而是真正输出可制造的实物——这是区别于普通 AI 3D 生成工具的本质差异。

核心能力

DesignOS 的核心是执行契约机制（AGENT_OK/AGENT_FAIL）：每个 payload 执行后返回结构化 JSON 结果，exit code 0/1/2/3 分别代表完全成功、需求失败、规格不完整、执行错误，彻底解决了 Blender Python 脚本 exit code 不可靠的问题。生产门控（Production Gate）支持 manifold 检查、自相交检测、体积计算、尺寸公差验证、壁厚/悬伸角检查、STL 往返验证（导出后重新导入比对 SHA256），确保输出的零件在物理上可打印。知识库包含 28 个 Blender bpy 领域文件，涵盖 CAD/打印/机器人标准、失败模式与修复对照表、决策表，经 Blender 5.2 LTS 实际验证。

安装配置

前置要求：macOS/Linux，Blender 5.2.x，Python 3.10+（仅使用标准库）。可选：blender-mcp 插件（用于在 Blender GUI 中以 MCP 方式接入 Agent）。

安装步骤一：安装 Blender 5.2 LTS（从 blender.org 下载）。 安装步骤二：配置 BLENDER_BIN 环境变量指向 Blender 可执行文件路径。 安装步骤三：（可选）安装 blender-mcp addon，在 Blender GUI 中连接 Agent。 安装步骤四：验证知识库，执行 python3 scripts/blender-knowledge.py check && python3 scripts/blender-knowledge.py list。

使用步骤

第一步，定义零件规格（Spec）。创建 specs/my-part.spec.json，声明尺寸公差、孔径标准（ISO 273/ISO 4762）、最小壁厚、材料和悬伸角度等数值。

第二步，Agent 执行建模。通过 Claude Code 或其他 Agent 编写 pass 文件（每个 pass 不超过约 80 行），执行 bash scripts/headless-run.sh my-pass.py，最后一行输出 AGENT_OK {...} 或 AGENT_FAIL {...}。

第三步，运行生产门控验证。执行 python3 scripts/production-gate.py --scene my-part.blend --spec my-part.spec.json --report gate-report.json --export-dir my-part/parts，exit 0 表示所有声明的检查通过。

第四步，导出可打印文件。通过验证的零件导出为 STL/3MF，送入切片软件进行物理打印。

适用场景

DesignOS 3D Blender 的典型应用场景包括：AI 驱动的工业零件建模与 3D 打印验证；机器人关节和机构的参数化设计；消费电子产品的快速原型制作；以及需要精确尺寸和配合公差的机械组件协作开发。

适用人群

主要面向以下用户：使用 Claude Code 等 AI 编程助手的 3D 设计师和工程师；需要 AI Agent 辅助完成建模-验证-导出全流程的创客；希望在 Blender 中实现自动化批量零件生产的制造商；以及研究 AI + CAD 融合的开发者和技术团队。

工作原理

DesignOS 遵循「规格 → 建模 → 验证 → 门控 → 导出」的标准化循环：规格（Spec）必须先于建模给出，声明零件的尺寸公差、材料、孔径标准、装配关系等数值；Agent 基于规格编写 Python 脚本（blender bpy API），每个脚本通过 headless-run.sh 执行并返回契约结果；生产门控对导出文件执行数字化检查（不证明物理性能，仅证明数字正确性）；知识库提供 bpy 常见模式的决策表和失败修复指南，避免 Agent 在同一问题上反复失败。循环策略为：两次同类失败改变方法类，三次同类失败触发 request-input 暂停，避免 Agent 在错误路径上无限循环。

官方链接

GitHub 仓库：https://github.com/jangtrinh/design-os-3d-blender blender-mcp 插件：https://github.com/ahujasid/blender-mcp