CAD Agent

核心用法

CAD Agent是一个基于Docker的渲染服务器，让AI Agent通过"发送代码→接收图像→视觉迭代"的闭环完成机械设计。核心架构遵循容器内全隔离原则：所有CAD逻辑（build123d建模、VTK渲染、网格处理）均在容器内执行，Agent仅通过HTTP发送指令并观察返回的PNG图像。

标准工作流：
1. POST /model/create 创建build123d模型
2. POST /render/multiview 或 /render/3d 获取渲染图
3. 人工/Agent查看图像，判断是否符合预期
4. POST /model/modify 迭代修改代码
5. 循环直至满意后 POST /export 导出STL/STEP/3MF

显著优点

• 视觉闭环：将传统"盲写代码→导出→外部查看"的割裂流程压缩为秒级反馈循环，大幅降低3D建模的认知负荷
• 技术栈现代：基于build123d（Pythonic参数化CAD）和VTK（工业级渲染），优于传统OpenSCAD方案
• 容器化安全：设计文件与渲染计算完全隔离于容器，主机零依赖，支持快速部署
• 打印就绪：内置 /analyze/printability 等制造性检查接口，打通设计到3D打印的最后一公里

局限性与风险

• 网络依赖：嵌套容器环境（如Clawdbot沙箱）存在localhost访问限制，需改用docker exec替代curl
• 无持久状态：容器重启后模型丢失，需自行管理设计源码
• 渲染瓶颈：复杂模型的VTK渲染可能成为延迟瓶颈，未提及GPU加速支持
• 代码注入面：model/create和model/modify直接执行用户提交的Python代码，虽有容器隔离，但仍需警惕供应链攻击（如恶意PyPI依赖）

适合人群

• 需要快速验证3D打印件原型的机械工程师
• 通过自然语言控制CAD的AI Agent开发者
• 厌恶CAD软件GUI、偏好代码驱动设计的参数化建模爱好者

常规风险

• 容器逃逸风险（低概率，但HTTP服务暴露增加了攻击面）
• 设计文件意外泄露（已通过.gitignore和pre-commit hook缓解）
• build123d版本迭代导致的API兼容性断裂

核心用法

CAD Agent是一款专为AI代理设计的CAD可视化渲染服务器，采用客户端-容器分离架构：AI代理通过HTTP API发送建模指令，容器内执行build123d代码并完成VTK渲染，返回PNG图像供代理"查看"。核心工作流为：创建模型→渲染观察→迭代修改→导出成品。

显著优点

视觉反馈闭环：代理可实时查看建模结果，实现真正的迭代式设计，而非盲目生成代码。专业级内核：基于build123d（CadQuery精神续作）和VTK工业渲染引擎，支持布尔运算、参数化建模、技术制图。容器化隔离：所有CAD逻辑完全在Docker容器内运行，代理仅作决策不接触复杂几何计算，避免环境依赖地狱。多格式导出：支持STL/STEP/3MF等制造标准格式，内置打印性分析。安全设计：项目内置.gitignore和pre-commit钩子防止设计文件误提交。

潜在缺点与局限性

本地部署门槛：需Docker环境和约1GB镜像构建，对轻量用户不友好。端口硬编码风险：默认8123端口可能冲突，且文档未提供环境变量覆盖方案。无版本锁定：git clone默认拉取main分支，生产环境稳定性存疑。渲染性能边界：复杂模型VTK渲染可能耗时数十秒，文档未明确超时配置。Docker-in-Docker限制：嵌套容器环境（如云IDE）中localhost网络可能失效，需改用docker exec变通。

适合人群

• 需生成3D打印零件的AI开发者与创客
• 机械设计自动化工作流构建者
• 希望代理具备"空间视觉"的Multi-Agent系统架构师
• build123d/CadQuery现有用户寻求可视化增强

常规风险

• 端口8123冲突导致服务启动失败
• 未锁定版本引入破坏性变更
• 大模型渲染超时未配置导致流程中断
• Docker嵌套网络环境需额外适配