CAD Agent Foundation

CAD Agent Foundation — AutoCAD MCP 与 AI Agent 命令行工具

公开运行时预览版 v1.2.0-beta.3。 支持代理／复合几何图形和文本读取、有界原生视图／捕获、栅格路径修复、拒绝分类和多段线宽度修复。复用已验收的 beta.3 二进制文件；范围、已知捕获限制和升级说明。

可选的道路解读： Agentic Map Tracing v0.1.0-beta.1。Agent 负责推理边界；Foundation 提供 CAD 执行能力。需单独安装。

第一优先级：为能力日益增强的 Agent 提供可靠操作

基础层开发服务于实际任务。提供小巧、可靠、受控的 CAD 基础图元和真实反馈，让 Agent 能够行动并推进工作。视觉判断、结构解读、示例学习、模式识别和最终审查均由 Agent 负责。不要将这些判断转化为程序、拟合算法或强制验证工作流。除非明确要求，否则不要添加附带功能。若现有基础图元已足够，且 Agent 判断结果可接受，就继续主要任务。保留图纸身份、保护源文件，并且不要重放未知写入操作。

本地单元收尾：1.2.0-local.4 包含此前范围受限的基础图元；对原始坐标方案，INSUNITS 一致性检查改为可选，同时保留旧版米制接口。此预发布版以 v1.2.0-local.4 发布；早期版本仍可用。参见单位、精度与纸面排版；这并不代表对 A–P 的全面认证。

Agent 优先的 AutoCAD MCP——为执行循环而构建，而不只是调用命令。 CAD Agent Foundation 帮助 AI Agent 绑定正确的图纸、跟踪每项请求、接收执行反馈、核验写入或保存的内容，并有把握地继续多步骤 CAD 工作。独立或第三方 CAD Skill 可复用这一执行基础层，支持其各自的专业工作流。

中文简介：面向 AI Agent 的 CAD 执行底座——不止调用命令，还关注图纸绑定、执行反馈、结果核验与安全续作，可与第三方专业 Skill 组合使用。

CAD 集成将 AI 接入图纸命令和数据，而 Foundation 专注于围绕每项操作的 Agent 工作流：明确请求内容、实际发生的情况，以及下一步是否安全。

公开运行时预览版 v1.2.0-beta.3。 发布与升级说明。本预览提供源代码、文档以及包含清单的 Windows 运行时 ZIP 文件。构建前提与限制。已验收的本地运行时 v1.0.0-local 是独立基线。配套 Skill 预览版独立发布：callout v0.3.0-rc.1 和 distress v0.1.0-rc.1。

简体中文 · 快速入门 · 功能 · 兼容性

已注册的 MCP 服务：io.github.capskov/cad-agent-foundation。MCPB 安装与发现 · 注册表元数据。仍需满足本地 Windows/AutoCAD 前提；注册不会授予图纸访问权限。

通过 MCP 和 CLI 使用原生 .NET API 为 AI Agent 提供 AutoCAD 自动化桥接。

AI Agent 可以通过结构化原生工具检查和操作正在运行的 AutoCAD 图纸，支持范围受限的 2D 几何图形、文本、填充图案和标注。该桥接使用 MCP（Model Context Protocol）和 CLI；图纸身份检查以及写入/保存核验用于约束受支持的操作。

CAD Agent Foundation 为 CAD Agent 提供范围受限的执行约定：明确绑定图纸，持久保存请求归属和执行状态，在收到不确定的回复后检查原始请求，并在写入和保存后核验受跟踪的对象信息。当前实现将这些机制集成到经过修改并固定版本的 Bimwright DWG MCP 主机中。

此 Windows/AutoCAD 桥接由 capskov 维护。当前预览版为 v1.2.0-beta.3，并附带独立构建的运行时 ZIP 文件和范围明确的原生证据。已验收的 v1.0.0-local 基线予以保留；不声称兼容所有 AutoCAD 更新。

此项目的由来

本项目源于道路与土木工程 CAD 工作：创建边界、填充、工程量和关联引线，然后在长时间的 Agent 会话中反复修改并保存。实用的绘图命令只是工作流的一部分。Agent 还需要知道自己正在操作哪个图形、某项修改是否已执行、哪些内容仍未验证，以及再次尝试是否会造成重复。

设计重点在于这些决策。持久化记录、图形身份识别和原生回读会增加开销；目前尚未证实其在速度、令牌成本或生产力方面具有比较优势。工程判断和特定领域的布局规则仍由单独的 Skills 负责。

原生操作与安装

下载 v1.2.0-beta.3 runtime，验证 SHA256SUMS.txt 并解压完整文件夹。需要已授权且兼容的 Windows x64 AutoCAD 2026、.NET 8 Desktop Runtime 和 Python 3.11+。不重新分发 Autodesk 程序集或 SHX 字体。安装说明 · 25 项操作目录 · 新增验证。

本预览版新增：已安装字体的文字样式、标注样式、原生线性／对齐／半径／直径 DIMENSION、图层状态管理、受保护的闭合边界／填充续接、关联引线几何／格式，以及在同一图形中旋转／缩放／复制受支持的完整组。它保留了原始请求核对和图形／对象保护机制。

当前能力概览

成熟度：受限的本地运行时已有原生验收证据；此版本提供运行时 ZIP，其中包含依赖项许可证、文件哈希和插件 MVID；前置条件仍需单独安装。支持范围以实际公开的能力配置为准。

类别	当前能力	状态／限制
基本绘图	新建图层、直线、圆、二维多段线，以及对较早创建的新边界进行关联填充	已验证指定的本地工作流；不支持任意编辑／所有填充情况。
文字与引线	单行 DBText、多行 MText、普通 LEADER／MText／黄色实心圆点组	已验证创建；完整领域样式／放置规则由 Skill 负责。
编辑／对象管理	受摘要保护的关联文字更新，以及完整引线组移动／归档	已验证指定的组工作流；并未逐一测试所有实体分支。
执行／交付	图形绑定、原始请求查询、防重复保护，以及整篇文档保存／磁盘回读	已验证本地工作流；不支持自动重放未知写入／解锁。
读取／辅助工具	实体属性／摘要、图层列表、筛选分页和静态 Lisp 检查	已验证实体回读；其他一些已实现路由缺少当前版本的独立端到端证明。
其他受限操作	四种原生 DIMENSION 类型、命名匹配样式、图层状态、闭合边界／引线更新、旋转／缩放／复制	具体保护条件和限定范围内的原生证据请参阅 25 项操作目录。
未公开	MLEADER、共享样式覆盖、任意对象编辑、复杂布尔运算／孔洞、布局／打印／外部参照编辑	不涵盖所有原生对象或上游命令。

完整接口、调用方式和逐项验证状态。Foundation 提供可复用的原生操作、执行约束、状态和对象管理。独立维护的 Skills 通过实际受支持的 Foundation 接口提供领域规则、样式参数、放置算法和工作流。仅安装 Skill 并不能弥补缺失的原生／后端兼容性。

执行约定

绑定预期的图纸，并核实进程／会话／插件身份。提交前持久化稳定的请求；收到不确定的回复后，查询原始请求。现有编辑需要新的原生摘要和完整关联。分别确认效果、独立回读和围栏释放；保存会影响整个工作图纸。请参阅架构和版本化接口目录。

按任务选择组件

任务	必需组件	版本和限制
支持的基础 CAD 操作	仅 cad-agent-foundation	本地基线版本为 v1.0.0-local；公开源码预览版为 v1.1.0-rc.1，并附带经过审查的运行时 ZIP；前置条件需单独满足。有限的 2D 操作；local.4 原始写入使用原始图纸值；单位元数据检查为可选；仅在有记录的 Windows／AutoCAD 2026 主机上测试。无需任何 Skill。
本项目的引线标注样式和放置方式	Foundation + cad-callout-pair-layout	公开引线标注 Skill 版本为 v0.3.0-rc.1（现有规则版本为 v0.3）。采用基于米的道路默认值；v1.1 中已验证原生样式／姿态接口以及一项范围有限、合成且未更改 Skill 的集成；完整的真实项目／背景覆盖仍需按任务确认。写入前请检查后端覆盖情况。
本项目的病害／拆除工作流	Foundation + cad-distress-annotation + cad-callout-pair-layout	公开病害规则预览版为 v0.1.0-rc.1。需要工程证据、分类和引线标注规则；完整工作流需要当前 Foundation 配置之外的功能，且仅凭这三个组件无法获得认证。

对于基础操作，这两个 Skill 都是可选的。它们的规则未内置于 Foundation；安装它们不会补足缺失的原生操作。Foundation 源码和两个独立 Skill 预览版均为公开内容。安装条目、版本和 Agent 检查。

快速开始

以下命令使用解压后的运行时 ZIP。仅检出源码时，必须先进行构建／打包。

foundation.cmd install --workspace "C:\CAD-work\demo01"
foundation.cmd start --workspace "C:\CAD-work\demo01" --source "C:\drawings\input.dwg" --write
foundation.cmd doctor --workspace "C:\CAD-work\demo01"
foundation.cmd apply --workspace "C:\CAD-work\demo01" --plan "plan.json"
foundation.cmd save --workspace "C:\CAD-work\demo01" --handles RETURNED_HANDLES
foundation.cmd stop --workspace "C:\CAD-work\demo01"

只读会话请省略 --write。start 会创建工作副本，不会覆盖源图纸。保存会影响该实例中整个工作图纸，包括其他尚未保存的编辑。请阅读快速开始，了解请求处理方式和一个小型合成方案。

验证和范围

本地版本已在两个坐标和句柄各不相同的图纸源上进行检查。每个工作流都创建了十个新对象、独立读取这些对象、更新关联文字、移动完整的引线标注组、归档该组、保存并关闭图纸。随后，新建的 CAD 会话读取了已保存的对象，且原生摘要相符。CLI／MCP 入口以及本地软件包的解压／安装也经过了检查。

这些是在有记录的 Windows AutoCAD 2026 环境中取得的有限工作流结果。它们不能证明图纸普遍正确、生产环境整体可靠、兼容所有补丁，也不能证明这是通用 CAD 工程 Agent。验证摘要将原生证据与离线测试分开，并如实记录尚未解决的历史结果。

当前限制

图纸只能写入有界的二维模型空间几何图形。坐标、长度和标注大小均以绘图单位表示。WCS 是 CAD 坐标参考系；它不意味着单位为米，也不代表地图投影。Foundation 不执行投影或单位转换。

**Local 1.2.0-local.4 使用原始绘图值：**优先使用 units: raw_drawing_units，只有在需要确保请求的元数据一致时才选择性设置 expected_insunits。未知或无单位的元数据不会阻止常规原始值操作。旧版 units: metres 保留原有的 0/6 元数据约定。不会进行坐标转换、自动几何缩放或 INSUNITS 更改。请参阅单位、精度和纸面排版；PDF/DXF 输出仍有各自当前的限制。

此版本提供四种原生标注图元，以及有界闭合边界和单个填充图案更新。不提供 MLeader、通用旧填充图案修复／布尔运算／孔洞处理、任意多段线属性、跨图纸复制、代理对象语义、布局／打印、工程决策，或对不确定写入的自动恢复／解锁。不能因为后续验证失败，就假定已提交的操作已回滚。

已在 AutoCAD R25.1.74.0.0 上检查 .NET 8 本地基线。AutoCAD 2026.1.2 引入了 .NET 10 迁移；尚未在此验证与该更新版宿主的兼容性。请参阅兼容性和Autodesk 运行时更新。

独立 Skills

请参阅匿名道路拆除案例，了解现有的前后对比图纸以及工程量／桩号参考。该案例展示了配套 Skill 的输出，并不证明仅使用 Foundation 即可执行完整工作流。

独立 Skill 仓库和安装说明：

• cad-callout-pair-layout：引线标注样式、道路侧约束和有限的放置预算；包含可选的双语 BZYD 手动 Lisp。安装 · v0.3.0-rc.1。
• cad-distress-annotation：基于证据的道路病害／拆除边界和工程量规则。安装 · v0.1.0-rc.1。

Foundation 提供受支持的 CAD 图元及其执行约定。Skills 决定绘制内容、布局方式以及采用哪些领域检查。Foundation 不会确定植物种类、病害处置方式或工程量。

引线标注技术也可用于景观种植及其他分类图纸标注。现有 Skill 经测试的规则和默认值基于以米为单位的道路图纸；其他专业领域或以毫米为单位的图纸需要调整样式、大小和放置方式，且未经此处认证。

两个仓库均提供带版本号的公开 Skill ZIP 文件和手动安装指南。Foundation v1.1 新增了原生样式／姿态／测量接口；新的验证记录了一个合成的、Skill 未更改的求解器集成示例，但这并不等于对所有真实项目的认证。尚未认证完整的仅使用 Foundation 的 Skill 工作流。Callout v0.3.0-rc.1 和 distress v0.1.0-rc.1 仍独立进行版本管理。请参阅兼容性。

与其他工具协同工作

Agent 可以单独使用其他 MCP 服务或 CAD 工具。只有通过 Foundation 提交的受支持操作才会进入其受治理的请求、执行和验证流程。无关的后端不会自动共享其事务、请求标识或围栏。切换工具并不能绕过尚未解决的写入。要全面覆盖外部后端，需要进行明确的集成；当前基线不提供此功能。请参阅 Foundation、技能和其他工具。

上游项目与许可

AutoCAD 2026 是首个经过验证的宿主，因为它与工作环境及采用的原生插件方案相符。本地 .NET 8 基线使用文档锁定、事务和原生回读；2025 也有 .NET 8 宿主，较早的版本则提供自动化 API。MCP 来自桥接层。请参阅 选择 2026 的原因。

集成的宿主源自 Bimwright DWG MCP，固定在 4d0f756。请保留其 Apache-2.0 许可和署名。其他经审查的项目会单独致谢，不与实际复用的代码混为一谈；请参阅 背景与相关项目。

开发过程注重实用：根据实际任务考察现有 CAD MCP 后端，将范围明确的执行约定集成到选定的原生宿主中，然后检查写入、原生回读和保存的图纸。对历史评估会说明其适用范围，而不会将其作为对当今项目的排名。

此预览版采用 Apache-2.0 许可，并保留上游项目及源自 MIT 的声明。较早的 v1.0.0-rc.1/rc.2 源码和文档版本仍予保留；v1.1.0-rc.1 新增了附带依赖项许可文本、经过审查的运行时 ZIP。AutoCAD/SDK 和未获许可的 SHX 资源不予再分发；Open Sans 仍采用 OFL 许可。请参阅 许可决定和声明。

欢迎提交人工和 AI 辅助的贡献，前提是更改和验证证据可供审查。维护者负责审查合并和发布。请参阅贡献指南。

AutoCAD 和 DWG 是 Autodesk 的商标。本独立项目不受 Autodesk 或上游维护者认可。

2026-10-16 本地字体更新

本地版 1.2.0-local.3 新增了受保护的现有样式 SHX 字体配对替换，以及保留锚点的 DBText 度量缩放。请参阅范围和参数。原生证据仅适用于特定范围；以往公开版本和全局 MCP 注册均未更改。

本地版 1.2.0-local.4 单位收尾：更改、原生证据和限制。原始本地收尾版本现已获准在 GitHub 上作为预发布版本发布；请参阅当前发行说明。