Create Dxf

核心用法

create-dxf 是一款面向钣金、板材类零件制造的工程图生成工具。用户通过自然语言描述设计需求（如安装板、加强筋、支架、孔阵、槽位等），系统将其解析为严格的JSON规格文件，再自动输出符合制造标准的DXF图纸及SVG预览。

工作流程：
1. 需求转换：将设计描述转化为结构化JSON（中心原点坐标系、明确单位制）
2. 规格验证：执行 validate 校验JSON合规性
3. 图纸渲染：执行 render 生成最终交付文件

输出规格：

• DXF采用高兼容性实体：LWPOLYLINE 外轮廓 + CIRCLE 孔位
• 预设制造专用图层：CUT_OUTER（外轮廓切割）、CUT_INNER（内孔/槽切割）、NOTES（技术注释）
• 同步输出SVG预览便于快速可视化

显著优点

| 优势 | 说明 |

|------|------|

| 制造原生 | 直接输出RFQ（询价）就绪格式，无需CAD软件中转 |

| 确定性生成 | 相同JSON输入保证完全一致的几何输出 |

| 多工艺兼容 | 覆盖水切割、激光切割、CNC雕刻等减材工艺 |

| 零设计门槛 | 自然语言输入，无需掌握CAD建模技能 |

潜在局限

• 几何复杂度受限：目前面向2.5D钣金/板材零件，不支持曲面、实体建模
• 工艺参数缺失：仅输出几何轮廓，不包含切割速度、功率、材料厚度等工艺卡片
• 公差标注缺位：未集成尺寸公差、形位公差等制造精度信息
• 依赖中间JSON：需可靠的NLP→JSON转换层，否则规格错误将直接传导至产出

适合人群

• 采购/项目经理：快速生成询价图纸，缩短供应商沟通周期
• 硬件创业团队：无专职CAD人员时快速迭代机械结构
• 制造工程师：批量生成标准化孔阵、安装模板等重复性几何
• 教育者/学生：理解CAM前处理流程的教学工具

常规风险

• 单位混淆风险：JSON未显式声明单位时可能导致尺寸错误（建议强制约定mm/inch）
• 轮廓闭合性：开放轮廓在水刀/激光切割中可能引发路径规划失败
• 层命名冲突：若下游CAM软件对图层命名敏感，需确认兼容性
• 版本兼容性：DXF实体类型选择保守，但老旧CAM系统仍需实地验证

核心用法

create-dxf 是一个纯 Python 3 命令行工具，它能根据一个经过严格验证的 JSON 规格说明，确定性地生成可直接用于报价请求（RFQ）的二维 DXF 工程图纸，以及一个可选的 SVG 格式预览文件。其目标用户是从事钣金、板材加工（如水刀、激光或雕刻机切割）的工程师和制造商。

工具的核心流程分为三步：首先，用户根据自然语言的设计要求，参照内置的 JSON 规范模式，编写一个定义零件轮廓、孔、槽等几何特征的 JSON 文件；接着，使用内置的校验命令 (validate) 对规格文件进行类型和几何上的严格检查，确保所有参数合法；最后，通过渲染命令 (render) 生成包含 CUT_OUTER（外轮廓）、CUT_INNER（内部孔洞）和 NOTES（注释）等制造导向图层的 DXF 文件，以及一个方便分享和预览的 SVG 文件。

显著优点

• 制造就绪与高兼容性：生成的 DXF 文件使用简洁的闭合多段线和圆实体，确保了与绝大多数 CAM（计算机辅助制造）软件的兼容性，可直接用于水刀、激光和雕刻机编程，减少从设计到生产的摩擦。
• 极致的可靠性与安全性：该工具完全离线运行，不产生任何网络流量、不调用外部 API、不收集用户数据。其“零外部依赖”的设计（仅使用 Python 标准库）消除了整个软件供应链攻击的风险，是被动的安全典范。
• 高度的确定性与可审计性：工具遵循严格的无状态“输入-处理-输出”模型。相同的输入永远产生字节级一致的输出，这对于版本控制和制造流程的重复性要求至关重要。同时，简洁的代码库和全面的输入校验（类型、范围检查）使其行为完全可预测、易于审计。

潜在缺点或局限性

• 功能范围垂直且固定：该工具专为 2.5D 的平板/板材零件设计。它不擅长处理复杂的 3D 模型、曲面或装配体，也不适合用于建筑设计或电子工程等其他图纸领域。
• 输入门槛为 JSON：用户需要具备将自然语言设计转化为结构化 JSON 配置的能力。这虽然精确，但对不熟悉编程概念的传统设计师或工程师来说，存在一定的学习曲线。
• 有限的元数据控制：目前生成的 SVG 文件中会默认嵌入包含厚度、单位等设计参数的注释。对于希望对外分享文件但不暴露设计意图的场景，这可能成为一个小的隐私考量点。

适合的目标群体

• 制造工程师与车间编程人员：需要快速、可靠地将打样或孔位图转化为机床代码的专业人士。
• 产品设计师与机械工程师：进行概念验证，需要为钣金及平板零件快速生成可制造的图纸和预览。
• 自动化与 DevOps 工程师：寻求将轻量级图纸生成集成到 CI/CD 流水线或自动化报价系统中的开发者，其零依赖和确定性输出的特性尤其理想。
• 安全敏感环境下的用户：在无法连接网络或隔离网络（Air-gapped）的制造环境中工作的人员，该工具的完全离线特性确保了其可用性。

使用该技能可能存在的常规风险

• 路径遍历的低风险：工具在创建输出目录时未进行强制的路径消毒。如果它被集成到一个接受用户输入的自动化脚本中，恶意用户可能通过精心构造的 --outdir 参数在文件系统的任意位置创建目录。对于本地单人使用场景，此风险极低。
• 设计隐私的细节暴露：如前所述，SVG 文件中的元数据注释虽然不包含个人身份信息，但会泄露零件的厚度和单位等设计参数。在公开分享 SVG 预览时，这可能非预期地暴露了设计关键信息。
• 性能限制：作为纯解释型 Python 脚本，处理由数千个孔或极其复杂的 SVG 路径构成的复杂 JSON 规格时，其性能可能不如编译型语言编写的 CAD 内核，但对于典型的中小型板材零件，性能完全足够。