前言¶
在 DeepSeek Harness(DSH)的插件生态中,处理工程图纸文件(DWG/DXF)需要兼顾功能实现与安全性。直接操作 CAD 文件存在修改源文件的风险,且缺乏对解析过程的精细控制。dsh-cad-plugin 提供了一套原生工具,用于在不修改源文件的前提下,对 CAD 图纸进行检查、提取和导出。
插件简介¶
dsh-cad-plugin 是一套专为 DeepSeek Harness 设计的只读 DWG/DXF 处理工具集。它由开发者 roymina 维护,采用 MIT 许可证。插件通过三个原生工具 (cad_inspect, cad_extract, cad_export) 封装了 CAD 文件处理能力,核心价值在于资源隔离与数据安全。
安装¶
插件通过 DSH 命令行安装。请将 <your-profile> 替换为你当前使用的配置文件名称。
dsh plugin --profile <your-profile> add dsh-cad-plugin
安装完成后,三个 CAD 工具将自动加载到 DSH 的可用工具列表中。
工具概览¶
插件提供三个核心工具,均返回 JSON 格式的结果或错误信息:
| 工具名称 | 功能描述 |
|---|---|
cad_inspect |
检查图纸元数据、单位、边界、图层、块和实体统计。 |
cad_extract |
提取文本、图层、块或实体,支持 JSON/CSV 报告输出。 |
cad_export |
导出 SVG/PNG 预览或进行 DWG 转 DXF 转换。 |
使用方法¶
使用前,需将 .dwg 或 .dxf 文件放入 DSH 会话的工作目录(Workspace)中。然后,通过自然语言提示让模型解析文件路径并调用相应工具。
典型提示词示例:
- 检查图层与块:
> “Inspectplan.dwgand summarize its layers and blocks.” - 提取文本到 CSV:
> “Extract all texts from./drawings/floorplan.dxfto CSV.” - 生成预览:
> “Render an SVG preview ofplan.dwg(Model layout, white background).”
路径说明:
路径可以是绝对路径(如 C:\drawings\plan.dwg),也可以是相对于工作目录的相对路径(如 plan.dwg 或 ./plan.dwg)。
注意: DeepSeek Harness Web composer 的附件按钮目前仅支持图片。若需处理 CAD 文件,请通过上述路径引用文件,而非直接上传。
资源限制与配置¶
插件采用资源保护机制,防止大文件或恶意文件导致系统崩溃。所有配置项均为可选,以下为默认值:
| 配置项 | 默认值 | 说明 |
|---|---|---|
outputDir |
./cad-output |
导出文件与报告的存放目录。 |
maxFileSizeMB |
50 |
输入文件最大允许大小。 |
maxEntities |
200000 |
最大解析实体数量。 |
maxExtractItems |
500 |
默认提取记录数量限制。 |
maxImageDimension |
8192 |
PNG 导出的最大像素宽/高。 |
maxImagePixels |
64000000 |
PNG 导出的最大像素总数。 |
maxSvgBytes |
20000000 |
SVG 输出最大字节数。 |
maxConcurrent |
2 |
最大并发 CAD 任务数。 |
maxWorkerTimeMs |
30000 |
单个任务硬超时时间(毫秒)。 |
数据隔离与验证¶
- 输出隔离: 所有输出文件位于独立目录,且不会覆盖已存在的同名文件。
- DXF 验证: 导出 DXF 后,插件会重新打开文件,对比文本内容、实体类型和图层,若发现严重不匹配,将返回
CONVERSION_VALIDATION_FAILED错误。