agentcad

1) 安装先决条件: 确保您已安装 Python 3.10–3.12（示例使用 Python 3.12）。agentcad 在本地运行。

2) 创建并激活虚拟环境（推荐）: 运行：`python3.12 -m venv .venv`，然后 `source .venv/bin/activate` (macOS/Linux)。在 Windows 上，使用适当的 PowerShell/CMD 激活脚本激活虚拟环境。

3) 安装 agentcad（仅限 CLI）或带 MCP 支持的 agentcad: 仅限 CLI：`pip install agentcad`。 MCP 服务器支持：`pip install 'agentcad[mcp]'`。

4) （可选）通过 uv 而非 pip 安装: 如果您喜欢 uv：`uv tool install --python 3.12 'agentcad[mcp]'`。

5) 安装代理技能（用于编码代理/工作流程）: 运行：`agentcad skill install`。

6) 阅读操作简报（帮助输出）: 运行：`agentcad --help` 并查看可用的命令和选项。

7) 在“脚本 → 运行 → 渲染 → 修复”迭代中使用 agentcad: 编写 CAD 脚本（agentcad 预注入了 build123d 基元以及 `show_object` 等辅助函数，因此脚本通常无需任何导入）。使用 agentcad 执行它以生成版本化的 CAD 输出，并获得渲染的 PNG 预览以及几何指标（尺寸、体积、面数、有效性）。迭代直到几何图形有效并符合预期。

8) 最小示例脚本: 创建一个包含以下内容的脚本： `box = Box(10, 20, 5)` `show_object(box)` 然后通过 agentcad 运行它以生成预览渲染和指标。

9) 导出交付物（制造/共享）: 使用 agentcad 的导出功能输出 STEP 等格式（在运行中进行版本控制），并根据需要导出为 STL/GLB/OBJ 用于 3D 打印或网络查看器。

10) 调试时验证和检查几何图形: 使用 agentcad 内置的验证和检查/拓扑报告功能，快速捕获无效几何图形并在导出前诊断问题。

11) （可选）通过 MCP 在代理编辑器（Claude Code/Cursor/Windsurf）中使用 agentcad: 添加一个 MCP 条目（示例 `.mcp.json`），以便您的编码代理可以调用 agentcad 作为工具： { "agentcad": { "command": "uvx", "args": ["--from", "agentcad[mcp]", "python", "-m", "agentcad.mcp"] } } 这无需事先安装即可工作，因为 `uvx` 在首次运行时会缓存环境。

12) 提示驱动的工作流程（示例任务）: 在您的编码代理（例如 Claude Code/Cursor）中，要求它设计一个零件并在最后请求预览渲染。示例：“为我设计一个手机支架：一个倾斜的支架，以 60 度角支撑手机，宽约 80 毫米，深 50 毫米，带 5 毫米的边缘。完成后给我一个预览。”代理应使用 agentcad 的运行+渲染反馈进行迭代，直到正确。