这个 Skill 能做什么，适合哪些场景？
这是 earthtojake/text-to-cad 技能库中的 DXF 技能，用于把 2D 轮廓、垫片、面板、模板和下料图生成为 DXF 文件。图纸的真相源是一个定义了无参数 @dxf 函数的 Python 文件，引擎负责写出 .dxf 并在生成时执行校验。它支持三种工作流：从零起草、从生成的 STEP 零件导出展平图、以及从导入的第三方 STEP 导出展平图。生成的文件可通过内置快照命令或本地 CAD Viewer 进行可视化审查。
- 读取定义 @dxf 模型函数的 <name>.py，运行后写出同名 .dxf 文件
- 通过 cadgen.flatten 从 3D 零件的平面拓扑生成精确展平图（含 kerf 补偿）
- 追踪依赖零件的几何变化：零件几何变了图纸自动过期，未变则跳过重建
- 在写出前校验：切割层轮廓必须闭合、拒绝退化/重复几何、拒绝无单位文档
- 用 cadgen dxf snapshot 将 .dxf 渲染为 PNG，或在 CAD Viewer 中打开审查
- 用 ezdxf 直接读取任意现有 .dxf 做实体/图层检查
- 机械工程师需要为激光切割服务（如 SendCutSend 配合 $sendcutsend 技能）生成垫片或面板的下料 DXF
- 已有项目内生成的 STEP 零件，想导出带 kerf 补偿的钣金展平图，且零件修改后图纸自动重建
- 只有供应商提供的 .step 文件，需要展平成水刀或等离子切割轮廓
- 需要为切割布局区分 CUT / ENGRAVE / SCORE 图层并在弯曲线上标注 bend 层
- 想在交给切割服务商前对 DXF 做闭合轮廓、重复几何等确定性校验和可视化审查
- 需要 3D 实体建模的场景——这是纯 2D 图纸技能，3D 零件应使用配套的 $cad 技能
- 只需要 3D 打印或 CNC 多轴加工输出（STL/G-code）的用户——本技能只产出 2D DXF
- 无法安装 uv 或被 Windows 11 Smart App Control 阻止 OCP 原生模块加载的环境（README 明确指出此阻塞）
如何安装这个 Skill？
- cadgen 通过 PyPI/uv 下载并默认发送遥测（随机 ID，不含文件内容），如不接受请先执行 `uvx cadgen telemetry off` 或设置 CADGEN_TELEMETRY=0。
- CAD 查看器绑定回环但无鉴权，任何本地进程可读取其打开目录下的文件；不要将 --host 指向非回环地址。
- 首次运行需访问 PyPI 下载运行时与 headless 浏览器，中国大陆网络环境可能不可达或缓慢，未提供镜像方案。
- Windows 11 Smart App Control 会阻止未签名的 OCP 原生模块，导致所有 cadgen 命令失败；需关闭该功能或改用 WSL（关闭后无法重新开启）。
- 静态评审未执行任何代码，DXF 生成、验证与快照的实际行为未经独立复现，请在使用前自行小规模验证。
- Shell / 命令行
- 网络访问
- 本地文件系统
uvcadgen 0.7.20Python 3.13 (managed via uv)
本技能是 text-to-cad 技能库（含 13 个技能，MIT 许可）中的一个，随整个库安装。
Claude Code
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojakeCursor / Grok Build（可复用 Claude Code 插件，或单独安装）
git clone --depth 1 --branch latest https://github.com/earthtojake/text-to-cad ~/.cursor/plugins/local/text-to-cadGemini
gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update其他 Agent（Skills CLI）
npx skills add earthtojake/text-to-cad#latest如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 帮我画一个 60x40mm、四个 4.5mm 孔的垫片 DXF，用于激光切割
- 把 bracket.py 里的 STEP 零件展平成下料图，kerf 补偿 0.15mm，导出 DXF
- 根据 imported/vendor_panel.step 生成水刀切割用的 2D 轮廓 DXF 并渲染预览图
- 检查 plate.dxf 的切割轮廓是否闭合，并统计 CUT 层上有多少个圆
技能由用户的 DXF / 2D 图纸类请求触发。流程：把需求整理成简报 → 选定三种工作流之一（从零起草 / 生成模型展平 / 导入 STEP 展平）→ 编写或修改 <name>.py（尺寸用命名常量）→ 直接运行脚本（唯一入口，无 cadgen dxf build 命令）：
python path/to/source.py
python path/to/source.py --force
cadgen dxf snapshot path/to/drawing.dxf review.png
cadgen store why path/to/source.py校验在生成时自动执行；也可用 validate_dxf_file 对任意现有 .dxf 做事后检查，并用 ezdxf 验证用户指定的尺寸。渲染用 cadgen viewer --host 127.0.0.1 -- --detach 启动本地查看器。安装诊断用 cadgen doctor <skill-dir>。
这个 Skill 有哪些优点和局限？
- 图纸即模型：有新鲜度门控，零件几何未变时重建是 no-op，几何变了自动过期并解释原因（store why）
- 输出字节是几何的确定性函数，冷/热运行、不同机器产出完全相同的文件
- 校验内建于生成：闭合轮廓、退化实体、重复几何、空模型空间在写出前检查
- 曲线保持精确：圆角导出为 ARC、孔为 CIRCLE，不会碎成数百条短线段
- 依赖较重：需要 uv、按 pinned 版本下载 cadgen 0.7.20 及托管 Python 3.13，首次运行需联网
- Windows 11 Smart App Control 开启时会阻断 OCP 原生模块，所有 cadgen 命令失败
- 默认发送遥测和崩溃报告（可用 uvx cadgen telemetry off 关闭）
- 禁止读取本项目自己生成的 STEP 做展平，否则新鲜度门控永远无法判为最新
- 文本只能以雕刻轮廓（bd.Text）而非 DXF TEXT 实体导出
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| DXF 生成与校验技能 本页 | 57 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| SendCutSend 上传预检 | 57 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| Engineering Drawing（工程图纸生成） | 59 · 推荐 | ★ 19k | 1 天前 | MIT |
| DFM 可制造性审查技能 | 61 · 推荐 | ★ 19k | 1 天前 | MIT |
| G-code 切片技能（text-to-cad） | 60 · 推荐 | ★ 19k | 1 天前 | MIT |
README 将其定位为 text-to-cad 技能库的一环：3D 零件由 CAD（$cad）技能生成，SendCutSend 上传预检由 $sendcutsend 技能负责，DXF 技能专注 2D 展平与切割图纸；已退役的 cad-viewer 技能的可视化功能现由 CAD、DXF 等技能共同覆盖。
FollowSkills 如何评估这个 Skill？
证据显示本地执行、回环绑定的查看器、固定版本的 uvx 命令、明确的数据流与遥测披露（含关闭方式），SECURITY.md 明示查看器无鉴权且以回环为信任边界。扣分项：cadgen/遥测接收端为不可审计的外部闭源二进制（PyPI 安装），首次运行需下载并默认发送遥测（可关闭），查看器无鉴权属于已知残留风险，均非红线但使信任不完整。
文档自洽性极高：契约、模板、新鲜度门、验证检查、失败反馈（doctor、store why、拒绝离面几何、快照 OUT 先删后原子写）均有明确描述。扣分项：静态评审无法执行复现，skill 关键路径（@dxf 生成、snapshot、viewer）在提供的文件中无对应的已提交测试，错误路径多为描述而非可验证证据。
触发条件明确（DXF、二维轮廓、垫片、排样等），边界与非适用范围清楚（不处理 3D、无参数契约、XY 平面限制），并与 $cad/$sendcutsend 划分清楚。扣分项：依赖 uv/PyPI 下载与 headless 浏览器渲染，未说明中文环境支持，中国大陆网络可达性存疑且文档未提供镜像或离线方案。
信息架构分层良好（SKILL.md + references 模板 + agents 元数据），许可证 MIT 明确、版本钉死（cadgen==0.7.20）、出处链接清晰、已知限制（Smart App Control、单位、层语义）有披露。扣分项：维护责任与更新路径依赖仓库 README 且发布者为未验证身份，skill 自身无 changelog/版本号，部分行为依赖未展示的上游 cadgen 实现。
声称能直接产出可交付切割服务的 DXF 并内置验证，边际价值明确（相对手工建模）。扣分项：静态评审无法验证代表性输出的正确性与直接可用性，无已提交的 DXF 示例产物或第三方使用证据，价值主张部分依赖对 cadgen 内部行为的信任。
存在可审计的一手材料（SKILL.md、模板、SECURITY.md、CI badge、models/tests 下的部分测试源），事实与推断区分较好。扣分项：所提供的测试源均非 DXF 关键路径，CI 工作流仅覆盖 API/文档部署，未展示 skill 关键路径的测试或独立复现，覆盖薄。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →