SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场solidcraft

solidcraft

设计与创作

查看项目

更新于 11-03 16:46

技能介绍

用途

SolidCraft 是一款用 Rust 编写的开源参数化 CAD 应用，提供桌面版、Web 版、无头 CLI 和 MCP 接口。本技能用于通过其结构化自动化接口操作 SolidCraft，完成参数化 3D CAD 设计的创建与编辑，涵盖草图、特征、参数、装配、工程图，以及建模工作流的自动化。使用时应保留用户要求的建模流程和目标设计。

主要能力

  • 建模命令族：sketch.（直线、圆、矩形、圆弧、样条、槽、多边形、文字、点、构造线、尺寸、约束、修剪、圆角、倒角、镜像、阵列、求解、检查、完成）；solid.（拉伸、旋转、扫掠、放样、圆角、倒角、抽壳、拔模、孔、螺纹、线圈、筋、腹板、压拉、管道、浮雕、边界填充、偏移面、替换面、分割实体/面、组合、移除、移动、缩放、镜像、对齐，以及矩形/圆形/路径阵列和基本体）；另有 face.、body.、sheet.（钣金）、assembly./joint./contact./motion./explode.、parameters.、config.、timeline.、construct.、surface.、mesh.、material./appearance.、document./file.、view.、browser.、select.、inspect.、render.、edit.、diagnostics.* 等。
  • 检查与校验：document.inspect 查看参数、时间线、实体、草图、选择与撤销深度；ui.inspect 查看相机、当前工具或对话框、状态栏等；engine.execute inspect.measure 获取体积、面积、质心、包围盒、面/边/顶点数量，body_topology 获取用于圆角倒角选择的面和边中点。
  • 批量执行：engine.batch 在同一帧内执行多条命令，遇首个失败即停止并恢复检查点，报告 failed.index/command/error；批量拒绝加载文件的步骤以及显示代理光标时的步骤。
  • 视图与截图：ui.render 使用 GPU 渲染模型，无需呈现窗口；ui.screenshot 捕获窗口画面；ui.view、ui.camera 移动视口；ui.worldToScreen 映射世界坐标到像素。
  • UI 交互：ui.handles、ui.click/move/drag、ui.key/ui.text、ui.start、ui.menuPick、ui.selection、ui.editFeature、ui.confirm 等可操作菜单、对话框与确认流程；ui.agent_cursor 可让指针滑向每次拾取。
  • 文件与导出：file.new、doc.open、file.save、file.export 支持 step、3mf、3mf-tagged、stl、stla、obj、urdf 格式。

使用方式

  1. 定位可执行文件：solidcraft 与 solidcraft-cli 通常不在 PATH 中，需通过 command -v/where、macOS 的 mdfind、Linux 的 AppImage 或 snap 路径发现，不要猜测路径。
  2. 启动并选择会话：可观看会话用 SOLIDCRAFT_CONTROL_PORT=7878 启动桌面应用并驱动实时窗口；MCP 桥接使用 solidcraft-cli mcp --connect 127.0.0.1:7878；无头模式使用 solidcraft-cli mcp（不带 --connect）或 solidcraft-cli run script.json，拥有独立进程内设计，无法操作用户已打开窗口。
  3. 认证：每次启动生成随机令牌并写入 0600 权限文件，首次请求以顶层 token 字段发送；可设 SOLIDCRAFT_CONTROL_TOKEN 固定令牌。
  4. 发现命令：先读取 references/control-protocol.md 与 references/mcp.md，通过 engine.commands、solidcraft-cli commands 或 MCP list_commands 获取命令 ID、参数文档与启用状态，不要自行编造命令 ID 或参数。
  5. 检查、编辑与验证：先用 document.inspect 了解现有设计，再用 engine.execute 或 engine.batch 执行修改；修改已有特征可用 timeline.inspect 读取、timeline.edit 写回；结果应与解析值比对后再告知用户。

适用场景

参数化零件建模、已有设计的编辑与回归检查、含关节与运动研究的装配设计，以及无人值守的文件批处理（无头模式）和产品图像渲染。

限制

MCP 服务器默认将文件路径限制在设计所在文件夹、恢复文件夹与临时文件夹内，可用 --allow-path 扩展或 --allow-any-path 解除；请求 60 秒无响应（engine.batch 为 3600 秒）会返回超时，但命令可能仍会生效，不应盲目重发写操作；ui.screenshot 在窗口最小化或被遮挡时可能失败。上游另外提供 solidcraft-modeling、solidcraft-editing、solidcraft-checking、solidcraft-mechanisms 四个建模工作流技能，可按需获取。

收费与平台

资料未提供该技能或 SolidCraft 的收费、价格信息；平台方面提及支持桌面（macOS、Linux、Windows）、Web 与无头 CLI，具体支持范围以官方资料为准。