Create Dxf

核心用法

create-dxf 是一款面向钣金制造的专业CAD文件生成工具，核心功能是将结构化的JSON设计规范转换为可直接用于生产报价（RFQ-ready）的2D DXF文件，同时附带SVG预览图。

典型工作流程：
1. 设计输入：将自然语言设计需求（如"100×80mm安装板，四角M6孔，中心30×20mm槽"）转换为严格校验的JSON规范
2. 格式验证：通过 validate 子命令确保几何约束、单位、图层命名符合制造标准
3. 文件渲染：执行 render 生成工业级DXF（含LWPOLYLINE外轮廓+CIRCLE孔特征）及可视化SVG

技术特性

• 制造优化图层系统：CUT_OUTER（外轮廓切割）、CUT_INNER（内孔/槽切割）、NOTES（工艺标注）
• 原点居中：所有坐标系以几何中心为原点，便于数控对刀
• 显式单位制：毫米/英寸强制声明，避免加工歧义
• 实体兼容性：采用基础DXF实体（LWPOLYLINE/CIRCLE），确保水刀、激光、CNC路由设备广泛兼容

适用零件类型：安装底板、加强筋板、L型支架、螺栓孔阵列、定位槽、垫片等二维钣金件。

显著优点

1. 制造直通性：输出文件无需后处理即可提交至Fab车间报价，消除设计-制造信息断层
2. 确定性生成：同一JSON输入保证位级一致的DXF输出，利于版本控制和复现
3. 双格式同步：DXF用于生产，SVG用于设计审查、邮件沟通、文档嵌入
4. 验证闭环：内置schema校验拦截几何错误（如自相交轮廓、孔距超限）于生产前
5. 轻量化依赖：纯Python脚本，无CAD软件授权门槛

潜在局限

• 仅支持2D：无法处理折弯、翻边、拉伸等三维特征；需配合折弯线标注人工处理
• 标准几何受限：圆弧仅限完整圆（CIRCLE），椭圆孔、样条曲线需近似为多段线
• 无CAM级优化：不输出切割路径排序、微连（tabbing）、引线（lead-in）等工艺策略
• 人工JSON转换：自然语言到结构化spec的转换目前需人工介入，未内置LLM自动化

适合人群

• 机械工程师/设计师：快速生成标准钣金件加工图
• 创客/FabLab运营者：低门槛从设计到水刀/激光切割
• 采购/项目经理：将设计意图转化为可报价的规范文件
• 自动化脚本开发者：集成至CAD工作流或ERP/MES系统

常规风险

| 风险点 | 说明 | 缓解建议 |

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

| 单位混淆 | JSON与DXF单位不一致导致零件尺寸错误 | 强制schema校验`units`字段，渲染前二次确认 |

| 轮廓不闭合 | LWPOLYLINE未正确闭合导致CAM软件报错 | 脚本自动检测闭合性，validate阶段报错 |

| 孔位干涉 | 孔边距不足引发实际加工破裂 | 参考`spec_schema.md`中的最小边距约束 |

| 图层误用 | 内外轮廓层混淆导致切割顺序错误 | 严格遵循`CUT_OUTER`/`CUT_INNER`命名规范 |

| 版本兼容性 | DXF版本与老旧机床控制器不匹配 | 默认输出R12兼容实体，必要时指定版本 |

总结

create-dxf 填补了"设计概念"到"制造执行"之间的标准化鸿沟，是钣金快速原型和小批量生产的实用工具。其核心价值在于可验证的确定性输出，而非替代专业CAD/CAM套件。对于复杂曲面或精密钣金件，建议结合SolidWorks/Fusion 360完成详细设计后，再用本工具批量生成标准孔板类零件。

核心功能

create-dxf 是一款面向制造场景的轻量级 CAD 文件生成工具，可将严格的 JSON 设计规范转换为工业标准的 DXF 图纸（同时附带 SVG 预览）。核心定位是解决钣金、板材类零件（安装板、角码、支架、孔阵、槽口等）从设计意图到加工文件的快速转换需求，尤其适配水刀、激光、CNC 雕刻等减材加工工艺。

显著优点

1. 确定性输出：采用中心原点坐标系、显式单位声明，确保设计意图与加工文件零偏差，避免传统 CAD 软件因单位混淆或坐标系漂移导致的报废风险。

2. 供应链零依赖：纯 Python 标准库实现（argparse/json/math/dataclasses 等），无第三方包引入，彻底消除供应链攻击面，部署环境仅需 Python 3 解释器。

3. 制造语义化图层：预设 CUT_OUTER（外轮廓）、CUT_INNER（孔/槽）、NOTES（标注）三层结构，直接对接 CAM 软件的后处理流程，减少车间工艺人员的图层整理工作。

4. 格式兼容性：DXF 采用简洁的 LWPOLYLINE + CIRCLE 实体组合，规避高版本 AutoCAD 特性，确保老旧切割设备（如早期水刀控制器）的解析稳定性。

局限性与适用边界

• 几何能力边界：仅支持 2D 线框模型，无法处理曲面、实体、装配约束或参数化特征历史，复杂三维钣金展开需借助专业软件。
• 输入规范严格：依赖人工或上游 LLM 将自然语言转换为符合 schema 的 JSON，若输入数据存在拓扑错误（如自相交轮廓），当前版本缺乏自动修复机制。
• 无协同能力：纯离线单文件处理，不支持版本管理、多用户锁定、BOM 关联等企业级 PLM 功能。

适用人群

• 硬件创客、机械工程师：快速生成打样用的切割文件，跳过重型 CAD 软件的启动成本。
• 工厂工艺员：将设计部门的简图批量转换为可下料的 DXF，减少重复描图。
• 自动化流程开发者：作为 CI/CD 或机器人流程中的「图纸生成节点」，通过 JSON 驱动实现参数化设计自动化。

常规风险

• 来源可信度：作者 ajmwagar 为个人开发者（T3），虽代码经审计无恶意，但生产环境使用建议持续关注更新与社区反馈。
• 文档一致性：当前版本存在示例命令与脚本文件名不匹配（rfq_cad.py vs create_dxf.py）的笔误，首次使用需核对实际文件名。
• 输入校验不足：JSON 解析虽有基础错误处理，但缺乏路径遍历防护（如 ../../../etc/passwd）及极端数值（零尺寸、负值）的前置拦截。

安全评估结论

经 CLS-Certify v2.1.0 全量扫描，该 Skill 获评 S 级（98 分）：无网络通信、无敏感信息处理、无危险函数调用，动态行为完全可预测，隐私合规六项全过。核心风险集中于 T3 来源等级及文档细节打磨，技术实现层面具备生产环境部署的安全基础。