Quench3D 更新:用编辑器和 AI 搭建 3D 场景

Quench3D 更新:用编辑器和 AI 搭建 3D 场景

Quench3D 是我正在迭代的开源 Rust 3D 引擎,包含自研物理引擎、PBR 渲染器和桌面/Web 编辑器。这次更新把使用入口整理清楚:可以手工布置场景,也可以让 AI 在当前画面里操作;批量验证和出图则交给 CLI/MCP。

下载桌面版 · 在线编辑器 · 源码与三分钟上手

适合拿来做什么

  • 模型和空间展示:导入模型、创建图元、调整位姿、颜色、灯光和材质,保存 JSON 或导出模型。
  • 物理演示:播放碰撞、堆叠和关节场景,暂停、单步和重置;更完整的设置通过场景 JSON 或 Rust SDK 完成。
  • 空间运动演示:太阳、地球和月球各自公转,月球跟随移动中的地球;配上中文名称、连续轨道线和宇宙星空。
  • agent 自动化:先校验场景,再做不需要 GPU 的物理推演,最后按需截图或输出视频。

天体公转目前使用可保存的运动学轨道动画,不是万有引力或 N 体模拟。它适合表达运动关系;需要科学或工程结论时,应针对目标问题验证算法与误差。

最简单的开始方式

下载对应平台的桌面归档,解压运行 quench3d-editor;Windows 运行 quench3d-editor.exe,不用安装 Rust。

先从“添加”放一个球或方块,调整位置,点击“播放”。工具栏提供标准视角、透视/正交和聚焦选中;左右栏可以拖动调宽或收起。保存 JSON 后可以重新加载,轨道、名称标签、轨道线开关和环境会随场景保留。

需要 AI 时,在右侧“AI 助手 → 本地模型配置”填写 OpenAI Chat Completions 兼容地址和密钥,获取并选择支持工具调用的模型。先试:

创建一个半径 0.4 米的红球,放在 [0,3,0],聚焦它,然后播放仿真。

也可以继续要求:

创建太阳、地球和月球,地球绕太阳,月球绕移动的地球。显示中文名称和连续轨道线,使用宇宙星空,隐藏网格与坐标轴,然后播放。

助手会检查场景、调用工具并记录实际回执;发生错误会显示出来。支持连续追问、停止和会话历史,恢复聊天记录不会自动重放工具。AI 目前主要操作独立图元,不能任意修改模型子网格、复合体或父子层级。

浏览器与外部 agent

在线编辑器可以先体验手工操作。静态站点本身不提供 AI 请求代理;要在 Web 里使用 AI,从源码仓库根目录运行(Python 3.10+,无需额外 pip 包):

1
python3 tools/agent_server.py

访问 http://127.0.0.1:8765,再配置模型。桌面与浏览器分别保存本机配置与历史;密钥不写入场景 JSON,但本地存储不是加密保险箱。

外部 agent 可以通过 quench3d schema --json 获取能力清单,按 validate → simulate → render 的顺序处理场景,也可配置 quench3d mcp 使用 stdio 工具。CLI/MCP 处理文件或内联 JSON,与修改当前编辑器场景的实时工具是不同入口。

详细文档

首页只保留能力、使用场景和最短上手路径。具体参数、工具契约、SDK、验证和性能记录分别整理在项目文档中:

项目还在快速迭代,最新下载统一使用 Release 入口,避免在介绍页固定过时版本号。

Quench3D 更新:用编辑器和 AI 搭建 3D 场景

https://gh503.github.io/blog/2026/11/05/66851b73e18e/

Author

gh503

Posted on

2026-11-05

Updated on

2026-11-05

Licensed under