CADCraft 技能旨在通过其结构化自动化接口操作 CADCraft 应用,并保留用户要求的绘图流程与目标图纸。
用途与主要能力: 该技能支持创建和编辑 CAD 图纸、实体、图层与布局,或通过控制协议、MCP 桥接或命令行自动化工作流。可检查图纸状态(实体、范围、图层、样式、块、布局、选择与撤销状态)、通过命令行或引擎命令编辑图纸、使用 UI 命令操作菜单与控件,并渲染或截图验证结果。
使用方式: 首先阅读 references/control-protocol.md 的相关章节,尤其是方法表、面板停靠、命令行回复和界面语言。使用 engine.commands 在运行时发现绘图命令,而不是编造命令 ID 或参数。定位可执行文件:在 PATH 中查找 cadcraft 和 cadcraft-cli,或在 macOS 的 /Applications、~/Applications 中查找 CADCraft.app,Linux/Windows 检查常见安装位置与快捷方式。若 cadcraft-cli 缺失,可直接通过 TCP 发送行分隔 JSON 请求。选择会话:对于用户打开的图纸或可见应用,使用现有的 MCP 桥接或控制会话;无头会话无法编辑用户实时窗口。无人值守处理文件时使用无头 MCP(cadcraft-cli mcp)。桌面会话通过 --control PORT 或 CADCRAFT_CONTROL_PORT=PORT 启动,监听 127.0.0.1:PORT,并用 cadcraft-cli mcp --connect 127.0.0.1:PORT 桥接。使用 CADCRAFT_CONFIG_DIR 指向隔离配置,不要直接编辑 workspace.json。编辑前先使用 drawing.inspect、ui.inspect 和 cmdline.state 检查状态。编辑可通过 cmdline.input 模拟用户输入,或通过 engine.execute 运行带 JSON 参数的引擎命令。使用 ui.menu.invoke 处理菜单交互,ui.elements 查找控件。面板布局通过 engine.execute 调用 ui.dock 等命令。验证时可重新运行 drawing.inspect 并使用 ui.render 或 ui.screenshot。文件访问使用 app.open、app.save、app.quit。保存为 DXF 或 DWG 时通过 ui.set 设置 saveFormat 和 saveVersion。服务器等待应用响应最多 60 秒,超时回复可能为 not-run 或 may-have-run,断开连接后需先检查图纸与撤销状态再重试。
适用场景与限制: 适用于需要自动化 CAD 绘图、批量处理文件或通过 MCP 桥接控制桌面 CADCraft 的场景。创建此技能不会安装 CADCraft 或注册 MCP 服务器;若缺少所需连接或可执行文件,需报告具体前置条件。上游协议未记录身份验证握手或文件访问根目录,若安装版本要求令牌或根目录,应遵循其 --help 输出。不要覆盖用户源图纸,除非明确要求;应另存为新名称。