建筑设计领域正经历着一场静悄悄的变革。你是否曾幻想过只需动动嘴皮子，就Neng像拥有一个魔法师般的助手，瞬间将脑海中的空间构想转化为三维实体？不再是枯燥的鼠标点击，不再是复杂的参数面板，而是纯粹的、自然的语言交流。今天我们要深入探讨的正是这样一个颠覆性的开源项目——Aedifex。它不仅仅是一个运行在浏览器中的3D建筑编辑器，geng是一个集成了大语言模型的智Neng设计伙伴，试图重新定义我们与三维空间交互的方式。

打破传统：从“操作工具”到“描述意图”

传统的3D设计软件，无论是专业的还是轻量级的，往往dou伴随着陡峭的学习曲线。你需要理解什么是布尔运算，什么是多边形建模，甚至还要记住一堆快捷键。这种“人迁就软件”的模式，在Aedifex这里被彻底颠覆了。其核心理念极其简单：不需要学习工具，只需要描述你想要什么。

想象一下这样的场景：你面对着一片空白的画布，轻轻输入：“帮我规划一个长五米、宽四米的起居室。” 几乎在瞬间，四面墙体拔地而起，系统自动检测封闭区域，一个房间的雏形便诞生了。紧接着，你继续说道：“在南面的那堵墙上，开一扇两米宽的落地窗。” AI立刻理解了方位和尺寸，在南墙上精准地切出了窗洞。这还不是全部，当你补充道：“靠西墙放一个L型沙发，对面摆上电视柜”时系统会自动从庞大的家具库中匹配模型，并智Neng地将其贴墙放置。Zui后“茶几放在沙发前方，旁边再加一盏落地灯”，AI不仅会执行指令，还会计算空间关系，确保茶几居中，且落地灯的位置不会阻挡行走的动线。

四句话，一个功Neng完备、布局合理的客厅就跃然屏上。这不再是科幻电影中的桥段，而是Aedifex带给我们的真实体验。这种交互方式的转变，让非专业用户也Neng轻松上手，将创意转化为现实。

不仅仅是聊天：拥有实体的智NengAgent

你可Neng会问，这只是一个套了壳的ChatGPT吗？绝非如此。在Aedifex中，AI并非一个简单的问答窗口，而是一个拥有完整操作Neng力的Agent。它目前定义了多种结构化工具调用，覆盖了建筑设计的全流程。

这个智Neng体具备惊人的“耐心”和“判断力”。当用户发出指令后AI会进入一个Zui多可达20轮的迭代循环：执行操作 → 观察结果 → 判断是否需要继续。比如当你要求“帮我布置一个完整的客厅”时AI不会只放一件家具就停下。它会在一轮循环中依次放置沙发、茶几、电视柜、落地灯，每放一件dou会检查空间冲突和布局合理性。遇到不确定的地方，比如剩余空间放不下你想要的大件家具，它会主动停下来询问，而不是自作主张地猜测。

geng令人安心的是AI生成的操作不会立即写入场景，而是先创建带临时标记的节点，以半透明的“幽灵”形态在3D视口中展示预览效果。这种预览机制让你在确认之前，Ke以随时拒绝，系统会完整恢复原始状态。这种设计极大地降低了试错成本，让你Ke以放心地用自然语言反复试探，直到满意为止。

深度解构：Monorepo架构下的技术美学

对于技术爱好者来说Aedifex的内部架构同样值得玩味。它采用了Turborepo结合pnpm管理的Monorepo结构，这种现代化的工程实践保证了代码的可维护性与 性。整个项目被按职责拆分为多个独立的包，每个包各司其职，边界清晰。

具体来kan，core包作为核心库，包含了Zod schema定义、Zustand状态管理以及空间系统，它不依赖任何React渲染逻辑，完全Ke以独立用于数据处理和验证；viewer包则专注于三维渲染，负责R3F组件、后处理以及导出功Neng，不包含编辑器的UI逻辑；而editor包则组合了前两者，提供完整的编辑体验；Zui后是ui包，作为共享的UI组件库，基于Headless UI和Tailwind CSS构建。

这种分层设计带来的好处是显而易见的。未来Ru果你只想Zuo一个只读的模型预览页面只需引入core + viewer即可，完全不会带入编辑器那沉重的代码包袱。这种模块化的思维，体现了开发者对软件工程深刻的理解。

数据架构的涅槃：从树状到扁平字典

要让AINeng够高效地理解和操作三维空间，数据结构的重构是重中之重。原项目的节点结构虽然符合人类直觉，但对于AI来说并不友好——AI需要快速定位和操作任意节点。因此，Aedifex将其重新设计成了扁平字典 + parentId 引用的架构。

现在所有的节点，无论是墙体、门窗、家具，还是楼板、屋顶，dou平铺存储在一个Record字典中。它们通过parentId来表达层级关系，任何节点douKe以通过ID直接索引。这种设计极大地提升了查询效率，也为后续的结构演进留出了空间，引入了schema版本管理和数据迁移框架。

为了确保数据的健壮性，所有核心数据结构dou使用了Zod来定义schema。这意味着实现了编译期+运行时的双重类型安全。每种场景节点dou有对应的Zod schema，定义了字段类型、默认值和取值范围。数据写入场景时必须经过parse验证，任何不合规的数据dou会在入口处被拦截，而不是等到渲染时才报错。这对于处理像AI生成这样充满不确定性的外部输入来说至关重要。

视觉盛宴：WebGPU与SSGI的渲染革命

虽然Aedifex的核心亮点在于AI交互，但其视觉表现力同样不容小觑。在渲染层面上游项目Yi经具备了不错的基础，而Aedifex在此基础上Zuo了进一步的可靠性优化。它采用了Three.js的WebGPU渲染技术，配合SSGI和后处理管线，使得画面质感达到了一个新的高度。

材质系统提供了丰富的预设，涵盖了木材、砖石、混凝土、玻璃、金属、大理石等常见材质，并且支持完整的PBR参数控制。所有节点类型douKe以应用这些材质，让设计kan起来geng加真实。此外系统还支持亮暗主题切换，适应不同的工作环境。

为了防止意外崩溃，Aedifex还特别加入了WebGPU设备丢失监测和后处理错误自动恢复机制。这些细节上的打磨，虽然用户未必Neng直接感知，但却是保证流畅体验的基石。当你设计完成后Ke以导出为GLB、STL或OBJ，导出时会自动剥离编辑器图层，只保留纯净的三维模型数据。

智Neng布局：当AI学会了“空间美学”

AI放家具不Neng随心所欲——不Neng摆出房间外面不Neng和Yi有家具重叠，靠墙的家具要自动贴合。这背后是一套精密的四层验证体系。

AI选择家具时会经过多级匹配：先精确匹配ID，再匹配名称，Zui后Zuo模糊子串搜索。甚至支持形状描述匹配——用户说“圆形茶几”、“L型沙发”，系统Neng自动筛选对应形状的款式。匹配不上时它会按类别推荐相似选项，而不是静默失败。

验证通过后还有一层布局优化引擎Zuo后处理。靠墙家具会自动吸附到Zui近的墙面；家具朝向会自动修正，使其面向房间中心；功Neng组间距规则会被强制执行，比如沙发到茶几保持0.4米，沙发到电视柜保持0.5米；所有家具组之间保持Zui小0.6米的通道宽度。这层优化让AI放出来的家具不只是“不重叠”，而是真正Zuo到了“布局合理”，符合人类的生活习惯。

此外系统还内置了事件驱动的音效系统。网格吸附、家具拾取、放置、删除、旋转，以及结构建造、拆除，dou有对应的音效反馈。这些音效通过独立的SFX Bus管理，用户Ke以在设置中自由开关。这种听觉上的反馈，极大地增强了操作的沉浸感，让每一次点击dou充满质感。

空间语义：让AI真正“kan懂”你的设计

单纯把场景数据丢给模型，它只Nengkan到一堆坐标数字，并不真正理解空间关系。所以Aedifex构建了一套场景序列化系统。每次对话时系统会自动分析当前场景，提取出结构化的上下文信息：每个房间的尺寸形状和AABB边界、所有家具的位置和类别、墙面朝向及其上的门窗位置、楼层结构等。

整个上下文被控制在一定Token以内，并通过内容哈希Zuo缓存，避免重复计算。有了这层空间语义，AI才Neng真正理解用户的自然语言描述。当你说“把沙发前面的茶几往右挪一点”时AINeng准确知道“沙发前面”是哪里、“茶几”是哪个节点、“右”在当前空间中是什么方向。这是基于真实场景数据的空间推理，绝非简单的关键词匹配。

空间检测基于网格洪泛填充算法以0.5m为分辨率扫描整个楼层，标记每个网格单元为空地、墙体、室外或室内，自动识别封闭区域生成房间，并通过Shoelace公式计算面积。墙面也会被标记内外朝向。这种对空间的深度理解，是Aedifex区别于其他普通建模工具的关键所在。

开箱即用：从零开始的搭建指南

说了这么多，如何亲自上手体验呢？Aedifex采用MIT协议开源，欢迎任何形式的参与。其安装过程非常简洁，得益于现代化的工具链。

你需要克隆代码库并安装依赖：

git clone https://github.com/TangSY/aedifex.git
cd aedifex
pnpm install
pnpm dev

访问localhost:3000即可使用。编辑器的所有基础功Neng，包括建墙、门窗、家具、材质、导出、第一人称漫游，dou是开箱即用的，不需要任何配置。

当然Ru果你想体验强大的AI功Neng，还需要配置环境变量。在项目根目录创建.env.local文件，填入以下内容：

AI_API_KEY=your-api-key
AI_BASE_URL=https://api.openai.com/v1  # 可选，默认OpenAI
AI_MODEL=gpt-4o                         # 可选，默认模型

值得一提的是Aedifex兼容任何OpenAI格式的API端点。无论是官方OpenAI、Azure OpenAI，还是本地部署的Ollama、DeepSeek等，只要接口遵循OpenAI的Chat Completions格式并支持Function Calling，就Neng直接接入。这种灵活性给了用户极大的自由度。

编辑器交互Neng力：AI与手动的完美融合

虽然AI是核心交互方式，但Aedifex的手动编辑Neng力同样完整。它支持墙体绘制与实时标注尺寸、0.5m网格吸附、门窗在墙面上的参数化定位、房间多边形和楼板的可视化编辑。甚至支持参考图片导入，缩放范围从0.01x到100x，满足各种精细化需求。

编辑器提供3D、2D、分屏三种视图模式。2000行代码的完整2D编辑界面与3D视图实时同步。选中的物体在两个视图中同步高亮。这种多视图协同的工作流，极大地提升了设计效率。

在3D视口中，你还Ke以通过拉框选择多个物体，支持批量移动、删除、修改材质。框选逻辑独立实现，处理了透视投影下的物体拾取精度问题。此外通过Pointer Lock API，你还Ke以实现沉浸式的第一人称漫游：WASD控制前后左右移动，鼠标控制视角，Q/E键升降，Shift键冲刺。视点高度固定在1.65m，模拟真人站立视角，让你仿佛真的置身于自己设计的空间之中。

细节打磨：那些kan不见的用心

除了上述的大功Neng，Aedifex在细节处理上也堪称典范。比如它内置了带状态机的自动保存系统。3秒debounce防抖、预览模式暂停保存、待保存队列合并、BeforeUnload事件触发紧急刷新防止数据丢失。保存状态在idle → pending → saving → saved → error之间流转，UI实时反映当前状态，让你再也不用担心突然断电导致的心血付诸东流。

撤销重Zuo功Neng支持Zui近50步操作历史，基于Zundo的智Neng差异检测。每次撤销时通过对象引用比较找出实际变geng的节点，只重新渲染这些节点及其父节点，而不是笨重地刷新整个场景。场景变geng检测也Zuo了优化，用单调递增的nodesVersion计数器替代JSON.stringify全量比较，时间复杂度从O降到了O。

AI操作还有独立的操作历史面板每次AI确认的操作会记录在可折叠的列表中，支持单次操作撤销。你不需要回退到某个时间点，Ke以直接撤销中间的某一步操作并恢复对应的节点快照。这种细粒度的控制Neng力，在AI辅助设计工具中是极其罕见的。

系统还内置了Token预估器，支持CJK字符的准确估算，实时监控对话长度。当消耗超过模型上下文窗口的80%时自动调用摘要模型压缩历史对话——保留关键的设计决策和当前场景状态，丢弃中间的试探和调整细节。压缩对用户透明，不会中断对话流程，确保了长对话的流畅性。

设计工具的未来形态

经过这些改造，AedifexYi经不再是原项目加个AI对话框那么简单了而是一个以AI Agent为核心交互方式重新设计的3D建筑编辑工具。它证明了当AI真正深入到底层数据结构和操作逻辑时软件的交互体验Ke以发生质的飞跃。

基于大语言模型的天然多语言Neng力，Aedifex支持任何自然语言交互——中文、英文、日语、法语、西班牙语，你用什么语言说它就用什么语言回应。这种无国界的沟通方式，让全球的设计师douNeng无障碍地使用这一工具。

Ru果你对以下方向感兴趣，特别欢迎参与：优化AI的空间推理Neng力、 家具模型库、改进渲染效果，或者只是修复一个Bug。Aedifex的开源精神，意味着每一个人douKe以成为这个未来的建设者。

总而言之，Aedifex不仅是一个工具，geng是一种宣言。它宣告了设计软件正在从“专家专用”走向“大众共创”，从“繁琐操作”走向“直觉表达”。Ru果你对AI驱动的设计充满好奇，不妨去亲自体验一下或者去GitHub上给它一颗星。毕竟未来的设计方式，可Neng就藏在这几句简单的对话之中。

---