create-dxf

📐 制造业 2D 图纸智能生成工具

设计榜 #2

基于 Python 标准库的制造业 CAD 图纸生成工具,可从 JSON 规范安全生成水刀/激光切割用的 DXF 文件及 SVG 预览,零依赖且通过严格安全验证。

收藏
22.5k
安装
4.7k
版本
latest
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

create-dxf 是一款专注于制造业的 2D 图纸生成工具,旨在将水刀、激光切割和数控铣削等工艺所需的 DXF 文件生成过程标准化。用户首先将自然语言设计需求转换为严格的 JSON 规范(包含中心原点、明确单位等制造友好参数),通过内置的验证脚本检查几何完整性和参数合法性后,执行渲染命令生成最终文件。工具输出包含标准制造图层的 DXF 文件(CUT_OUTER 外轮廓层、CUT_INNER 孔槽层、NOTES 注释层)以及用于快速预览的 SVG 矢量图,适用于安装板、支架、垫片和孔型图案等平板类零件的批量生产准备。

显著优点

该工具最大的安全优势在于零外部依赖的实现方式——仅使用 Python 标准库(argparse、json、math、os 等)完成全部功能,彻底消除了第三方包带来的供应链攻击风险。代码架构严谨,具备完善的输入验证机制:通过 _req()_opt() 函数确保 JSON 规范中的必填字段和类型安全,对宽度、高度、圆角半径等几何参数进行范围验证(如确保数值大于零),并执行边界检查防止孔槽超出轮廓范围。输出采用制造行业通用的 LWPOLYLINE 和 CIRCLE 实体,确保与 AutoCAD、Fusion 360 等主流 CAD 软件以及 CAM 加工系统的兼容性。SVG 预览功能的加入让用户在投入生产前能快速验证设计,显著减少打样错误。

潜在缺点与局限性

作为专注于制造准备的专用工具,create-dxf 的功能边界较为明确:仅支持 2D 平面几何体,无法处理三维模型或复杂曲面。DXF 实体类型局限于简单的多段线和圆形,对于样条曲线、文字标注或填充图案等高级 CAD 功能不支持。JSON 规范虽然保证了生成结果的确定性,但对非技术用户而言存在一定的学习成本,需要将设计意图转换为结构化的机器可读格式。此外,SVG 路径解析功能使用正则表达式处理用户输入数据,面对复杂或格式不规范的 SVG path 数据时可能存在解析限制。

适合的目标群体

该工具主要面向机械工程师、制造技术工程师和 CAD 自动化开发者,特别是需要为水刀切割、激光切割或 CNC 铣削工艺快速生成标准零件图纸的从业者。适合需要批量生成参数化零件(如标准支架系列、安装孔阵列表)的场景,以及希望建立从设计规范到制造文件自动化流水线的企业。对于缺乏昂贵 CAD 软件许可但需要生成工业标准 DXF 文件的初创硬件团队或小型加工厂同样具有实用价值。

使用风险与注意事项

尽管代码本身通过严格的安全审计,但用户仍需注意 JSON 规范文件的来源安全性,避免加载来自不可信渠道的恶意设计文件(如通过极端数值试图造成计算资源耗尽)。使用 etch_svg_paths 功能时,应确保 SVG 路径数据来自可信设计源,防止正则解析异常。建议通过 --outdir 参数严格控制输出目录,避免文件写入到系统关键路径。由于作者为个人开发者(T3 来源),建议企业在关键生产流程中采用前进行代码审查,并建立本地备份以应对潜在的维护中断风险。

安全解读

功能概述

create-dxf 是一个专为制造业设计的本地 CAD 文件生成工具,核心功能是将结构化的 JSON 设计规范转换为行业标准 DXF 文件(兼容 AutoCAD)及 SVG 预览图。该工具聚焦于钣金/板材类零件的快速出图需求,如水刀/激光/铣削加工用的安装板、角撑板、支架、孔阵列和槽口等典型零件。

核心用法

工作流程为 自然语言提示 → JSON 规范 → DXF/SVG 输出 的三阶段转换:
1. 规范转换:将设计需求转化为符合 spec_schema.md 定义的严格 JSON 结构

2. 验证:通过 validate 子命令检查几何约束、单位系统和坐标合法性

3. 渲染:执行 render 生成 CUT_OUTER(外轮廓)、CUT_INNER(孔/槽)、NOTES(注释)三层结构的 DXF,附带同名 SVG 预览

显著优点

  • 零依赖安全架构:纯 Python 标准库实现,无第三方包,彻底消除供应链攻击面
  • 制造语义内置:图层命名直接对应加工工艺(CUT_OUTER/CUT_INNER),支持中心原点坐标系和显式单位声明,减少工厂端理解成本
  • 确定性输出:相同 JSON 输入保证字节级一致的 DXF 文件,利于版本控制和自动化质检
  • 完全离线运行:无网络 API 调用、无遥测、无云端依赖,适合涉密或隔离网络环境

潜在局限

  • 功能边界明确:仅支持 2D 板材类零件,不支持曲面、装配体或参数化特征树
  • 人工转换瓶颈:自然语言到 JSON 的第一次转换仍需人工或外部 LLM 介入,工具本身不内置 NLP 解析
  • CAD 生态兼容性:使用简单图元(LWPOLYLINE + CIRCLE)确保通用性,但可能丢失高级 CAD 系统的特征语义

适合人群

  • 机械加工厂的 报价工程师(需快速生成 RFQ 用图纸)
  • 自动化产线集成商(需要将设计规则直接转换为机床输入)
  • 供应链安全敏感 的国防/航空航天制造业(零依赖 = 可控审计)
  • 希望 绕过重型 CAD 软件授权 的初创硬件团队

常规风险

| 风险类型 | 评估 | 说明 |
|---------|------|------|
| 输入注入 | 低 | JSON 验证器已覆盖类型检查,但建议补充路径遍历防护和文件大小限制 |
| 资源耗尽 | 低 | 未限制输出文件数量和尺寸,极端复杂几何可能导致内存压力 |
| 许可合规 | 信息级 | 当前未声明开源许可证,商业使用前需确认版权条款 |
| 文档一致性 | 信息级 | 示例命令中的脚本名与实际文件名存在不一致,可能误导首次用户 |

create-dxf 内容

references文件夹
scripts文件夹
手动下载zip · 11.5 kB
spec_schema.mdtext/markdown
请选择文件