Agentcad计算机辅助设计（CAD）

您可以使用 agentcad，一个将 CadQuery Python 脚本转换为 3D 几何的 CLI。所有输出都是 JSON。每个命令都返回 "command" 和 "status" 键。

首次设置

``bash agentcad init --name <项目名称> agentcad --help # 请阅读 —— 它是您的完整操作说明 `

核心工作流程

• 编写脚本。 无需导入 —— cq、show_object 和所有帮助函数都预先注入。show_object(result) 是必需的。
• 先进行 dry-run 以检查指标而不消耗版本：

`bash agentcad run script.py --output test --dry-run ` 检查响应中的 volume、dimensions 和 is_valid。

• 实际运行 并预览和/或渲染：

`bash agentcad run script.py --output 标签 --preview --render iso `

• 检查无效的几何。 如果 is_valid：false 或几何看起来不正确：

`bash agentcad inspect v1_label/output.step `

• 迭代。 修复脚本，并使用新标签运行。使用 agentcad diff 1 2 比较版本。

脚本编写规则

• show_object(result) 是必需的 —— 至少需要一个调用。
• 这些是预先注入的（无需导入）：cq、show_object、translate、rotate、mirror_fuse、loft_sections、tapered_sweep、naca_wire、bbox_point、place_at、assemble、ellipse_wire、spline_wire、polygon_wire、rounded_rect_wire、elliptical_sweep、involute_gear_profile
• 帮助函数操作 TopoDS_Shape。使用 .val().wrapped桥接：

`python part = cq.Workplane('XY').box(10, 20, 5).val().wrapped moved = translate(part, 50, 0, 0) `

• 要显示帮助函数输出：

`python show_object(cq.Workplane('XY').newObject([cq.Shape.cast(topo_shape)])) `

• 对于 OCP 内部（gp_Pnt、BRepPrimAPI 等），请手动导入。

主要命令

| 命令 | 目的 | |---------|---------| | agentcad init --name 名称 | 初始化项目 | | agentcad run 脚本 --output 标签 | 执行脚本，生成 STEP + 指标 | | agentcad run ... --dry-run | 仅指标，无版本消耗 | | agentcad run ... --preview | 快速 256x256 iso PNG | | agentcad run ... --render iso,front | PNG 视图 | | agentcad run ... --export stl,glb | 网格导出 | | agentcad run ... --params k=v,k=v | 覆盖脚本参数 | | agentcad render STEP --view 视图 | 后期渲染，具有摄像头控制 | | agentcad export STEP --format stl,glb | 后期网格导出 | | agentcad inspect STEP | 拓扑报告（有效性、自由边缘） | | agentcad diff REF1 REF2 | 比较版本 | | agentcad context | 项目状态 | | agentcad docs [部分] | 深入文档（16 部分） | | agentcad view 文件 | 在浏览器中打开 GLB/STEP |

调试游戏规则

• 先检查指标 —— volume 和 dimensions 可以捕获大多数问题。
• 负体积？ 线圈绕线方向错误（顺时针而不是逆时针）。
• is_valid：false？ 运行 agentcad inspect —— 检查 free_edge_count 和壳体状态。
• 空心形状？ free_edge_count > 0 表示开壳。
• 复杂的轮廓（齿轮、样条）？ 使用减法构造 —— 从空心圆柱体/盒子中减去，而不是构建。请参阅 agentcad docs patterns。

模式

• 在原点构建，然后定位： 在原点创建几何体，使用 translate() 和 rotate() 将其放置。
• 复合体与联合体： makeCompound() 用于组装（保持部件分离），.union() 用于布尔融合成一个实体。
• 参数化脚本： 顶级变量赋值可通过 --params 覆盖。使用此方法进行迭代。
• 命名部件： show_object(shape, name="wheel", options={"color": "red"})` 用于每个部件的指标和彩色 GLB 导出。