用途:在本地以 Python 脚本创建和编辑参数化 CAD 零件与装配体,组织多模型项目,导出 STEP/STL/3MF/GLB,解析提示中的几何引用并进行测量与检查。
主要能力:每个模型是一个无参数装饰函数、返回 build123d 形状的 Python 脚本,脚本与声明输出共用文件名主干,编辑源文件后运行 python <model>.py 重新生成输出。支持用 @step 导出 STEP,用 @stl/@threemf/@glb 声明每次运行维护的网格输出;一次性导出可用 cadgen stl/3mf/glb build INPUT.step OUT。装配体通过调用子模型并用 .moved() 或 Location * shape 放置。可用 read_scene 打开已保存的 STEP/STP/STL/3MF/GLB,用 scene.resolve(ref) 解析形如 /path/assembly.step#o1.2.f7 的引用,取得原生几何。可编写检查与测量脚本,并生成快照审阅外观。
使用方式:cadgen 与 python 均通过 uv 运行,命令为 uvx --no-config --managed-python --python 3.13 --from cadgen==0.7.21 cadgen(python 同理)。cadgen doctor <skill-dir> 检查安装与内核加载。项目命令从 CAD 项目根目录运行;CLI 路径相对工作目录,装饰器 out= 路径相对模型脚本。查看模型可运行 cadgen viewer --host 127.0.0.1 --json --detach,读取返回 JSON 中的 url,再访问 url?file=<URL 编码的绝对路径>。快照命令如 cadgen step snapshot STEP/bracket.step tmp/review.png。
适用场景:参数化零件与装配体建模、CAD 项目组织、格式导出、引用解析、几何测量与验证、图像或图纸建模、打开已有模型、外观或运动审阅、失败诊断与版本迁移。
限制:缺失事实暂未提供,如价格、平台范围、具体性能指标等。DXF 二维图纸请使用 $dxf;URDF、SRDF、SDF 请用对应机器人描述技能。同名文件重复、引用歧义时不应猜测。检查脚本应放在忽略的 tmp/ 或 checks/ 中,不放进模型源与原始输出目录。