DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

cmm00100 /

cmm00100/dsh-autocad-bridge

Topic repository only

把本机 AutoCAD 2024 变成 DeepSeek Harness Agent 的一双手:Cordis 插件托管 Python MCP 桥进程,18 个 cad_* 工具

★ 2 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@a536d460

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 三视图输出示例


它解决什么问题

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

步骤

  1. 在 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,参数同上。

  2. 打开 设置 → 插件,确认 autocad-bridge 这一行是启用状态。

  3. 点击侧边栏的 AutoCAD 桥接 图标,点 安装依赖。插件会在 %USERPROFILE%\.dsh\autocad-bridge\ 下建虚拟环境并装好三个依赖,然后自动启动桥进程。

  4. 状态灯变绿后,让 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 已启动并处于空闲状态——脚本会往当前活动文档里画东西。

DN300 蝶阀 3D 模型


文档

  • 架构与设计取舍——为什么是「单 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 绑定

许可

MIT

—/ 5

No ratings yet

Manifest verification required

Commit a536d460bf54

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout