# Aedifex

> 浏览器里运行的开源 3D 建筑编辑器，内置 AI 设计助手：自然语言建墙、放门窗、摆家具，自带 MCP 服务器可接 Claude

## Aedifex —— 带 AI 设计助手的开源 3D 建筑编辑器

Aedifex 是一个运行在浏览器里的开源 3D 建筑设计编辑器，内置 **AI 设计助手**：用自然语言描述需求，AI 自动建墙、放门窗、摆家具并实时预览。基于 WebGPU + Three.js + React，MIT 协议。

### 核心功能

**结构与布局**
- 墙体系统：自动斜接、可调厚度/高度，0.5m 网格吸附
- 门窗：可配置尺寸、开启方向、铰链侧
- 区域自动识别：从墙体边界自动检测房间，显示面积和空间元数据
- 多楼层：楼层堆叠/展开/单独查看，各层独立平面图
- 楼板、天花板、屋顶：多边形几何绘制

**家具与材质**
- 内置家具目录：沙发、桌椅、床、书架、灯具、树木等
- 智能摆放：碰撞检测、墙体吸附、房间边界约束
- 10 种材质预设（白、砖、混凝土、木、玻璃、金属等）+ 自定义颜色/粗糙度/金属度/透明度

**浏览与导出**
- 街景模式：第一人称漫游（WASD 移动、Q/E 升降），走进自己的设计里看
- 导出 GLB（Web/游戏引擎）、STL（3D 打印）、OBJ 通用格式
- 暗色/亮色主题、指南针 HUD

### AI 设计助手

- **自然语言建模**：直接说"创建一个 5m×4m 的房间并布置成卧室"
- **16 个工具**：增删移家具、建墙、放门窗、批量操作、多方案建议
- **幽灵预览**：AI 建议以透明预览呈现，确认后再应用
- **Agentic 循环**：AI 自动迭代修正碰撞和边界问题，需求模糊时主动追问
- **MCP 服务器**：自带 35 个工具的 MCP 包，可接入 Claude Desktop / Cursor 控制场景

### 使用教程

```bash
# 需要 Node.js 20+、pnpm 9+、支持 WebGPU 的浏览器（Chrome 113+）
git clone https://github.com/TangSY/aedifex.git
cd aedifex
pnpm install
pnpm dev
# 打开 http://localhost:3002
```

AI 助手（可选）需配置 OpenAI 兼容 API：

```bash
cp .env.example apps/editor/.env.local
# 编辑 .env.local 填入：
# AI_API_KEY=sk-xxx（支持任何 OpenAI 兼容服务：Azure、本地 Ollama 等）
# AI_BASE_URL=https://api.openai.com/v1
```

不配 API Key 编辑器也能正常使用，仅 AI 面板禁用。密钥只在服务端调用，不暴露给浏览器。

### 技术栈

Turborepo monorepo：Next.js 16 + React 19 + Three.js（WebGPU）+ Zustand，场景数据为扁平字典模型（Site → Building → Level → Wall/Zone/Item）。

---

**分类**：软件
**标签**：助手 · 设计 · AI
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1937