Luomu CAD

Luomu CAD 提供 CAD 方法组合、语义结构独立评测与 CadQuery / IfcOpenShell / FreeSewing 原装内核入口。参见技术组合和运行方式。

日期：2026-11-14

摘要　由 luomufanye-cloud 编写并维护的通用CAD辅助Skill，供Agent进行图纸读取、参考复绘、离线DXF生成、局部修改、图纸检查及技术资料学习。当前版本为 0.16.0，包含多模型独立审查、共享 CAD 任务协调和操作授权记录，并保留28类行业图种与标准隔离、13类专业配置、Luomu CAD 构件库、共享房间图册及原生DWG对应验收。各行业工程交付与图片识读须按实际任务取证验收。作者 · 更新记录 · 本版实际验证与边界 · 专业能力

0.16.0 更新

• 多模型独立审查：新增 CodeBuddy 项目与个人角色，子代理继承当前模型；后台支持 CodeBuddy，Codex 后台也可传递主会话临时选择的模型。已实测 HY4、HY3、DeepSeek、GLM 原生启动及模型继承，HY4、GLM 另完成后台证据审查。
• 共享 CAD 任务协调：参与的 MCP 服务可以持有任务占用，分别记录编辑、切图、保存、关闭和导出授权，后续明确指令按修订更新。
• 审查状态比较：文档身份、实体数、快照指纹或已知保存状态改变时更新证据；仅计数相等不能证明图纸未变。
• 安装与近期项目经验：更新角色安装、包完整性检查和多页 A3、局部复绘、纯设计任务指引。协作机制只覆盖已接入的适配器，记录比较不代替实时回读或客户验收。

完整源码及 WorkBuddy 安装包见 0.16.0 正式发布。

三维机械与产品零件可使用实体建模与量测验收，接入独立实体运行时，核对原生特征、四视图与原坐标修改体积；按任务需要安装。

实际绘图和交付以项目标准依据为基础：跨行业索引提供候选，项目核实地区、专业、版本及条文，再关联实际检查证据。完整复绘交付检查要求标准依据记录；题录入库不代表全文合规或专业批准。

作者与许可证

作者与维护者：luomufanye-cloud。 本项目自有源码、CAD业务规则、MCP适配器、Skill工作流及训练脚本由作者开发并维护，采用MIT许可证开源，版权署名为Copyright (c) 2026 luomufanye-cloud。

项目使用的第三方基础库在安装时作为依赖准备，各自遵循其许可证，见依赖说明。项目署名不改变这些依赖或所引用资料的权利归属。

功能

• 共享项目与图册联动：统一房间完成面、墙体宿主、门窗、柜体、标高与材料编号，生成平面、地面/天花完成面、墙面立面、定向剖面及有目录/书签的PDF图册；记录修订和受影响图页。当前不包含19类完整施工图。

• 可调用执行工具：源清单复绘、圆弧墙与弧长洞口、指定纸张和比例的矢量PDF；另提供显式CAD启动及新路径DWG另存MCP接口。

• PDF表现转换：按实测字形匹配文字，保留纸面线宽、颜色、透明度与填充孔洞；检查实际运行版本和同背景图面对照。

• 复绘源图检查：独立源对象清单、输出映射及当前图面对照记录共同验收，检查缺项、曲线弧向、线型和中文映射；局部结构自检不等于完整复绘。

• 家具摆放关系：按明确的背墙、间隙和旋转检查靠墙位置，核对使用区域；独立摆放须说明功能依据。

• 模型调用与交付检查：固定活动CAD/离线文件目标，保留原始工具错误；检查带家具任务的配置、通行区域和实际图纸内容。

• 根据明确位置和尺寸生成可编辑家具、厨卫设备简化图块，检查其与墙、门扇、通道及所属房间的几何关系。

• CAD参考图读取与核对：读取图纸单位、嵌套图块和文字，核对构件的位置、方向，以及分段尺寸与总尺寸是否一致。

• 按明确的毫米参数生成直线墙体、门窗、中文房间标注、原生尺寸、门窗表、A3/A1模型空间图框及PNG预览。

• 在独立副本中修改指定门窗，刷新其宿主墙、尺寸和关联表格，核对其他对象的实体哈希；原文件保持不变。

• 回读DXF检查零长度、重复线、自交及尺寸覆盖，并实测生成门窗的宽度和开洞。

• 中文显示与尺寸界线：配置字体文件和字体族，检查中文映射与短界线参数；保留真实测量，按目标比例控制留白，并在目标CAD查看原生显示。

• 参考复绘按忠实复绘流程核对原生尺寸、显示文字、声明的样式/文字位置及内容清单；局改按基线哈希检测范围外变化和额外新增，保护前轮修正。

• 栅格复绘与交互检查：明确未定尺源坐标，检查构件范围、线稿复杂度和门的几何关系；只读性能快照与实际操作反馈分开记录。

• 根据给定的房间范围、家具尺寸和通行净距，辅助计算矩形家具布局，并避开指定的出入口及通道；支持的形状和计算条件见布局工具说明。

• 通过Scrapling解析公开资料，记录来源、时间、图注与文档链接，去重、检索并蒸馏经审阅的工作方法。

• 提供节点构造、施工工序、材料参数和专业系统的技术资料与练习，支持工序顺序、参数适用条件和端子连接检查，见专业主题与验证范围。

• Windows下通过本项目MCP服务端附着已运行的AutoCAD，读取文档和实体；写入需显式会话开关、文档身份及操作ID。

安装到Agent

本仓库同时提供默认独立验收子代理 luomu-cad-reviewer、分行业交付分类和客户需求绑定检查器。正常安装验证入口会配置项目级原生子代理；对另一个客户项目可传 -AgentProjectRoot 指定目录。角色安装、宿主发现和真实独立审核分别记录，支持情况见安装说明。客户交付须逐项通过，不以绘图工具返回成功或CI通过代替验收。

柜体的平面、正立面和侧剖可通过共享尺寸多视图生成并回读。明确柜高是否包含收口，核对跨图尺寸和原生标注；提供板厚时绘制选定格板件剖面。此入口不承担五金加工或整套室内施工图。

使用完整仓库安装通用Skill，按Agent宿主的能力选择资料阅读、离线制图或MCP工具调用。参考阅读无需安装依赖；python scripts/preflight.py检查环境，python scripts/verify_tasks.py验证可复现的文件与知识卡任务。安装步骤和运行条件如下。

本仓库支持作为文件夹形式的Skill安装。Agent需要能读取Skill文件、执行本机命令，并允许启动子进程。不同宿主的Skill目录、刷新方式和MCP配置格式各有区别，安装Skill不会自动为所有宿主注册MCP。

1. 下载完整仓库ZIP并解压，或克隆整个仓库。将包含SKILL.md的根目录命名为luomu-cad，放入Agent宿主指定的Skill目录；不要再额外嵌套一层同名目录。
2. 保留完整仓库，尤其是SKILL.md、scripts、src、references、examples、pyproject.toml和uv.lock。只复制SKILL.md或只安装Python包，不能替代完整Skill安装。
3. 按宿主要求刷新或重新加载Skill，让Agent读取SKILL.md，然后运行下面的一条安装验收命令。
4. 需要在宿主中直接调用工具或操作活动AutoCAD时，再按MCP接入说明配置随包服务。

运行条件：

基础离线功能也可在Python 3.11/3.12的其他系统上使用uv运行；run.ps1自动入口面向Windows，其他系统与各宿主的完整安装流程尚未逐一验收。

可以把这段话交给Agent：

将 https://github.com/luomufanye-cloud/luomu-cad 安装为luomu-cad Skill，保留完整仓库。读取SKILL.md，运行scripts/run.ps1 -Action verify，检查最终ok=true和进程退出码0，报告实际输出位置。需要宿主MCP时合并生成的runtime/mcp-config.json服务条目；需要操作AutoCAD时再核对references/usage.md的连接与授权条件。

一条命令验收安装

在技能根目录运行：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\run.ps1 -Action verify

该命令先准备独立环境，再经真实stdio MCP完成服务检查和示例出图，重新读取生成的DXF、核对几何和产物哈希，并检查PNG是否有效。它不连接或修改AutoCAD；相同软件版本和输入重复执行时复用经过哈希核验的自检产物，不重复叠画。

成功应同时满足：进程退出码0、最终JSON的ok=true、checks中的artifact_hashes/dxf_readback/preview_file均为PASS。报告位于runtime/verification/installation.json，示例结果位于返回的artifacts路径。图面人工检查和专业审核仍分别标记，不由安装验收自动判为通过。

命令还会生成当前电脑的runtime/mcp-config.json，包含绝对路径及默认关闭活动CAD写入的环境设置。使用mcpServers JSON格式的宿主可合并其中的luomu-cad条目；其他宿主取其中command、args、env按其格式填写。保留宿主原有其他服务，勿整份覆盖已有配置。配置含本机路径，应留在本地。

从其他目录运行时，把-File后面的脚本换成完整路径即可；-Action generate的相对Spec路径按技能根目录解释，外部项目输入使用绝对路径。

首次自检与离线示例

在包含SKILL.md的技能根目录打开PowerShell，依次运行：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\run.ps1 -Action health
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\run.ps1 -Action generate -Spec .\examples\two-room.json -Job demo-001
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\run.ps1 -Action research -ResearchAction status

health成功时应返回ok=true、transport=stdio-mcp，以及当前安装目录下的output_root；它不会连接AutoCAD。generate成功后，outputs/demo-001下应有plan.dxf、preview.png、spec.json、qa.json和manifest.json，结果中的几何检查应为PASS。图面仍需查看，专业设计仍需对应审核，不能只凭文件存在认定交付通过。

重复生成同一job和输入时只返回已提交结果；同名不同参数拒绝执行。示例尺寸均为示范设计采用值，不能当作现场实测。相对Spec路径按技能根目录解释，外部项目输入使用绝对路径。

不支持在界面中配置MCP、但允许执行本机命令的Agent，可以通过scripts/entry.py使用随包真实stdio MCP完成离线工作。CLI单次call默认只读；活动CAD连续读写需要持久MCP会话，不能绕过服务直连COM。配置模板和写入条件见使用说明。

范围与来源

Luomu CAD 维护墙体与开洞生成、任务事务、局部编辑、MCP服务和AutoCAD桥，并提供组件、几何检查和求解模块。组件代码的版权与许可见第三方声明，安装依赖及资料说明见依赖说明。

当前支持中心轴直线墙、门窗、家具关系检查、圆弧墙与按弧长定位的洞口；矢量PDF提取读取源对象、实际字形、复合填充与裁切，再按源清单统一构建可编辑DXF。支持固定纸张/比例PDF和显式CAD启动、新建、打开、原生预览、DWG另存及重开验证。各项输入见执行工具。

PDF提取使用明确的两方向校准和实际字体映射；扫描图缺失的真实尺寸不能从像素唯一恢复。提取结果保留几何与表现，原生尺寸等CAD语义按独立清单重建。IFC 接口支持构件、洞口关系及几何回读，完整 BIM 项目编制和原生插件仍需对应实现与验证。专业规范符合性需要逐项依据和审查证据。资料索引、图面核对与专业审查分别记录，案例参数按来源和工况采用。

默认的资料读取和离线任务不操作活动CAD。明确的启动任务通过cad_start执行，已有实例复用；DWG另存采用新路径并返回新文档token。没有任意LISP、原始命令或桌面控制入口。原生验收脚本实际执行创建、回读、预览、保存、关闭和重开，并保护原有文档。2026-11-07已在本机完成启动、原生圆弧/尺寸、DWG另存重开与原生预览；软件回归与宿主模型的任务验收分别记录。

0.2.1增加墙地防水连续性原理训练：生成并回读原生DXF示意，识别断点与缺失上翻。它使用无工程单位的任意坐标，不构成施工节点设计。

安装支持与故障排查

支持入口：提交安装或使用问题。先运行-Action verify并保留实际错误；自检失败时会返回非零退出码，不能只看到依赖安装完成就认定Skill可用。

反馈请提供软件版本、Windows版本、Agent宿主及版本、完整执行命令、最终错误和必要日志。日志中的个人路径、客户信息或凭据先脱敏，私人图纸无需作为默认附件。项目支持按下述已验证路径说明，不承诺未验收的所有Agent和CAD版本具有相同表现。

开发与验证

0.3.0新增风盘安装与计算训练：依据选定厂家手册进行毫米吊杆定位、冷凝水提升/坡度/空间错误题与换型号题，并完成给定水侧换热率的流量、流速、普通阀阻、给定阻力扬程及温差变化练习。脚本和训练场景为本项目自行编写，原PDF和图页不随包分发；两项技术卡仅在明确练习范围内达到exercise_checked。

.\.venv\Scripts\python.exe -X utf8 scripts\train_fan_coil.py

图纸、预览与逐项结果写入runtime/training/fan-coil-installation。参数出处、自拟训练输入、完整演算与尚未覆盖的能力均在对应记录中列明，不把运行脚本等同工程项目验收。

截至2026-11-05，0.3.1的安装验证范围如下：

这些证据支持“满足条件后可运行离线功能”，不支持“任意Agent下载后零配置完成全部CAD操作”。原始验证日志与生成产物保留在维护者的私有runtime目录，不随公开仓库分发。

此前已验证离线出图、门窗局改及中文样图。0.2.0新增技术知识卡和限定练习，首批为厨卫防水及接地系统，见实际技术学习记录。0.1.1从实际原文与三张图中新增两条方法，并增加四个布局回归用例和真实MCP拒绝检查，见学习与应用记录。

uv sync --python 3.11 --extra dev --no-editable
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe scripts\build_release.py

发布包只包含源码、示例参数与必要参考；不包括本机图纸、采集数据库、预览缓存、登录数据、环境变量或历史日志。MIT许可仅覆盖本项目代码，不授予第三方资料的再分发权。

相关链接

Skill入口 · MCP与使用范围 · 资料研究 · 依赖 · 许可证

门窗与家具组件

Luomu CAD 构件库提供墙体切洞和二维组件生成函数，按源图选型、设置宿主墙与开向，并回读门墙连接。入口和实际验证范围见构件库说明。