SuperAPI AI 工具集

dxf

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:从自然语言需求或 CAD 几何生成、修改并校验 2D DXF 图纸,输出可直接交付切割服务的 .dxf 文件。图纸的唯一真源是名为 <name>.py 的 Python 文件,其中定义一个无参数的 @dxf 模型函数,返回 build123d 2D 几何;引擎负责写出 DXF,用户不构造文档、不命名文件、不放置实体。

主要能力:支持三种工作流——从零绘制(垫片、面板、模板、无 3D 模型的切割排版)、生成式 STEP 零件的展开图(在模型旁写独立脚本,导入并调用模型)、导入 STEP 的展开图(用 cadgen.read_step 读取,作为被记录的输入)。裸形状输出到单一 CUT 层;{layer: shape} 或带标签的 Compound 输出到命名层。文字用 bd.Text 刻成轮廓放在标记层,不用 DXF TEXT 实体。几何必须位于 XY 平面,引擎会拒绝离面几何。输出字节是几何的函数,层按名称排序、实体按几何内容排序,因此未改动的图纸在任何机器上冷热重建结果一致。

使用方式:通过 uv 运行 cadgen,例如 uvx --no-config --managed-python --python 3.13 --from cadgen==0.7.21 cadgen。运行脚本本身即构建入口:python <drawing>.py,可用 --force 强制重建,--verbose、--json 控制输出。cadgen dxf snapshot <drawing.dxf> <file.png> 渲染 PNG;cadgen store why <drawing>.py 解释图纸为何过期或最新;cadgen doctor <skill-dir> 检查安装与内核加载。查看用 cadgen viewer --host 127.0.0.1 --json --detach。

校验:每次 @dxf 构建在写出前对序列化文档运行图纸检查,有错误则构建失败;检查包括切割层轮廓必须闭合、拒绝零长度或退化实体、拒绝完全重复几何、拒绝显式无单位文档、拒绝空模型空间;开放几何只允许出现在弯曲/雕刻/参考意图层。也可用 cadgen.drawing_checks.validate_dxf_file 对已有 .dxf 事后校验,并用 ezdxf 读取核对尺寸。

限制:无 cadgen dxf build 命令;一个脚本对应一张图纸,需逐个运行;不要读取本项目生成的 STEP,应改为导入模型脚本调用;快照命令只接受 .dxf 文档,不接受模型脚本;不支持相机、显示、渲染模式、视图标签等场景类参数。单位默认毫米,几何为 1:1 位于 XY 平面。Kerf 补偿用 flatten.offset_profile 或 flat_pattern(..., kerf=...),不要手工偏移坐标。