Aedifex

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 控制场景

使用教程

# 需要 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：

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）。