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 啟用腳本啟用 venv。

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 的運行+渲染回饋進行迭代，直到正確為止。