DSH AutoCAD Bridge
把本机 AutoCAD 2024 变成 DeepSeek Harness Agent 的一双手:查状态、画图元、管图层、国标尺寸标注、块与属性块、MText/形位公差、机械辅助、外部参照、自动 BOM、批量 DXF/DWG/PDF 交付、3D 实体建模与 2D→3D 推理、图纸合规自检、企业 .dwt 模板、DWG 图元数据反解析、工程活动日志与工作报告,全部通过 MCP 工具调用完成。附带一个可视化的控制面板,负责托管后台桥进程的启停、参数、状态灯与实时日志。
当前版本 2.0.0(V2.0 正式工业版):79 个工具,一句话即可 「查图纸哪里不规范、按企业模板出图、把现有 DWG 反解析成可复刻脚本、导出工程报告」; V1.3 的「输入零件尺寸 → 自动 3D 模型 + 等轴测视图」、V1.2 的 「批量整理整套设备图纸 + 自动出 BOM + 自动转 PDF 交付」、V1.1 的 「建好机械制图环境 + 画零件 + 自动标注 + 自动分层」同样一句话可达。 迭代计划见 docs/ROADMAP.md,改动记录见 CHANGELOG.md。 V1.4(中望/浩辰国产 CAD 兼容)因本机未安装、无 live 验证对象,暂缓实现。
English: README.en.md

它解决什么问题
AutoCAD 本身是一个桌面 GUI 程序,没有对外的 HTTP API。想在 Agent 里驱动它,中间必须有一层把「命令行式的 COM 调用」翻译成「结构化的工具调用」的桥。这个项目就是那座桥,加上一个管着它的插件。
┌──────────────────────────────────────────────────────────────┐
│ DeepSeek Harness(Web / 桌面 Electron) │
│ │
│ Agent ──► mcp__autocad__cad_add_circle(...) │
│ │ │
│ ▼ │
│ @deepseek-ai/dsh-mcp-client ── HTTP/SSE ──┐ │
│ │ │
│ dsh-autocad-bridge(本仓库)◄─────────────┼── 控制面板 │
│ · 拉起/看护 Python 桥进程 │ 启停·参数·日志│
│ · 参数持久化 · 崩溃自动重启 │ │
└─────────────────────────────────────────────┼───────────────┘
│
┌─────────────────────▼──────────────┐
│ bridge/autocad_server.py │
│ (Python · MCP Server · stdio/HTTP)│
│ │ │
│ ▼ │
│ bridge/cad_com.py │
│ 单 STA 线程 + 命令队列 │
└────────────┼───────────────────────┘
│ COM (pywin32)
▼
┌────────────────────────────────────┐
│ AutoCAD 2024(acad.exe,桌面进程)│
└────────────────────────────────────┘
两层设计的原因:桥(Python)只懂 AutoCAD,插件(JS)只懂进程和界面。 桥可以脱离 DSH 单独调试,插件可以换掉桥的实现而不动界面。
功能
控制面板
侧边栏新增一个图标,点开是一整块中央面板:
- 状态灯:绿=进程在且端口通,黄=进程在但端口不通,灰=已停止
- 一键启停重启:不用再去任务管理器杀 python
- 连接参数:Python 路径、服务脚本、工作目录、端口、ProgID,改完即存
- 实时日志:桥进程的 stdout/stderr 直接流进面板,600 行环形缓冲
- 崩溃看护:进程意外退出后按 1s→2s→4s…最多 30s 的指数退避自动重启,连续 8 次失败后停手并提示
- 依赖自举:一键在你自己的数据目录建虚拟环境、装 pywin32/mcp/python-dotenv
- 环境探测:自动找出 Python 与桥目录,自动检测本机实际注册了哪些 AutoCAD ProgID
79 个 Agent 工具
基础(V1.0,18 个,全部保留)
| 工具 | 作用 |
|---|---|
cad_connect |
连接 AutoCAD(未运行时通过 COM 自动拉起) |
cad_status |
查状态:disconnected / idle / busy / error,含队列健康度 |
cad_escape |
发 ESC 取消当前命令、关掉模态弹窗(卡死时救命) |
cad_reconnect |
超时/卡死时重建 COM 连接(V1.1) |
cad_list_progids |
列出本机注册表中真实存在的 ProgID |
cad_list_documents |
列出所有打开的 DWG,标出活动文档 |
cad_new_document |
新建空白图纸(可选 dwt 模板) |
cad_save |
就地保存 / 另存为 |
cad_ensure_layer |
建图层(已存在则复用),支持颜色名或 ACI 索引 |
cad_list_layers |
列出全部图层与颜色 |
cad_add_line |
画直线 |
cad_add_circle |
画圆 |
cad_add_rectangle |
画矩形 |
cad_add_polyline |
画多段线(可闭合) |
cad_add_text |
写单行文字 |
cad_add_arc |
画圆弧(角度用度) |
cad_send_command |
发任意原生命令,如 _.ZOOM\n_E\n |
cad_list_entities |
列出模型空间全部图元(类型/图层/句柄) |
cad_zoom_extents |
缩放到全图 |
V1.1 工业基础能力(21 个)
| 分类 | 工具 | 作用 |
|---|---|---|
| 标注 | cad_setup_text_style |
建中文文字样式(gbenor.shx + gbcbig.shx) |
| 标注 | cad_setup_gb_dim_style |
国标标注样式(24 个 DIM* 变量) |
| 标注 | cad_add_dim_linear |
线性/水平/竖直标注 |
| 标注 | cad_add_dim_aligned |
对齐标注 |
| 标注 | cad_add_dim_radial |
半径标注 |
| 标注 | cad_add_dim_diametric |
直径标注 |
| 标注 | cad_add_dim_angular |
角度标注 |
| 标注 | cad_add_dim_ordinate |
坐标标注 |
| 图层 | cad_setup_standard_layers |
一次性建齐 6 个机械标准图层 |
| 图层 | cad_set_layer_state |
批量改锁定/冻结/颜色/线宽/活动层 |
| 图层 | cad_set_active_layer |
切换当前图层 |
| 环境 | cad_setup_mechanical_environment |
一句话建好整套制图环境 |
| 块 | cad_list_blocks |
列出当前文档的块定义 |
| 块 | cad_create_block |
新建块(含属性定义),幂等不覆盖 |
| 块 | cad_insert_block |
插入块,可覆写属性值、旋转缩放 |
| 块 | cad_list_block_attributes |
读块参照的属性 |
| 块 | cad_set_block_attribute |
改块参照的属性值 |
| 块 | cad_replace_block |
批量替换块参照 |
| 文字 | cad_add_mtext |
多行文字(含堆叠公差) |
| 文字 | cad_add_tolerance |
形位公差框 |
V1.2 非标自动化(17 个)
| 分类 | 工具 | 作用 |
|---|---|---|
| 机械辅助 | cad_add_centerlines |
按矩形两角自动生成居中中心线 |
| 机械辅助 | cad_mirror_entities |
按镜像轴补全对称图形 |
| 机械辅助 | cad_offset_entity |
等距偏移一个图元 |
| 机械辅助 | cad_array_rectangular |
矩形阵列 |
| 机械辅助 | cad_array_polar |
环形阵列(角度用度) |
| 机械辅助 | cad_trim_at_points |
批量修剪(走原生 _.TRIM 命令) |
| 外部参照 | cad_list_xrefs |
列出外部参照与路径 |
| 外部参照 | cad_attach_xref |
附着 DWG 外部参照 |
| 外部参照 | cad_xref_action |
绑定/卸载/重载/拆离/修复单个参照 |
| 外部参照 | cad_repair_xref_paths |
批量修复参照路径前缀 |
| 明细表 | cad_count_blocks |
统计块参照数量 + 属性样例 |
| 明细表 | cad_generate_bom |
自动生成 BOM 明细表(可对齐右下角) |
| 批量 | cad_unify_styles |
统一字体样式 / 图层 |
| 批量 | cad_export_dxf |
当前图纸导出 DXF |
| 批量 | cad_export_dwg |
当前图纸导出 DWG(Wblock) |
| 批量 | cad_export_pdf |
当前图纸高清打印成 PDF |
| 批量 | cad_batch_convert |
一句话批量整理整套图纸并出 BOM / 转 PDF |
一句话交付整套非标图纸
cad_batch_convert(paths=[...], out_dir=..., formats=["dxf","dwg","pdf"])
→ 逐张打开 → 统一字体 → 三格式导出 → 关闭
cad_generate_bom() → 自动统计块 → 生成明细表并对齐图纸右下角
cad_unify_styles(style="DSH-CN") → 批量统一字体/图层
cad_batch_convert 内部给每文档单独一次 STA 调用、全局唯一
SelectionSet 名、以及加宽的 BUSY 重试窗口(连续导出后 CAD 后台收尾会忙
2~5 秒),实测 3 张图纸连续导出 3/3 通过。
V1.3 3D 闭环(14 个)
| 分类 | 工具 | 作用 |
|---|---|---|
| 3D 原语 | cad_add_3d_primitive |
7 种原语:box/cylinder/sphere/cone/torus/wedge |
| 3D 建模 | cad_extrude_profile |
闭合轮廓 → 面域 → 拉伸实体 |
| 3D 建模 | cad_revolve_profile |
闭合轮廓绕轴旋转成实体 |
| 3D 建模 | cad_sweep_profile |
闭合轮廓沿直线路径扫掠 |
| 3D 建模 | cad_boolean_solids |
布尔并集 / 交集 / 差集 |
| 3D 建模 | cad_rotate_3d |
实体绕 3D 轴旋转 |
| 3D 建模 | cad_slice_solid |
三点平面剖切实体 |
| 3D 建模 | cad_section_solid |
取实体截面(面域) |
| 3D 建模 | cad_solid_info |
读实体包围盒 / 图层 / 存活状态 |
| 3D 建模 | cad_fillet_edges / cad_chamfer_edges |
圆角 / 倒角(走命令,异步) |
| 视图 | cad_set_3d_view |
iso/front/back/top/bottom/right/left + 着色 |
| 2D→3D | cad_dimensions_to_3d |
长宽高 → 3D 实体 + 等轴测 + 着色 |
| 2D→3D | cad_profile_to_3d |
闭合草图 + 厚度 → 实体 + 等轴测 + 着色 |
一句话从尺寸到 3D 模型
cad_dimensions_to_3d(length=44, width=28, height=40)
→ box 实体占据 [0,44]×[0,28]×[0,40] + 自动等轴测 + Conceptual 着色
cad_profile_to_3d(points=[[0,0],[60,0],[60,40],[0,40]], thickness=12)
→ 拉伸实体 + 自动等轴测 + 着色
cad_set_3d_view(view="front", shade="Realistic") → 切前视图
实测要点:原语的 center 是几何中心(沿 Z 对称),布尔 0=并/1=交/2=差
(与文档相反),角度参数一律用度(COM 内部弧度);cad_fillet_edges /
cad_chamfer_edges 走 _.FILLETEDGE / _.CHAMFEREDGE 命令,是
fire-and-forget,需在 CAD 里目视确认。视图方向用纯 COM 改
ActiveViewport.Direction 并赋值回,再用 VIEWDIR 验证,不发裸 VPOINT。
一句话画零件图
cad_setup_mechanical_environment → 建好图层/字体/GB 标注样式,打开自动分层
cad_add_rectangle / cad_add_circle → 画轮廓,自动落「轮廓」层
cad_add_dim_linear / ... → 加标注,自动落「标注」层
cad_zoom_extents → 缩放全图
角度参数统一用度(内部转弧度)。标注自动落到「标注」层并支持
文字覆盖。自动分层开关默认关闭,只有调过
cad_setup_mechanical_environment 才生效——这是刻意的向下兼容。
V2.0 正式工业版(9 个)
| 分类 | 工具 | 作用 |
|---|---|---|
| 合规自检 | cad_check_drawing_compliance |
只读扫描全图,检出图层错误 / 标注不规范 / 未闭合轮廓 / 重复线 / 碎线 |
| 企业模板 | cad_list_templates |
列出本机模板目录里的 .dwt(运行时解析路径) |
| 企业模板 | cad_read_drawing_standard |
读出当前图纸的图层 / 文字样式 / 标注样式 / 线型 / 系统变量 / 活动项 |
| 企业模板 | cad_load_template |
加载 .dwt 建新图(坏路径显式拒绝,不静默建普通图) |
| 企业模板 | cad_save_as_template |
把当前图纸另存为 .dwt(SaveAs(path, 14)) |
| 图元反解析 | cad_reverse_engineer_drawing |
读现有 DWG 的全部图元参数 + 制图规范(非视觉识图) |
| 图元反解析 | cad_export_reverse_script |
导出可执行的 CadBridge 复刻脚本(改图 / 复刻 / 迭代闭环) |
| 工程日志 | cad_get_activity_log |
查全部工具的调用流水(序号 / 成败 / 耗时 / 线程),纯内存不联网 |
| 工程日志 | cad_export_activity_report |
导出 Markdown 工程工作报告 |
一句话做工业级交付
cad_check_drawing_compliance → 图纸哪里不规范(只读,不改图)
cad_load_template(path="企业模板.dwt") → 按企业规范开新图
cad_reverse_engineer_drawing → 把现有图纸反解析成参数清单
cad_export_reverse_script(path="replay.py") → 导出可复刻脚本
cad_export_activity_report → 导出工程工作报告
实测要点:模板目录由 GetVariable("LOCALROOTPREFIX")+"Template" 运行时解析;
AutoCAD 对不存在的 .dwt 路径会静默建普通新图,所以 cad_load_template
先校验文件存在并显式拒绝;反解析按 Slogan「非图像识别」实现为读 DWG 图元
元数据,不是视觉识图;「按公司名自动匹配制图规范」需要企业自己的规范库,
当前不实现(边界见 docs/limitations.md)。工程日志在
_call(全部 COM 操作的唯一通道)单点埋点,自动覆盖现在与未来的所有工具。
安装
前置条件
- Windows(COM 依赖)
- AutoCAD 2024(其他版本需改 ProgID,见 排错)
- Python 3.10–3.12(不要装到系统 Python 里,插件会在自己的数据目录建 venv)
- DeepSeek Harness
步骤
在 DSH 里安装插件包。装的是本仓库的
bundle-autocad-ui子目录,一条命令即可:dsh plugin --profile web add github:cmm00100/dsh-autocad-bridge#path:/bundle-autocad-ui想改代码再调试的话,克隆下来改成本地路径:
git clone https://github.com/cmm00100/dsh-autocad-bridge.git dsh plugin --profile web add <克隆路径>\bundle-autocad-ui也可以让 Agent 调用
plugin_manager的install_bundle,参数同上。打开 设置 → 插件,确认
autocad-bridge这一行是启用状态。点击侧边栏的 AutoCAD 桥接 图标,点 安装依赖。插件会在
%USERPROFILE%\.dsh\autocad-bridge\下建虚拟环境并装好三个依赖,然后自动启动桥进程。状态灯变绿后,让 Agent 执行
mcp__autocad__cad_connect,即可开始画图。
配置文件落在 %USERPROFILE%\.dsh\autocad-bridge\config.json,虚拟环境在同目录的 .venv。
配置
面板里能改的,都会写进 config.json:
| 字段 | 默认值 | 说明 |
|---|---|---|
pythonPath |
自动探测 | 跑桥的 Python 解释器 |
serverScript |
自动探测 | autocad_server.py 的绝对路径 |
workingDirectory |
自动探测 | 桥进程的工作目录 |
httpPort |
8770 |
桥的 HTTP 端口,须与 MCP 客户端的 url 一致 |
progId |
AutoCAD.Application.24 |
见下表 |
autoStart |
true |
插件加载时是否自动拉起桥进程 |
AutoCAD 版本与 ProgID:
| 版本 | ProgID |
|---|---|
| 2024 | AutoCAD.Application.24 |
| 2023 | AutoCAD.Application.23 |
| 2022 | AutoCAD.Application.22 |
不确定就跑 cad_list_progids,它读注册表告诉你本机到底有什么。
桥自己还有一份 .env(在 bundle-autocad-ui/bridge/),控制超时、重试、默认图层等底层参数,通常不用动。
示例
examples/ 下有三个可以直接跑的脚本,展示这套桥能做到什么程度:
| 脚本 | 产物 |
|---|---|
part-3view.py |
按一张轴测参考图画出零件三视图,A3 图框、2:1、13 个尺寸 |
valve-3view.py |
DN300 工业蝶式阀门三视图,A0 图框、18 个尺寸、明细表、技术要求 |
valve-3d.py |
同一台阀门的 3D 多色装配模型(6 部件 / 6 图层 / 6 颜色) |
跑法:
<venv 里的 python> examples\valve-3d.py
产物写到 examples/out/。运行前请确认 AutoCAD 已启动并处于空闲状态——脚本会往当前活动文档里画东西。

文档
- 架构与设计取舍——为什么是「单 STA 线程 + 命令队列」,为什么分两层
- 掌握的工具语义——AutoCAD COM 那些和官方文档不一致的地方(这份是踩出来的)
- 排错——连不上、卡死、中文变问号、保存失败
- 免责与已知限制
已知限制
- 只能 Windows:COM 是 Windows 独有的。
- AutoCAD 必须是桌面进程:桥会通过 COM 自动拉起
acad.exe(V1.1 已支持 冷启动自动唤醒,实测强杀后约 15 秒恢复),但纯后台静默 COM 仍不稳定, 建议让 CAD 开着界面。 - 模态弹窗会锁死 COM:AutoCAD 弹出对话框时所有调用都会卡住。用
cad_escape发 ESC 解救;cad_status现在能报出队列积压与卡了多久, 长期卡死可用cad_reconnect重建连接。 - 单实例串行:所有 COM 调用排队经过一个 STA 线程,并发调用不会崩,但 也不会更快——AutoCAD 本来就是单线程。
- 不做视觉校验:桥只管把东西画出来。画得对不对、好不好看,得另外看图。 V2.0 的「图纸反解析」是读 DWG 图元元数据(非视觉识图),合规自检也只读 几何与规范数据,都不看渲染像素。
- 企业模板不做「按公司名自动匹配规范」:
cad_read_drawing_standard能读出 一张 .dwt 里的真实规范,但「自动挑出符合某公司制度的模板」需要企业自己维护 规范库,当前不实现(见 限制)。 - 批量导出是串行且无事务回滚:连续导出后 CAD 后台会忙 2~5 秒,
cad_batch_convert用加宽重试窗口兜住,但失败仍需手动清理半成品 (见 限制)。 - 控制面板的像素级渲染未经自动化验证:功能逻辑有 headless 测试覆盖, 但界面外观需要你自己点一下确认(见 限制)。
致谢与相关项目
- DeepSeek Harness——插件宿主
- Model Context Protocol——桥与 Agent 之间的协议
- pywin32——COM 绑定
No comments yet. Be the first to write one.