SuperAPI AI 工具集

cadcraft-scenario-playbooks

设计与创作

查看项目

更新于 11-04 23:01

技能介绍

用途

本技能是 CADCraft 的绘图场景手册,用于在八类常见绘图任务中快速选择并执行对应流程:安装板、法兰孔系、门洞平面、设备网格、折线路由、等距孔列、缺口零件、带标题栏图框。所有示例基于毫米模型空间,旨在帮助用户按真实命令与坐标完成绘制,并在保存后重新打开检查结果。

主要能力

  • 提供 8 条场景流程,可从 recipes.json 获取有序方法与参数。
  • 命令证据保存原生命令描述,来源固定为 GitHub 文档提交。
  • 支持 CLI 与 MCP 两种调用方式:内嵌编辑器已有任务时使用同一 MCP 会话;独立命令行使用 cadcraft-cli run。
  • 提供保存后检查方法,包括查询实体、可读文字、转换为 SVG 审阅图,并检查标注、孔心、轮廓闭合与单位。

使用方式

  1. 先运行 cadcraft-cli --version 和 cadcraft-cli commands 确认 CLI 就绪;技能不附带 CLI,缺失时按官方发行说明选择系统版本安装,并遵守宿主授权。
  2. 确认单位、实际尺寸和输出用途。每条默认独立图纸;组合多个场景时先安排位置和偏移,避免都从原点叠放。
  3. 内嵌编辑器场景:先读取当前工具 schema 与命令目录,再按步骤调用。原生 CAD 工具示例:execute {"command":"circle","params":{"center":[10,10],"radius":3}}。插件增强运行时工具以当前 tools/list 返回的名称和 schema 为准,不凭其他 Craft 工具名推测。返回的 handle 用于后续实际对象选择,不能猜测。
  4. 独立 CLI 示例:cadcraft-cli run --metric --cmd 'circle {"center":[10,10],"radius":3}' --save part.dxf。每个方法 ID 加空格加 JSON 是单个 argv;同一图纸的步骤放在一次 run 中。Windows 优先使用进程参数数组,避免 shell 解释 JSON。
  5. 已有图纸用 run input.dxf,跳过全部 newDocumentOnly 步骤,包括 INSUNITS 设置。先用 getvar {"name":"INSUNITS"} 读取既有单位;只有已确认毫米图纸可直接采用示例;英寸或米图纸须先在副本中明确转换实际坐标和尺寸,不能仅改单位变量。不要把本例的 new 用于已有会话而清空图纸。
  6. 保存为新名称后,用 cadcraft-cli run part.dxf --cmd 'drawing.inspect {"entities":true}' 查询真实实体;用 texts 查询可读文字;用 convert part.dxf part.svg 输出审阅图。标注、孔心、轮廓闭合、单位都要检查,不能只看文件存在。

适用场景

适用于使用 CADCraft 绘制安装板、法兰孔系、门洞平面、设备网格、折线路由、等距孔列、缺口零件和带标题栏图框的场景,也适用于需要由明确尺寸重建零件、平面图几何关系或可复核图框交接的任务。

限制

  • 技能不附带 CLI,需单独安装。
  • 所有示例为毫米模型空间,图框不等于打印设置。
  • 孔参数 radius 为半径;尺寸由几何计算,不把期望数值写入 text 冒充量测。
  • 房间示例仅在新图设置 DIMSCALE=100,使文字和箭头适配 5000 毫米空间;既有图纸先检查现有标注样式,不全局覆盖。
  • 白底审阅图使用深色尺寸与标签,避免屏幕图层色造成低对比度。图层分开轮廓、孔、中心线和尺寸。
  • 例子不代替工程设计、公差或制造要求;未指定的孔距、材料与公差不能自行宣称满足。
  • assertions 仅适用于随附示例的技术回归,真实图样应按实际数据检查并查看成图。
  • 原生 CLI 编辑另一文件不能证明内嵌编辑器同步变化;同画面工作必须执行当前桥会话支持的方法。