3D New Era AI

3D New Era AI

英语 · 巴西葡萄牙语 · 网站 · 在浏览器中试用

一款开源的住宅设计、平面图和室内设计编辑器，以 Rust 编写， 旨在让你的 AI 与你协作设计。它内置了 Model Context Protocol 服务：Claude、ChatGPT、Codex、 Gemini、Cursor 或其他 MCP 客户端都可以绘制墙壁、布置房间、打造定制家具、根据真实标准检查照明和人体工学，并渲染照片； 每项更改都会实时显示在屏幕上，只需按下 Ctrl+Z 即可撤销。

一款适用于 Windows、macOS、Linux 和浏览器的 Sweet Home 3D 替代产品，支持英语、 葡萄牙语、西班牙语和法语。

三种使用方式

桌面应用和浏览器编辑器均免费、开源且无需账户。托管连接器在配额范围内免费；详情请参阅定价。

安装

Windows — 在 PowerShell 中运行：

irm https://raw.githubusercontent.com/leandrodaf/3d-new-era-ai/main/scripts/install-windows.ps1 | iex

macOS（Apple Silicon 和 Intel）— 在终端中运行：

curl -fsSL https://raw.githubusercontent.com/leandrodaf/3d-new-era-ai/main/scripts/install-macos.sh | bash

或使用 Homebrew：brew install --cask leandrodaf/tap/3d-new-era-ai。

安装程序仅为当前用户安装，无需管理员密码：应用会显示在“开始”菜单或 Launchpad 中，newera 会添加到你的 PATH，如果你安装了 Claude Code 和 Codex，MCP 服务会在其中注册；再次运行同一命令即可更新。使用 install-macos.sh --uninstall 卸载，或在 Windows 上通过设置 → 应用卸载。

更喜欢直接下载？

托管服务，无需安装。 在 Claude 或 ChatGPT 中，添加自定义连接器，地址为 https://mcp.3dneweraai.com/mcp，然后使用邮箱登录。分步说明： https://3dneweraai.com/connector/.

使用桌面应用。 编辑器打开时，会在 http://127.0.0.1:7878/mcp 提供 MCP 服务（也可以运行 newera serve，无需打开窗口）。AI 菜单或状态栏中的 MCP 标记会显示适用于你所用客户端的配置片段，也可以替你完成注册，并列出 Agent 调用的工具。

通过浏览器标签页。 打开 https://3dneweraai.com/app/，然后在 AI 面板中开启 MCP（Ctrl+Shift+M）。标签页会获得一个 AI 可通过小型中继访问的地址，因为标签页无法监听端口。中继只传递消息，不存储任何内容；项目保留在标签页中，关闭 MCP 或关闭标签页后，该地址就会停止响应。请像对待密码一样保护这个地址。此处不提供视频渲染，因为渲染会让标签页被占用数分钟。

然后只需提出请求，例如：“画一间 4 × 5 m 的卧室，带一扇门和一扇窗，摆上家具并渲染成照片。”

客户端设置

安装应用后，只需点击一次：

Claude Desktop： 从最新版本下载 newera-mcp.mcpb 并打开。

带有技能的插件：

claude mcp add --transport http newera http://127.0.0.1:7878/mcp

codex mcp add newera --url http://127.0.0.1:7878/mcp

gemini mcp add --transport http newera http://127.0.0.1:7878/mcp

code --add-mcp '{"name":"newera","type":"http","url":"http://127.0.0.1:7878/mcp"}'

{ "mcpServers": { "newera": { "url": "http://127.0.0.1:7878/mcp" } } }

{ "mcpServers": { "newera": { "serverUrl": "http://127.0.0.1:7878/mcp" } } }

{ "mcpServers": { "newera": { "command": "npx", "args": ["-y", "mcp-remote", "http://127.0.0.1:7878/mcp"] } } }

{ "mcp": { "newera": { "type": "remote", "url": "http://127.0.0.1:7878/mcp" } } }

{ "mcpServers": { "newera": { "command": "newera", "args": ["mcp"] } } }

这是一套真实的 105 m² 公寓，仅通过 MCP，由 AI Agent 完成设计、布置、灯光和拍摄。设计以开放许可的户型图为基础：墙体来自扫描图，门的开启方向正确，设有格栅电视墙、L 形厨房，以及使用 cabinet_run 设计的衣柜；筒灯依据 NBR ISO/CIE 8995-1，通过光度计算确定规格，并生成路径追踪照片。以下每张图片都直接从编辑器导出。查看构建过程 →

带真实饰面的平面图	鸟瞰剖面图

日光下	黄昏时，灯光亮起

定制木作与房间

功能

• 从任意图纸开始。 绘制墙体、弧形墙和斜墙，或按真实比例导入扫描图，让 background 查找墙体。可直接打开 Sweet Home 3D（.sh3d）项目。
• 可供工坊制作的定制木作。 参数化橱柜、衣柜、格栅板、带精确水槽和灶台开孔的台面、带 LED 灯的石膏板灯槽，以及模块化沙发。cabinet_run 可在墙面上布置均匀模块，避开门、窗和转角；cut_list 可将板材清单导出为 CSV 或 DXF/SVG 图纸。
• 依据实际居住者需求进行核验。 提供人体工学评审（通行空间、每人的床位和浴室、厨房工作三角区、轮椅回转空间），并通过光度计算按房间检查照度。每项结果都关联其依据，并提供可直接应用的修正方案。
• 电气与管道图覆盖同一张平面图：包括电路和配电箱、Wi-Fi 覆盖范围、管线布设，以及依据 NBR 5410、NBR 5626 和 NBR 8160 的检查。
• 为项目呈现增色的图像。 生成带真实饰面的渲染平面图、立面图和剖面图、鸟瞰剖面图、根据指南针方向确定太阳位置并采用已布置灯具的路径追踪照片，以及沿相机路径拍摄的视频。渲染由 CPU 完成，因此无头服务也能生成这些内容。
• 屋顶与结构。 包括带天窗的坡屋顶、沿屋顶延伸的墙体和玻璃、横梁、楼层、泳池和露台。
• 家具尺寸始终准确。 目录由代码生成，因此平面图、3D 模型和碰撞检查中的 158 × 208 cm 床都精确符合这一尺寸。
• 安全地尝试不同方案。 将平面图复制到新标签页，修改后并排比较不同版本；还可为检查点命名并随时返回。
• 专为 Agent 打造。 人员和 Agent 使用相同且可撤销的命令。短 ID（w12）、以厘米为单位的 [x, y] 坐标、精简读取结果和单行写入响应，都有助于降低 token 用量。
• 开放且可扩展。 可通过 HTTP API 使用任意语言编写插件；支持多人通过具名光标协作编辑同一项目；并可导出为 PDF、SVG、PNG、GLB 和 OBJ。

MCP 工具

读取和修改由不同的工具负责：读取操作不会更改平面图，因此 AI 客户端可直接执行，无需征求同意；每次修改前都会征求同意。

命令行

newera [FILE]           # desktop editor with the embedded HTTP + MCP server
newera --demo           # start with a sample house
newera gui --no-server  # editor only
newera serve [FILE]     # headless HTTP + MCP server
newera mcp              # MCP over stdio (attaches to the open window, if any)

选项：--addr 127.0.0.1:7878（或 NEWERA_ADDR）；--token（或 NEWERA_TOKEN），在监听回环地址以外的地址时为必需项；NEWERA_LOG 用于设置日志过滤器；NEWERA_RENDER_THREADS 用于照片渲染（默认使用一半的核心数）。服务默认绑定到回环地址，并会验证 Host 标头。在 Windows 上，newera-gui.exe 会打开编辑器，且不会显示控制台窗口。

从源代码构建

你需要 Rust 1.95 或更高版本（rustup）。在 Linux 上，还需要 libxkbcommon-dev libwayland-dev libx11-dev libxcursor-dev libxrandr-dev libxi-dev。

git clone https://github.com/leandrodaf/3d-new-era-ai
cd 3d-new-era-ai
make run          # editor + HTTP + MCP, with a sample house
make release      # optimized binary in target/release/newera
make web-serve    # browser editor and viewer at http://127.0.0.1:8790

运行 make 查看所有命令。若要自行托管浏览器编辑器，请将 web/ 作为静态文件提供，并将 .wasm 文件的 MIME 类型设为 application/wasm，同时进行压缩（原始大小约为 15 MB，gzip 压缩后约为四分之一）。无需后端或特殊标头。公共网站通过 scripts/site-build.sh 构建，并在每次推送到 main 时部署。

浏览器： Chrome、Edge 和 Safari 26 使用 WebGPU。若浏览器不支持 WebGPU（目前 Firefox 不支持），编辑器会回退到 WebGL 2，仍可绘制所有内容；若浏览器两者都不支持，则会显示一条指引用户下载的消息。

项目结构

crates/
  newera-core        domain model, commands, undo/redo, geometry, standards — no UI, no I/O
  newera-catalog     parametric furniture and fixtures at exact sizes; OBJ/glTF import
  newera-joinery     parametric joinery and interiors, workshop rules, cut lists
  newera-ergonomics  habitability review: clearances, occupancy, kitchens, accessibility
  newera-draw        plan scene shared by the editor, PNG renders and SVG/PDF export
  newera-render      3D meshes, software renderer, path-traced photos, videos
  newera-sh3d        Sweet Home 3D (.sh3d) import
  newera-mcp         the MCP tools, over stdio and Streamable HTTP
  newera-server      REST API + MCP endpoint, sessions (axum)
  newera-plugins     external programs that edit the home over the HTTP API
  newera-app         desktop editor (egui + wgpu)
  newera-editor-web  the editor in the browser (WebGPU or WebGL)
  newera-web         lightweight WebAssembly viewer
  newera-relay       lets an AI reach the editor in a browser tab
  newera-cloud       the hosted service: accounts, OAuth, cloud projects, billing
  newera-telemetry   crash reports and usage notes
  newera             the binary that wires everything together

文档

• 架构：crate、命令模型、MCP 设计和安全性
• 标准与来源：审查中的每条规则的出处
• 作品展示：由 Agent 构建的完整公寓
• 分发：渠道、发行版本和托管服务
• 路线图和更新日志

隐私与遥测

应用会通过 Sentry 发送崩溃报告，以及 Agent 使用 MCP feedback 工具留下的备注。该功能默认开启，可在帮助 → 发送错误报告中一键关闭，也可运行 newera telemetry off 关闭；设置 NEWERA_TELEMETRY=0 可在单次运行中关闭。不会发送任何项目内容、IP 地址或机器名称，并且会从每份报告中移除 MCP 令牌。备注始终保存在本地配置文件夹中的 notes.jsonl 文件里。

在相同的开关控制下，打开应用会记录一次 app_open，包含随机安装 ID、版本、操作系统、架构和模式；显示支持请求时会记录一次 support_prompt，并记录关闭它的按钮；安装程序则会分别记录一次安装和一次卸载，并注明系统以及应用是来自发行版本还是在本机编译。这些记录都会发送到 3dneweraai.com/ping，这是网站上的一个端点，用于保存 Google Analytics 密钥并转发记录，且不会传递 IP 地址，而是传递 Cloudflare 已知的国家/地区信息。未使用项目密钥构建的版本也会通过同一端点报告，因此从源代码安装与其他安装一样会被计数；在克隆仓库上运行 cargo build 和 CI 则不会产生任何记录。托管服务只保留所需信息：你的电子邮箱、项目和使用情况，绝不保留对话内容。请参阅隐私政策。

除该开关控制的内容外，桌面应用打开时会向 GitHub 公共 API 查询最新发行版本，不会发送任何安装信息；若有更新版本，应用会在状态栏中提示。

支持项目

以上所有内容均免费，并将一直免费。如果它为你节省了时间，支持者计划（每月 5 美元或每年 48 美元）可提高你账户的云端配额，并为服务器提供资金。

贡献

欢迎贡献。请参阅 CONTRIBUTING.md；make check 会运行与 CI 相同的检查。

许可证

你可以选择依据 Apache License 2.0 或 MIT license 获得许可。