dsh-corn-cad

玉米 CAD · dsh-corn-cad

中文 | English

在 DeepSeek Harness 侧边栏直接看 .dxf / .dwg 图纸，右键圈一块，写句话，交给 agent。

agent 拿到的是这张图的这个区域 —— 不是"你刚才说的那个地方"。

它解决什么

CAD 图纸交给 agent，最难的从来不是"看懂"，而是对齐指代。

你说"把这几个孔改大"，agent 不知道是哪个孔；你把图纸截图发过去，它拿到了像素却拿不到坐标。 这个插件把这一步接上：你在预览里右键拖出一个框，框住的图元、图层、句柄、世界坐标范围 会跟着你写的那句话一起进入对话。agent 不需要猜。

当前版本（0.1.0）只做这一件事，并把它做扎实：预览 + 圈选 + 气泡发消息。

功能

看图

在工作区文件树里点开 .dxf 或 .dwg，右侧文档预览标签直接显示矢量图纸。

操作 · 行为 拖拽 · 平移 Ctrl/⌘ + 滚轮 · 缩放 工具栏 − + 适应宽度 · 缩放控制

圈选（画板）

操作 · 行为 左键拖动 · 平移图纸 单击 · 选中光标下图元 Shift + 单击 · 追加选择 右键拖框 · 圈选并弹出指令气泡 Shift + 左键拖框 · 只圈选，不弹气泡

左键始终是导航：按下拖动就平移，按下不动就是单击选中。框选归右键 —— 这样两者不会互相抢占，图纸也不会"拖不动"。

工具栏上的「区域 / 图元」切换决定框选的粒度：

模式 · 语义 · 适合 区域（默认） · 框到哪就选哪。穿过框的图元被选中，并且记录框内那一段；横贯全图的中线只框中间一小段也选得中 · 改局部细节 图元 · 框到的图元整体选中。覆盖率不足的图元不选（避免误选大图框） · 整条线、整个块

区域模式下，选中集会带 inBand 字段 —— 那是该图元落在框内的折线（DXF 世界坐标）。 交给 agent 的消息会明确写出「框选模式：区域，修改范围以框内部分为准」，所以长线不会 被整条重写。

两种模式都不用包围盒相交判定：图框是一条 420×297 的多段线、表格线横贯全图， 用包围盒判定的话在任何位置小框一下都会把整张图框拖进选择集。

气泡 → 交给 agent

右键拖框、松手，气泡出现在指针位置。写下"这几根线改成黑色"，Ctrl/⌘ + Enter 或点「发送」。

进入对话的消息长这样：

【图纸修改】文件：30010877-CAD_A01.dxf
图纸路径：/Users/you/work/30010877-CAD_A01.dxf
框选修改内容：这几根线改成黑色
选中 3 个图元：e1(LINE), e2(LINE), e3(LINE)
范围（DXF 世界坐标）：x 3794.3..4102.5, y 1205.34..1502.34
选中集已写入：/Users/you/work/.corncad/selection.json

同时选中集写进图纸旁边的 .corncad/selection.json：

{
  "at": "2026-10-26T01:00:00.000Z",
  "drawing": "/Users/you/work/30010877-CAD_A01.dxf",
  "file": "30010877-CAD_A01.dxf",
  "instruction": "这几根线改成黑色",
  "count": 3,
  "picks": [
    { "type": "LINE", "layer": "0", "handle": "AF8", "depth": 0, "id": "e1",
      "bbox": [3794.30, 1205.34, 3794.30, 1502.34], "pts": [ ... ] }
  ]
}

记录放在图纸同目录而不是进程 cwd，是因为 agent 通常已经知道图纸路径 —— 它可以直接读 .corncad/selection.json，不用你告诉它文件在哪。记录里带 handle， agent 能精确回到 DXF 里的那一根线，而不是"左上角第三条"。

让 agent 改图

预览之外，这个插件让 agent 能真正修改 DXF 文件，改完侧边栏自动刷新。

怎么用

直接说就行：

把 165,105 那个孔改成直径 16

标题改成「底板 240x160」

这两个孔往右移 5mm

agent 会自己走完：列出图元 → 按句柄定位 → 应用修改 → 你看到图变了。

背后发生了什么

1. 看：corncad_edit 工具的 describe: true 返回所有可编辑图元的句柄、类型、图层和几何
2. 改：按句柄提交结构化编辑（radius / text / move / layer / color / delete 等）
3. 备份：每次写入前把原文件复制成 ..bak
4. 原子替换：先写临时文件再 os.replace，中途崩溃不会留下半个文件
5. 刷新：DSH 文档预览的 autoRefresh（默认开启）监听到文件版本变化，重新读取字节交给渲染器

安全边界

约束 · 说明 只改 .dxf · .dwg 是二进制，需要先导出为 DXF 路径校验 · 必须是真实存在的文件，不是目录、不是符号链接逃逸 失败即不写 · 一批编辑里任何一条失败，整个文件保持原样 大小上限 · 超过 64 MB 拒绝编辑 自动备份 · 每次写入都留 .bak，随时可回滚

依赖

编辑用 ezdxf（Python）。插件会自动寻找装好 ezdxf 的解释器， 优先用 DSH 自带的 Python 运行时：

# 已随本仓库安装步骤完成；如缺失可手动装
<PEP 668 环境> python3 -m pip install ezdxf
# 或用环境变量指定
export CORNCAD_PYTHON=/path/to/python3

没装 ezdxf 时预览照常工作，只有编辑会返回 NO_EZDXF 并说明怎么装。

中文编码的一个坑

ezdxf 在某些情况下会写出自相矛盾的文件：声明 ANSI_1252（R2007+ 应为 UTF-8）， 实际却是 GBK 字节。按声明解码的读取器（包括 AutoCAD）就会显示乱码。

本插件的处理：

• 读：按声明解码后给结果打分（U+FFFD 越少越可信），在 utf-8 / gbk / big5 / shift_jis 里选最干净的那个
• 写：R2007+ 一律写 UTF-8 并修正 $DWGCODEPAGE；老版本按真实代码页写回

安装

先装 DeepSeek Harness 桌面端。

方式一 · 插件页（推荐）

侧栏 插件 → 添加插件，填 https://github.com/xingyingyuzhui/dsh-corn-cad → 安装 → 启用。 安装后重启 DeepSeek Harness：宿主半边是进程级模块。

方式二 · 命令行

dsh plugin --profile <profile> add https://github.com/xingyingyuzhui/dsh-corn-cad

方式三 · 本地目录

git clone https://github.com/xingyingyuzhui/dsh-corn-cad
dsh plugin --profile <profile> add /绝对路径/dsh-corn-cad

方式四 · 离线 / 受限网络

本包自带 vendor/@mlightcad/libredwg-web/（DWG 解码依赖，约 12 MB）。 插件管理器无法联网时：

node tools/install-vendor.mjs --profile <profile>

只有 .dwg 需要这个依赖；.dxf 是纯文本，完全不碰 wasm。

装上之后

1. 在文件树里点开一张 .dxf（.dwg 需要上面那个解码依赖）。
2. 右侧出现图纸和工具栏，底部显示图元总数。
3. 右键拖一个框 → 图元变橙 → 气泡弹出。
4. 写指令，Ctrl/⌘ + Enter。
5. agent 收到带路径、图元清单和坐标范围的完整消息。

停用 / 卸载

# profile 的 cordis.patch.yml
- id: corn-cad
  disabled: true

卸载：dsh plugin --profile remove dsh-corn-cad。

配置

主题在 profile 的 cordis.patch.yml 里改：

- id: corn-cad
  config:
    background: "#000000"
    foreground: "#ffffff"

⚠️ 两者必须成对修改。DXF 的 ACI 7 是"与背景对比的黑或白"，渲染时取 foreground。 只改背景会让所有线条与背景同色、整张图不可见。不配置则白底黑线。

注意事项

限制 · 说明 `MULTILEADER` 不渲染 · 渲染器清单之外，引线会缺失 只读 · 无编辑、无图层开关、无导出；改动需外部脚本 HATCH 图案填充 · 只画边界轮廓，不画填充图案 框选阈值 50% · 覆盖不足一半的图元选不中（刻意为之，避免误选大图元） 文字外框为估算 · 按字符宽度估宽，非真实字形度量 不保存视图状态 · 重新打开回到适应宽度

支持的 DXF 图元：LINE LWPOLYLINE（含 bulge 弧）POLYLINE+VERTEX CIRCLE ARC ELLIPSE TEXT MTEXT ATTRIB INSERT（嵌套块 / 行列阵列 / 旋转 / 缩放）HATCH SOLID 3DFACE POINT DIMENSION。清单之外的实体被静默忽略（不报错、不绘制）。

中文图纸：按 $DWGCODEPAGE 自动识别 13 种代码页（GBK / Big5 / Shift_JIS / EUC-KR / windows-1250~1258 / windows-874），R2007+ 一律 UTF-8。\U+XXXX、%%P、%%D、%%C 均正确解码。

自检

自检不需要网络、不需要 Harness、不需要 React、不需要安装任何依赖，纯 Node 跑完 46 项， 全部通过时打印 46/46 checks passed 并以 0 退出，任何一项失败就以非 0 退出（可直接接 CI）。

node test/selfcheck.mjs

它验证的东西包括：渲染器的图元计数与 SVG 结构、图元拾取表、右键框选只取覆盖到的图元、 气泡经 session scope 发出并带上路径与坐标、拿不到会话时明确报错而不是假装已发送、 宿主四条路由、选中集落盘与回读、中英文词典对齐、以及打包与许可约束。

pnpm test 会先按 dependencies 真的装一遍依赖（写 node_modules/ 与 pnpm-lock.yaml， 两者都在 .gitignore 里、不随仓库分发）。装上 @mlightcad/libredwg-web 之后，DWG 那一项 会自动跳过并打印原因 —— 真实解码只能在装好依赖的 profile 里验证。

结构

index.js              宿主半边：/api/corn-cad/{ping,svg,selection,theme} 四条路由
client.js             浏览器半边：内联 SVG、图元拾取、框选、气泡
lib/dxf2svg.mjs       零依赖 DXF → SVG 渲染器（含拾取表）
cordis.patch.yml      插进 profile 的 bundle patch
icon.svg              品牌图标（矢量）
brand/                icon-source.png 与多尺寸 PNG
docs/example.svg      由 test/sample.dxf 生成的示例图
test/selfcheck.mjs    纯 Node 自检
tools/                生成示例图、安装离线依赖
vendor/               @mlightcad/libredwg-web（GPL-3.0，仅 .dwg 需要）

接缝依赖（DSH 内部形态，官方无兼容承诺，升级后可能失效）：

• documentPreviews.register()（由 @deepseek-ai/dsh-client-ui-sidebar-documentpreview 提供）
• slots.register / slots.inject（sidebar.right.tab.document，session 作用域）
• connection.fetch.register（/api 通道）
• locale.register
• ctx.sessions.scope(id).get('conversation') → conversation.send()