| 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，但原生写入必须先通过 capabilities.yaml 门禁和本机真机回归；当前 AutoCAD 2024 的 Documents/Layers/SelectionSets 动态代理不稳定，因此 COM 原生 DWG 绘图按 not_implemented 处理。DXF 无头读取、预览和结构审查可直接使用。AutoCAD 2024 .NET 白名单后端已连续通过真实 DWG 保存重开、PDF/PNG 和实体/图层/尺寸回归，运行时证据完整时为 verified；只允许固定命令，不得推广成任意代码执行。
适用场景
使用本技能处理：
- 新建或修改 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 预览，并用图片查看工具做视觉审查。窗口截图可作为补充，但若被其它窗口遮挡，不可作为通过依据。
若输入是 DXF 且只需无头只读检查，可先运行 scripts/acad_headless.py；它不支持 DWG 写入，最终 DWG/PDF 仍须走 AutoCAD COM。
- 沉淀经验：遇到新坑、命令差异、版本限制或稳定封装，补进
references/troubleshooting.md 或脚本。
机械零件图和 3D 打印开孔图硬性要求
当用户要求“严格遵守规范”“中国人正常喜欢的格式”“国标图纸”“加工图”“3D打印开孔”或类似机械制图交付时，必须按机械图纸而不是示意图处理：
- 优先使用用户或企业模板；没有模板时，按国内常用 GB/T 风格出图，至少包含 A3/A4 图幅、装订边、右下标题栏、仿宋中文、粗实线/细实线/中心线/虚线/尺寸/文字/开孔分层，并在交付说明中写清“参照国标风格，未替代企业审图”。
- 所有实际切除、开孔、开槽、接口、水口、螺丝孔和螺丝柱必须同时给出规格和定位尺寸。仅写
4×φ3.4、7×4×30、2×φ13.5 而没有相对基准边、中心距、节距或高度定位，视为未完成。
- 孔槽密集或会造成长引线跨视图时，优先使用“孔槽明细表/孔表/槽表”，表内至少包含部位、规格、数量和定位；图面尺寸线负责关键基准、中心距和总尺寸。
- 不允许用随意长引线替代尺寸链；引线不得穿越其它视图、中心线、孔轮廓或尺寸文字。无法清爽标注时，移动视图、拆分视图或改用表格。
- 3D 打印外壳图必须标清壁厚、底厚、外形总尺寸、接口开孔尺寸、接口中心定位、装配孔中心距和水口/散热槽定位；否则用户无法按图开孔。
- 标注必须优先使用 AutoCAD 真实尺寸实体，例如
AcDbRotatedDimension，不要手画尺寸线冒充尺寸。
- 视觉验收不能只看实体统计。必须导出预览并目视检查：尺寸是否漏标、文字是否重叠、尺寸线是否压视图、引线是否跨视图、孔表是否可读、标题栏是否被尺寸侵入。发现问题先返工再汇报。
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,
复杂任务使用 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 原生预览图审查；根据图片生成线稿时，还要确认最终预览中没有额外外围辅助轮廓线、内部辅助几何、彩色装饰线或图内审查说明显示；若使用窗口截图，还要说明是否无遮挡。
- 仍需人工确认的事项：图框、打印机、企业标准、线宽、字体、比例、专业审图。
