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

solidcraft-agent-tools

智能体与模型

查看项目

更新于 11-03 16:16

技能介绍

用途

solidcraft-agent-tools 是 SolidCraft 的开发者与智能体协作工具说明，面向需要运行应用、观察变更效果、通过控制通道或命令行驱动 SolidCraft，以及新增或修改 MCP 工具、控制方法或内置技能的场景。

运行与控制通道

使用 cargo run --release -p solidcraft -- --sample --control PORT 启动示例设计并开启控制通道，PORT 需选择空闲端口。无显示环境下可在 Xvfb :99 下运行并设置 DISPLAY=:99。

通过 JSON lines 与 127.0.0.1:PORT 通信，协议见 docs/control-protocol.md。连接上的首个请求需携带启动令牌作为 token：可从 ~/.local/share/solidcraft/control/PORT.token 读取，或用 SOLIDCRAFT_CONTROL_TOKEN=$(openssl rand -hex 32) 启动应用后发送该令牌。令牌不得粘贴到 PR 或 issue 中。

示例请求包括 engine.execute 执行 solid.extrude 命令、ui.start 启动 sketch.create 后配合 ui.click {x, y}、以及 ui.screenshot 写入 PNG 后读取。UI 相关工作应查看结果；无窗口时使用 ui.render 或 solidcraft-cli snapshot。

命令行与无头模式

  • solidcraft-cli run script.json --out part.step
  • solidcraft-cli eval design.sc
  • solidcraft-cli snapshot script.json --out shot.png
  • solidcraft-cli commands

构建时使用 CARGO_TARGET_DIR=<repo>/target。

MCP 工具

MCP 服务为 solidcraft-cli mcp（crates/mcp/src/，文档 docs/mcp.md）。工具定义在 crates/mcp/src/tools.rs，需同步维护 docs/mcp.md，并保持工具注解（只读、破坏性）如实。用户能做的操作应作为命令添加，而非新增工具，除非工具关乎会话本身（打开、保存、截图、批量）。

文件访问仅限允许的文件夹（设计所在文件夹、恢复文件夹、暂存文件夹、--allow-path）。路径在比较前解析，.. 与离开允许集合的链接会被拒绝，Windows 上 UNC 与设备路径也会被拒绝。回复需保持精简：verbose: false，不输出未过滤的命令目录或拓扑转储。

控制通道是带令牌的本地接口；新增方法需在 docs/control-protocol.md 中登记，长时间任务遵循 skills/solidcraft-performance/SKILL.md。

内置智能体技能

建模技能（skills/solidcraft-modeling、-editing、-checking、-mechanisms）内置于 MCP 服务器的 skill_reference 工具（crates/mcp/src/skill_reference.rs），贡献者技能不内置。技能描述的命令、参数名或行为变化时，需在同一 PR 中更新；skills_name_only_real_tools_and_commands 测试会在技能引用已不存在的工具或命令时失败。新增内置文件需同时加入 skill_reference.rs 与上述测试。skills/README.md 说明布局与其他测试；cargo xtask skills 校验 AGENTS.md 与各 SKILL.md 引用的路径、命令与技能是否真实存在。

限制

控制通道仅限本地并需令牌；文件访问限于允许目录；MCP 工具回复需精简；新增控制方法或内置技能需同步文档与测试。其他收费、平台支持与效果信息暂未提供。