# AI CAD Workbench

面向 AI Agent 的 Python CAD 执行层。AI 负责理解需求和修改参数化源码；本工具负责受控构建、STEP/DXF/GLB 导出、检查、渲染、差异比较与证据记录。

它不是“输入一句话就自动保证可制造”的黑盒。工程图、材料、公差、工艺和签审仍需由具备资质的工程人员确认。

## 能力

- `model.py + model.cad.json` 源码式参数化建模
- build123d/OCP 三维内核与 ezdxf 二维图纸
- STEP、GLB、DXF、PNG、拓扑 JSON 和统一 Pydantic 报告
- `doctor / describe / build / inspect / measure / diff / render / review`
- Python SDK、CLI、MCP 三套一致接口
- Web Studio：独立三维装配页和二维 CAD 绘制页；真实 GLB、DXF 点图切模块、逐文字编辑、毫米选区和整图重绘计划
- 二维模板库：内置 A3/A4 毫米制基底，支持导入企业 DXF 图框/标题栏并按内容哈希追加保存
- 追加式 run、输入哈希、源码快照和视觉审查记录

## 安装

需要 Python 3.12 和 [uv](https://docs.astral.sh/uv/)。

```powershell
git clone --recurse-submodules https://github.com/redmaplewww/ai-cad-workbench.git
cd ai-cad-workbench
uv sync --extra dev
uv run aicad doctor --workspace . --json
```

如果普通 clone 时没有拉子模块：

```powershell
git submodule update --init --depth 1
```

## 快速体验

先构建一个带孔安装板：

```powershell
uv run aicad build examples/ai_cad/mounting_plate/model.cad.json --workspace . --json
```

再启动 CAD 绘制与 AI 修改前端：

```powershell
uv run aicad studio --workspace . --host 127.0.0.1 --port 8766
```

打开 `http://127.0.0.1:8766/` 查看三维装配，打开 `http://127.0.0.1:8766/drawing` 进入二维 CAD 绘制工作台。二维图在绘制结果建立时同步模块化；单击图元会切换到最具体模块，Shift/Ctrl 多选可建立人工编辑模块。模块只负责定位修改意图，外部 AI 始终修改完整 Python 真源并重绘整张图，再对未涉及模块执行差异校核。

## Text-to-CAD 与 Skills

本仓库将 [earthtojake/text-to-cad](https://github.com/earthtojake/text-to-cad) 固定为 Git 子模块，同时直接提供本项目常用 Skill：

- `skills/ai-cad-workbench`：本工具的模型、构建、检查和 Studio 工作流
- `skills/cad`：STEP-first 参数化 CAD
- `skills/dxf`：二维 DXF 与工程图
- `skills/cad-viewer`：CAD 文件可视化检查
- `skills/pdf`：PDF 阅读、渲染和版式核验

`project-to-act` 仅用于开发过程账本管理；因本地安装副本没有独立再分发许可证，本仓库没有复制其文件。

## 示例边界

公开版只保留原创、通用、可复现的示例。客户 PDF 复现图、第三方参考 STEP、许可未闭合的数据集、运行缓存和历史产物均未进入本仓库。示例图纸标注和自动检查可作为工程工作的起点，但不构成制造放行。

## 测试

```powershell
uv run pytest
cd integrations/autocad-mcp
uv sync
uv run pytest
```

更多说明见 `docs/AI_CAD_MVP.md`、`docs/AI_CAD_STUDIO.md`、`docs/AI_CAD_CAPABILITY_INVENTORY.md` 和 `docs/GB_DRAWING_RULES.md`。

## License

本项目原创代码采用 MIT License。第三方组件与 Skills 的许可证见 `THIRD_PARTY_NOTICES.md` 及其目录内许可证文件。