warehouse-cad-agent

warehouse-cad-agent 是一个 Windows 优先的 Codex 插件和 Python 引擎，用于可追溯的仓库 CAD 往返流程：

1. 审计已声明 DXF 中的每个模型空间实体，或审计其读取 DXF 转换具有匹配哈希收据的 DWG；

2. 将可见设备与结构分开，而不静默接受未解析的候选对象；

3. 编写一份自包含的 Markdown 设备台账；

4. 仅凭空白 CAD 和该台账重建可编辑的 2D CAD；

5. 创建受证据限制的可移植 3D，并在存在完整的来源支持的占地、高度和高程证据时创建原生 AutoCAD 3DSOLID；

6. 让智能体通过五个有界 MCP 工具检查和编辑自动创建的 AutoCAD 工作副本。

该项目刻意不推断缺失的设备身份、高度、高程、流向、端口或制造商几何形状。协议握手、截图、文件存在性检查或输出选择计数均不被视为所请求的 CAD 工件已完成的证据。

公开/私有划分

此仓库仅包含通用引擎、插件、技能、MCP 桥接、合成夹具和验证代码。客户图纸、客户名称、来源哈希、私有分类配置文件和交付证据属于单独的私有集成仓库。

Windows 快速入门

要求：Python 3.11+，以及可选的、带 COM 自动化的完整 AutoCAD，用于实时编辑和原生 DWG 实体。Autodesk DWG TrueView 不是可写的 AutoCAD 运行时。

受管理的 AutoCAD 打开操作仅在 Documents.Open 周围临时使用 DWGCHECK=0，打开后等待 AutoCAD 静默，然后恢复并验证确切的先前值。这仅抑制非 Autodesk 生产者警告，同时保留 AutoCAD 的损坏错误对话框；它并不声明图纸有效。

实时审阅注释创建绝不重试非幂等的 AddText 调用。如果 AutoCAD 在创建某些内容后报告调用失败，桥接会使用写入前的模型空间句柄快照以及类型、插入点和高度，仅恢复一个唯一可归属的新文本实体。该注释、其图层及其注册应用程序属于一个撤销事务。已知字段各自最多写入一次并读回。如果不完整的结果更改了句柄/图层/注册应用程序快照，桥接会请求一次撤销并验证全部三组；如果快照从未更改，则不会撤销或声称回滚。任何未经证明的恢复都会以结构化部分编辑错误保留受管理的工作副本。

已保存/已关闭/已重新打开的验收可以使用由智能体新启动的 AutoCAD 进程。shutdown 会话操作是失败即关闭的：它要求没有受管理的会话、没有控制图纸、零个打开的文档，并确认绑定到应用程序窗口的确切进程已退出。其可选的 force_if_graceful_timeout=true 回退仅限于该由智能体启动的进程：在一次优雅的 Application.Quit 超时后，桥接必须重新确认 AutoCAD 处于空闲状态且零文档，然后才能终止一次已绑定的 Windows 进程句柄。它绝不会退出或终止智能体仅附加到的 AutoCAD 应用程序。

py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\warehouse-cad-agent doctor
.\.venv\Scripts\python.exe examples\synthetic\make_fixture.py
.\.venv\Scripts\warehouse-cad-agent roundtrip examples\synthetic\project.yaml

Codex 仓库市场清单是 .agents/plugins/marketplace.json。将克隆的仓库注册为本地市场，安装插件，然后启动一个新的 Codex 线程：

git clone https://github.com/X-isdoingreat/warehouse-cad-agent.git
Set-Location warehouse-cad-agent
codex plugin marketplace add .
codex plugin add warehouse-cad-agent@warehouse-cad-agent

在该新线程中调用 $warehouse-cad-agent。市场使用 ON_USE 身份验证：以交互方式批准首次本地 MCP 使用。配置了 approval=never 的非交互式会话将发现这五个工具，但除非该调用被明确授权，否则必须拒绝该调用。

project.yaml 是运行允许列表。一个独立的 source.read_dxf 必须包含 source.read_conversion_receipt；未解析的对象只能通过绑定的 source.resolution.inventory 加上 source.resolution.ledger 进行分类。产品审计会枚举文件，但它本身并不是独立的客户验收分母。

空白 CAD 和 Markdown 不被视为可互换的有效文件：空白文件带有嵌入的项目/来源绑定，Markdown 台账还绑定确切的空白文件 SHA-256，并且每次重建都会在写入输出之前拒绝不匹配或已修改的文件对。发出原生实体规格的客户适配器使用相同的精确空白规则，并将先前的来源台账验收目标与当前的原生 CAD 产品目标分开。

当前验证限制

合成空白 + Markdown + 隔离 2D + 可移植 3D 路径以及一次全新的 Codex/MCP doctor 调用已在本地执行。在一个确切的合成 DWG 上，已安装的插件还通过了真实 AutoCAD 2027 Trial 的创建/查询/回滚/保存以及新进程重新打开对账。一个确切的、私有的、哈希绑定的仓库 DWG + 设备台账来源集还通过了原生 3DSOLID 生成、最终 DWG 保存、版本匹配的 ObjectDBX 重新打开、记录级智能体身份/几何对账以及真实 AutoCAD 2027 Trial 中的最终结构对账。这些是狭窄的来源集结果，而不是任意 DWG、制造商模型、BIM 或生产就绪性的声明。doctor 区分已安装/活动的完整 AutoCAD 身份与当前足够空闲以接受自动化的进程；它不推断付费或试用权利。当原生实体规格仍绑定到来源空白 DXF 时，AutoCAD 仅打开单独提供的运行时 DWG，其转换收据绑定两个哈希，并证明零不匹配的流式 DXF→DWG→DXF 结构比较。TrueView 不满足该门槛。

产品边界

在做出能力声明之前，请参阅 docs/PRODUCT_BOUNDARY.md。可移植的 DXF 3D 是审计衍生物；原生工程 3D 主文件是包含由完整 AutoCAD 根据来源支持的证据生成的、可重新打开且可测量的 3DSOLID 对象的 DWG。

许可证与署名

Apache-2.0。COM/MCP 设计借鉴了 Apache-2.0 的 multiCAD-mcp 项目；请参阅 NOTICE。