roymina/dsh-cad

English · 中文

Read-only DWG/DXF tools for DeepSeek Harness: inspect, extract and export CAD drawings — including SVG/PNG previews and DWG-to-DXF conversion — without ever modifying the input file.

• Three native tools — cad_inspect, cad_extract, cad_export.
• Read-only by design — the source drawing is never edited; outputs go to a separate directory.
• Resource-guarded — file size, entity, vertex, image and output-byte limits, plus worker-thread isolation and hard timeouts.
• Round-trip validated — DXF output is reopened and checked for text, entity-type and layer mismatches.

Installation

From the dsh-market plugin market: open the market, find dsh-cad-plugin and click install. Or install by name from the command line:

dsh plugin --profile <your-profile> add dsh-cad-plugin

To install from a local checkout (development):

dsh plugin --profile dshcadtest add .
dsh --profile dshcadtest --dump-config

Usage

Once installed, the three CAD tools are available to the model. Put a .dwg or .dxf file in the profile's workspace (the session working directory) and ask about it in natural language — the model resolves the file path and calls the right tool for you:

"Inspect plan.dwg and summarize its layers and blocks." "Extract all texts from ./drawings/floorplan.dxf to CSV." "Render an SVG preview of plan.dwg (Model layout, white background)."

Paths may be absolute (C:\drawings\plan.dwg) or relative to the workspace (plan.dwg, ./plan.dwg).

Note on attaching files: the DeepSeek Harness Web composer's attachment button currently accepts images only. To work with a CAD file, reference it by path or filename as shown above rather than attaching it.

Tools

Tool	Purpose
cad_inspect	Drawing metadata, units, bounds, layers, blocks and entity statistics.
cad_extract	Extract texts, layers, blocks or entities; optional JSON/CSV report.
cad_export	SVG or PNG preview, or DXF conversion.

All tools return JSON: a successful result, or { ok:false, error:{ code, message, details } }.

Parameters

• cad_inspect — path (required).
• cad_extract — path, section (texts|layers|blocks|entities, required); optional layers, entityTypes, limit, offset, search, handle, window, nearest, summary, saveAs (json|csv), outputName.
• cad_export — path, format (svg|png|dxf, required); optional layers, layout, width, height, background, outputName.

Examples

{"path":"./plan.dwg"}

cad_inspect returns version/unit objects, header and actual bounds, layer flags, model/paper-space and block statistics, resource counts and a bounded warning summary.

{"path":"./plan.dwg","section":"texts","limit":200,"saveAs":"csv","bom":true}

cad_extract supports texts, layers, blocks and entities; filters and limits are applied before records are returned. CSV cells beginning with =, +, - or @ are protected against formula injection.

{"path":"./plan.dwg","format":"svg","layout":"Model","background":"#ffffff"}

cad_export supports SVG, PNG and validated Unicode binary DXF. SVG/PNG results include output bytes, SHA-256, bounds, source/expanded/rendered/skipped counts, unsupported-type counts and preview completeness. DXF conversion reopens the output and compares text, entity types and layers; severe mismatches return CONVERSION_VALIDATION_FAILED.

Configuration

All values are optional; the defaults below apply unless overridden in the plugin config.

Key	Default	Meaning
outputDir	./cad-output	Directory for exported reports and previews.
maxFileSizeMB	50	Maximum input file size.
maxEntities	200000	Maximum parsed entities.
maxExtractItems	500	Default record limit for extraction.
maxImageDimension	8192	Maximum PNG width/height in pixels.
maxImagePixels	64000000	Maximum total PNG pixels.
maxWarningSamples	50	Warning samples returned per run.
maxBlockDepth	16	Maximum nested-block expansion depth.
maxBlockInstances	10000	Maximum expanded block instances.
maxConcurrent	2	Maximum concurrent CAD jobs.
maxWorkerTimeMs	30000	Hard timeout for worker-isolated parse/render.
maxSvgBytes	20000000	Maximum SVG output bytes.
maxCsvBytes	20000000	Maximum CSV output bytes.
maxTextLength	1000000	Maximum single text length.
maxTotalVertices	5000000	Maximum total vertices.
maxEntityVertices	500000	Maximum vertices per entity.
allowedInputRoots	(unset)	Optional allow-list of input roots; when set, paths outside it return INPUT_OUTSIDE_ALLOWED_ROOTS.

Outputs are isolated from inputs, and existing files are never overwritten.

Error codes

Input and access — FILE_NOT_FOUND, PERMISSION_DENIED, NOT_A_FILE, READ_FAILED, UNSUPPORTED_FORMAT, INPUT_OUTSIDE_ALLOWED_ROOTS.

Limits — FILE_TOO_LARGE, ENTITY_LIMIT_EXCEEDED, TEXT_LIMIT_EXCEEDED, GEOMETRY_LIMIT_EXCEEDED, RENDER_LIMIT_EXCEEDED, OUTPUT_LIMIT_EXCEEDED, OUTPUT_EXISTS.

Arguments and parse — INVALID_ARGUMENT, LAYOUT_NOT_FOUND, PARSE_FAILED.

Conversion and export — CONVERSION_FAILED, CONVERSION_VALIDATION_FAILED, EXPORT_FAILED, OUTPUT_FAILED.

Runtime — CANCELLED, TIMEOUT.

Preview fidelity

The SVG/PNG preview renders lines, circles, arcs, ellipses, splines, hatches, polylines (including closed/bulge paths), text/MText/attributes, inserts with nested transforms and arrays, points, solids and leaders. Raster images, wipeouts, meshes and unsupported proxy entities are reported in unsupportedEntityTypes. Paper Space is selected with layout; Model is the default.

License

MIT