| name | autocad-automation |
| description | AutoCAD 自动化技能。用于让 Codex/Claude 在 Windows 上通过 Python COM/ActiveX 直连本机 AutoCAD 进行二维绘图、图层/文字/标注/块处理、DWG/DXF/PDF 导出、批量修改、工程图自检，以及在 COM 不足时切换到 AutoLISP/SCR 或 AutoCAD .NET 插件路线；当用户提到 AutoCAD、CAD、DWG、DXF、画图、出图、图层、标注、块、批量改图、AutoLISP、ObjectARX、.NET 插件、Codex 接入 CAD 软件时都应优先使用。 |
| metadata | {"os":["win32"],"requires":{"anyBins":["python","py"],"pythonPackages":["pywin32"]}} |
AutoCAD 自动化技能
本目录作为 solidworks-automation-skill 的 AutoCAD/DWG 子技能使用。父技能负责 SolidWorks 建模、装配、工程图和三维导出；本子技能负责 AutoCAD 二维 DWG/DXF 绘制、批量改图、线稿矢量化、出图预览和图纸自检。涉及 SolidWorks 原生零件/装配体建模时回到父技能，涉及 AutoCAD 图纸或 DWG/DXF 时读取本子技能。
目标
让代理在本机 Windows 桌面环境中可靠控制 AutoCAD，而不是每次凭记忆临时拼命令。默认路线是 Python + COM/ActiveX 直连正在运行或新启动的 AutoCAD.Application，并且默认把 AutoCAD 窗口切到前台、逐步绘制，让用户能直接看到画图过程；适合快速建图、批量修改、导入导出和检查 DWG。遇到 COM 无法稳定表达的事务、动态交互、复杂数据库遍历或企业级部署时，再切换到 AutoLISP/SCR、AutoCAD .NET、ObjectARX 或 APS Design Automation。
适用场景
使用本技能处理：
- 新建或修改 DWG/DXF 图纸，绘制线、圆、圆弧、多段线、矩形、文字、块、图层和简单标注。
- 批量打开 DWG，检查图层、实体数量、文字、块参照、外部参照或输出文件。
- 让 Codex 直接连接本机 AutoCAD、保存 DWG、导出 DXF/PDF，并生成复核报告。
- 编写 AutoLISP、
.scr 命令脚本或 C# AutoCAD .NET 插件。
- 需要查 Autodesk 官方 API、ADN/GitHub 示例、ObjectARX SDK 或 APS Design Automation 模式。
不要把本技能用于纯渲染效果图、BIM/Revit 模型、机械 STEP-first 建模、CAM 刀路或工程认证结论；这些需求优先转给相应 CAD、BIM、仿真或制造流程。
默认假设
- 操作系统：Windows。
- AutoCAD：用户本机已安装，最好已手动启动一次完成 COM 注册。
- 自动化入口：
AutoCAD.Application COM ProgID。
- 可视化默认：新建绘图任务默认先显示并激活 AutoCAD，再逐步落图元；只有批处理或用户明确要求提速时才关闭。
- 绘图单位：默认按毫米理解；AutoCAD 数据库本身是无单位数值，必须在图纸说明中记录单位。
- 空间：几何默认进入 ModelSpace；版面、标题栏和打印配置单独处理。
- 坐标：默认 WCS，二维对象使用
Z=0。
- 输出：优先保存 DWG，同时按用户需求导出 DXF/PDF；所有输出路径使用绝对路径。
- 文件安全：修改既有 DWG 前先另存副本，除非用户明确允许覆盖。
缺少版本、单位、图纸标准、输出路径或是否允许覆盖时，先做一次简短确认。简单草图可以直接假设毫米、ModelSpace、新建 DWG，并在结果中说明。
入口自检
执行 AutoCAD 自动化前先运行：
python subskills\autocad-automation\scripts\acad_preflight.py
如果用户允许自动启动 AutoCAD：
python subskills\autocad-automation\scripts\acad_preflight.py --launch
自检失败时：
- 缺
pywin32：提示用户安装 python -m pip install pywin32，得到明确同意后再安装。
- 找不到 AutoCAD COM：提示用户安装 AutoCAD、启动一次 AutoCAD，或确认安装的是 LT/受限环境。
- AutoCAD 已运行但无活动文档：可以新建文档，不要误判为连接失败。
核心工作流
- 分类任务：判断是新建图纸、修改既有 DWG、批处理、出图导出、API 开发、插件开发还是故障排查。
- 确认关键约束：单位、版本、目标文件、输出格式、是否允许覆盖、图层/线型/标注标准、是否需要按企业模板绘图。
- 运行自检：先用
acad_preflight.py 确认 Python COM 和 AutoCAD 状态。
- 查证 API：未封装 API 必须先读
references/api-lookup.md，再查 Autodesk 官方文档或可信 GitHub 示例；不要猜长参数、枚举值和命令行为。
- 制定绘图计划：写明图层、坐标基准、对象清单、尺寸、文本、输出路径和复核点。
- 先把软件拉起来：连接或启动 AutoCAD，确保窗口可见并尽量切到前台，再开始落图。
- 优先复用脚本：简单几何用
scripts/acad_draw.py 的 JSON 输入；复杂逻辑用 scripts/acad_session.py 组合 COM 调用。
- 串行执行 COM：AutoCAD 桌面 COM 操作不要并行；一个脚本连接、逐步绘制、保存、复核后退出。
- 保存和导出：保存 DWG/DXF/PDF 前确保目录存在；修改原图时保留备份或另存。
- 复核结果：运行
scripts/acad_review.py 统计实体、图层、包围盒和目标文件；再运行 scripts/acad_preview.py 导出 AutoCAD 原生 BMP/PNG 预览，并用图片查看工具做视觉审查。窗口截图可作为补充，但若被其它窗口遮挡，不可作为通过依据。
- 沉淀经验：遇到新坑、命令差异、版本限制或稳定封装，补进
references/troubleshooting.md 或脚本。
Codex 直连绘图
简单任务可让 Codex 生成一个绘图 JSON，然后调用：
python subskills\autocad-automation\scripts\acad_draw.py `
--input C:\temp\plate_plan.json `
--output C:\temp\plate.dwg `
--new
这个入口默认是“可见逐步绘图”模式：会先打开或切到 AutoCAD，再一点点把图元画出来。只有批量任务、回放太慢或用户明确要求快时，才加 --fast：
python subskills\autocad-automation\scripts\acad_draw.py `
--input C:\temp\batch_plan.json `
--output C:\temp\batch.dwg `
--new `
--fast
JSON 结构示例：
{
"units": "mm",
"live_preview": true,
"live_zoom_every": 6,
"layers": [
{"name": "OUTLINE", "color": 7},
{"name": "CENTER", "color": 1},
{"name": "TEXT", "color": 3}
],
"entities": [
{"type": "rectangle", "origin": [0, 0], "width": 120, "height": 80, "layer": "OUTLINE"},
{"type": "circle", "center": [20, 20, 0], "radius": 4.5, "layer": "CENTER"},
{"type": "text", "text": "MOUNTING PLATE", "point": [8, 88, 0], "height": 5, "layer": "TEXT"}
]
}
复杂任务使用 Python：
import sys
sys.path.insert(0, r"subskills\autocad-automation\scripts")
from acad_session import AutoCADSession
session = AutoCADSession(create_if_missing=True, visible=True).connect()
session.new_document()
session.activate_window()
session.create_layer("OUTLINE", color=7)
session.add_rectangle((0, 0), width=120, height=80, layer="OUTLINE")
session.live_update(step_delay_s=0.15, zoom=True)
session.save_as(r"C:\temp\plate.dwg")
技术路线选择
| 需求 | 首选路线 | 说明 |
|---|
| 快速绘制、改图、批量检查 | Python COM/ActiveX | 本技能默认路线，可由 Codex 直接通过 shell 执行 |
| 执行 AutoCAD 命令、调用已有命令习惯 | SendCommand / .scr / AutoLISP | 命令可能异步，必须保存和复核结果 |
| 大量数据库事务、复杂选择过滤、插件菜单 | AutoCAD .NET | 适合 C# 插件，按官方 .NET Developer Guide 做事务和文档锁 |
| 高性能原生扩展、深层数据库/图形系统 | ObjectARX C++ | 成本高，版本绑定强，先确认必要性 |
| 云端批处理 DWG | APS Design Automation | 适合无桌面、批量生产或 CI，但需要 Autodesk APS 凭据 |
工程规则
- 图层先建后画，颜色用 ACI 编号；不要把所有对象堆到
0 层。
- 明确单位和比例，模型空间画 1:1；打印比例放到 Layout/Plot。
- 坐标、尺寸、文字高度、孔径等关键参数写成变量，不把魔法数字散在代码里。
- 根据图片生成线稿时，普通“照图画 CAD”的最终交付必须以原图矢量化线条为准。不要用大弧线、长折线、椭圆、三角形、彩色水波线、替代文字等手工猜测元素去补人物轮廓、五官、Logo、衣纹或水花；这些线容易像错误的 CAD 辅助线，用户会把它们理解成“这都是啥”。
- 如果为了定位、调试或临时增强识别绘制了
BODY_OUTLINE、JERSEY_OUTLINE、PORTRAIT_OUTLINE、OUTER_GUIDE、CONSTRUCTION、FACE_FEATURES、LOGO_GEOMETRY、WATER_SPLASH、JERSEY_STRIPE、TEXT_LOGO、TEXT_BRAND 等构造/增强层，最终保存、预览和评分前必须删除、冻结、关闭或设为不打印，并在预览和图层统计中确认不可见、实体数为 0。
- 只有当用户明确要求“重构标识”“增强五官”“补画水花”“加文字/标注”等创作型改图时，才可保留手工增强层；保留前要说明这些不是原图自然矢量线，并优先用独立图层，便于一键关闭。
- 审查说明、评分、生成参数放到 JSON/Markdown 报告，不要作为可见文字写入最终 CAD 模型空间，除非用户明确要求图内标注。
- COM 返回对象要检查，保存/导出后检查文件是否存在和大小是否合理。
SendCommand 是最后手段；优先调用对象模型方法，命令脚本要用 _.COMMAND 形式降低界面语言影响。- 用户明确说“我要看着它画”时，不要后台闷头生成；先把 AutoCAD 打开并前置，再逐步落图元。
- SelectionSet 名称可能残留；创建前先删除同名选择集。
- 批处理 DWG 时每张图单独 try/finally，失败要记录文件名、错误和阶段。
- 对用户原图默认只读打开或另存副本；覆盖必须得到明确授权。
- 不把任意 Python/VBA/AutoLISP 执行口暴露成通用 MCP 工具；如做 MCP，只提供白名单绘图/导出/复核工具。
GitHub 与官方文档策略
优先来源：
- Autodesk AutoCAD API 概览、ActiveX/VBA、Managed .NET、ObjectARX 和 APS 官方文档。
- ADN-DevTech / Autodesk Platform Services GitHub 示例。
pyautocad 等成熟开源项目可借鉴坐标、迭代和 COM 封装模式，但不要复制不明许可证代码。- 论坛、博客和 Stack Overflow 只作排错补充；关键 API 仍回到官方文档确认。
当资料冲突时，以目标 AutoCAD 版本的官方文档和本机实测结果为准。
渐进参考
按需读取，不要一次塞满上下文：
references/api-lookup.md：官方文档、GitHub 示例和 API 查证路线。references/engineering-patterns.md：资深工程师绘图、图层、单位、块、标注和批处理经验。references/troubleshooting.md：COM、AutoCAD 会话、SendCommand、保存导出和版本问题排查。
验收与汇报
完成 AutoCAD 操作后，最终回复要包含：
- 输入假设：单位、版本、模板、是否新建/修改原图。
- 输出文件：DWG/DXF/PDF/JSON 报告和 BMP/PNG 预览的绝对路径。
- 实际执行的验证：自检、实体统计、图层统计、包围盒、保存/导出检查、AutoCAD 原生预览图审查；根据图片生成线稿时，还要确认最终预览中没有额外外围辅助轮廓线、内部辅助几何、彩色装饰线或图内审查说明显示；若使用窗口截图，还要说明是否无遮挡。
- 仍需人工确认的事项：图框、打印机、企业标准、线宽、字体、比例、专业审图。
