DXF 生成与验证

来源：维护于 earthtojake/text-to-cad 仓库。 以本地已安装的技能文件作为运行时事实源；该仓库链接仅用于溯源及发布审核。

目的

根据自然语言需求或 CAD 几何体，创建或修改 2D DXF 图纸，生成经验证的 .dxf 构建产物，并返回已校验的输出结果。DXF 源为定义了 gen_dxf() 函数并返回一个 ezdxf 文档对象的 Python 文件；CLI 负责管理输出路径。

支持两类源结构：

• 独立制图（Standalone drafting）：Python 源文件仅定义 gen_dxf()。适用于纯 2D 输出场景——如垫片（gaskets）、面板（panels）、模板（templates）、切割排版（cut layouts）等，其背后无任何 3D 模型。
• CAD 投影（CAD projection）：在同时定义了 gen_step() 的 CAD 生成器源文件中追加 gen_dxf()。适用于 DXF 表示某 3D 零件的工程图或轮廓线的情形；此时应先使用 $cad 创建并验证 STEP 几何体，再在同一源文件中添加投影逻辑。

何时使用本技能

当用户请求 DXF 文件、2D 工程图、轮廓线（profiles）、外轮廓（outlines）、模板（templates）、垫片（gaskets）、面板（panels）、展开图（flat patterns）或适用于激光、等离子、水刀及 CNC 铣削的切割排版（cut layouts）时，请使用本技能。

若 DXF 源自某个 3D 零件或装配体，请使用 $cad；若需执行 SendCutSend 平台专属上传预检，请使用 $sendcutsend。

默认约定

除非用户明确指定，否则采用以下默认设置：

• 单位：毫米（millimeters）；需在文档中显式设置（doc.units = ezdxf.units.MM）。
• 几何位置与比例：所有几何体位于模型空间（modelspace），按 1:1 比例绘制。
• 切割轮廓：必须为闭合多段线（closed polylines）或由直线/圆弧构成的闭合环（closed line/arc loops）；仅雕刻（engraving）或参考几何（reference geometry）可使用开放轮廓（open contours）。
• CAD 支持类零件的 DXF 轮廓生成：优先从同一生成器脚本中的实际 STEP/实体拓扑导出 DXF 切割轮廓：构建 3D 形状 → 选取/投影真实的平面面（planar faces）→ 将其展开为平面坐标 → 从这些投影后的面边界线（face wires）生成闭合轮廓。仅当缺乏可靠 3D 拓扑可供投影时，才使用手绘参数化外轮廓。
• 图层语义：不同意图的几何体应置于不同图层——切割几何体与折弯/折叠线（bend/fold lines）须分离；折弯图层名称中应包含 “bend” 字样，以便下游工具将其识别为折弯而非切割。
• DXF 图层 vs STEP 结构：DXF 图层表达的是绘图结构，而非 STEP 零件/装配体的层级结构。

工具

启动器位于 DXF 技能目录内：

python scripts/dxf targets... [flags]

请使用当前项目的 Python 解释器；此处 python 视为解释器占位符；可通过 --help 查看完整接口说明。目标路径基于命令执行时的当前工作目录（CWD）解析；请从拥有相关构建产物的工作区（workspace）中运行该命令，并使用相对于 CWD 的目标路径。除非用户另有要求，否则 DXF 输出文件及其对应的 Python 生成器应置于同一目录下，且具有相同的基本文件名（basename）。

一个 DXF 目标是一个定义了如下函数的 Python 源文件：

def gen_dxf():
    ...
    return document

普通生成的 Python 目标将输出同目录下的同名 .dxf 文件。仅当处理单个普通 Python 目标时，才可使用 -o/--output；若需为每个目标指定定制化输出路径，请使用 SOURCE.py=OUTPUT.dxf 这样的位置参数对。切勿在 gen_dxf() 的返回值中嵌入输出路径。

scripts/dxf 是一个生成器（generator），它不会检查已存在的 .dxf 文件。如需检查已有 DXF 文件，请使用 ezdxf 进行实体（entity）与图层（layer）层面的校验，并使用 $cad-viewer 进行可视化审查。

工作流程

1. 将用户请求转化为简明任务摘要：明确标注尺寸、孔/槽特征、图层划分、单位、输出路径以及待验证项。
2. 对于 CAD 投影类任务：首先使用 $cad 生成并验证 STEP 几何体，然后在同一源文件中添加或更新 gen_dxf()。尽可能直接从内存中的 STEP/实体拓扑导出 DXF（而非重复编写几何公式），确保 DXF 始终是所导出零件的真实投影或展开结果。
3. 编写或编辑 Python 源文件，使用具含义的命名参数表达关键尺寸。
4. 仅对显式指定的 Python 源文件目标运行 scripts/dxf；禁止执行全目录范围的批量生成。

python scripts/dxf path/to/source.py
python scripts/dxf path/to/source.py -o path/to/output.dxf
python scripts/dxf path/to/a.py=out/a.dxf path/to/b.py=out/b.dxf

5. 对生成的 DXF 执行确定性验证，随后移交成果并报告结果。

验证

请使用定向的 ezdxf 检查替代人工目视核验：包括按类型与图层统计实体数量、检查切割轮廓是否闭合、验证图纸范围（drawing extents），以及逐一确认用户指定的所有尺寸。

import ezdxf

doc = ezdxf.readfile("path/to/output.dxf")
msp = doc.modelspace()
profiles = [e for e in msp.query("LWPOLYLINE") if e.closed]
holes = msp.query('CIRCLE[layer=="0"]')

仅报告实际执行过的检查项。

交付

在创建或修改 .dxf 构建产物后，若已安装 $cad-viewer 技能，则你必须始终将生成的明确文件路径传递给 $cad-viewer，并在最终响应中附上其实时查看器链接（live viewer link）。若 $cad-viewer 不可用或启动失败，请如实报告该情况，并转而依赖 ezdxf 检查结果，不得静默省略交付步骤。

最终响应应包含：生成的文件、返回的查看器链接、实际执行的验证项，以及所作假设。