OpenGeometry:我们把一个真正的 CAD 内核塞进了浏览器,还让它听得懂 AI 的话

先说一句总结:OpenGeometry 是一个开源的、跑在浏览器里的 CAD 几何内核。它不画网格,它算实体。

OpenGeometry 字标

先把身份交代清楚:这个项目是我们自己做的,仓库在 GitHub 上开源,MPL-2.0,内核用 Rust 写,编译成 WebAssembly,外面套一层给 Three.js 用的 TypeScript SDK。说白了,你写几行 JS,浏览器里就能得到一块真正的、精确的、能导出 STEP 的实体,而不是一堆三角形。

为什么非要在浏览器里算 CAD

你可能会问:网页上不是有 Three.js 吗,还要内核干什么?

有,但 Three.js 只负责“画”。它拿到的是一堆网格,你没法问它“这个零件体积多少”“这个点在实体里面还是外面”“挖完这个孔之后还是不是一个合法的闭合实体”。这些是几何内核的活,网格干不了。

那用现成的内核行不行?Parasolid、ACIS 这些是商业的,OCCT 是开源的,但它们都是为桌面写的重型 C++ 库,几百兆,塞进浏览器不现实。而且它们的 API 是为“人一步步点”设计的,让 AI 去调用,处处是坑。

所以我们的选择很直接:内核用 Rust 重写,编译成 WebAssembly 跑在浏览器里,API 设计成“给代码调用”,而不是“给鼠标调用”。一次调用就是一个确定的结果,谁来调都一样。

它到底能算些什么

  • 基本体:长方体、圆柱、圆柱扇区、球、圆锥/圆台、圆环、平面多面体、槽体、圆角盒、管段,还有沿路径立起来的墙。
  • 线框:矩形、圆、折线、正多边形、槽、圆角矩形、直线加圆弧的轮廓、圆弧。每个都能放到任意平面上。
  • 造型操作:拉伸(可以带孔)、扫掠(路径上的圆弧是精确的弯)、旋转、抽壳。
  • 布尔:并、差、交,一次最多可以拿 100 个工具体一起算。
  • 参数化编辑:rebuild 原地换参数,mirror 按平面镜像重建。
  • 装配:父子摆放,平移、旋转、缩放、定位,支持独立副本和共享实例。
  • 显示:每个实体就是一个 THREE.Group,跟随相机的细节层级、在 Worker 里做三角化、能拾取到面和边。
  • 查询:包围盒、体积、面积(带误差上界)、是否有效且闭合、点在不在体内、面在某点的法向、最近一次布尔的报告。
  • 导出:STEP(毫米或米,Y 或 Z 朝上),另外还有给 IFC 写入器用的交换体。

几何内核该干的活基本都在,只是把“桌面”换成了“浏览器”。

为什么标题里要写“给 AI Agent 用”

仓库描述那句 “for Humans and AI Agents”,不是凑字数的。

我们做的时候有个很朴素的判断:以后的 CAD 操作,很大一部分不是人点的,是模型写的。那这个内核就得让模型“写得对、也验得出来”。具体是这几件事:

  • 参数全是普通 JSON,没有指针、没有回调、没有藏起来的状态。
  • 同样的输入永远给同样的形状,Agent 可以复现、可以对比、可以缓存。
  • 每个结果都能当场验:validity() 告诉你是不是合法闭合实体,measure() 给体积和面积并带误差上界,classifyPoint() 判断一个点在体内还是体外,getBounds() 给包围盒。
  • 出错抛 OGError,带 code(比如 InvalidParameter、SharedShape、Disposed),模型可以按 code 分支处理,而不是靠猜报错文字。
  • 文档站放了 llms.txt,把整站文档压成 Markdown 索引,可以直接塞进上下文。

这件事的意义在于:以前所谓的“AI 生成 CAD”,多半是让模型写一段脚本,然后祈祷它能跑通;现在是生成完还能自己检查一遍——体积对不对、是不是闭合、孔有没有打穿。有了这一层自检,它才从 demo 变成能用的东西。

上手:三十行做一块带孔安装板

安装就两行:

npm install opengeometry three

提醒一个坑:three 是 peer dependency,版本要在 0.168 到 0.185 之间;另外包里带的 opengeometry_bg.wasm 和 tessellation-worker.js 两个文件必须能被页面取到,最稳的做法是从 node_modules/opengeometry/ 里把它们拷到站点根目录,再把 URL 传给 create。

import * as THREE from 'three';
import {
  OpenGeometry, Solid,
  OG_OPERATION_SUBTRACT, OG_PRIMITIVE_CYLINDER,
  OG_PRIMITIVE_ROUNDED_BOX, OG_TRANSFORM_TRANSLATE,
} from 'opengeometry';

await OpenGeometry.create(
  { wasmURL: '/opengeometry_bg.wasm' },
  { workerURL: '/tessellation-worker.js' }
);

// 120mm x 80mm x 10mm 的圆角板(模型单位是米)
const plate = new Solid(OG_PRIMITIVE_ROUNDED_BOX, {
  width: 0.12, height: 0.01, depth: 0.08, radius: 0.01,
});

// 四个 8mm 的过孔
const holes = [[-0.045,-0.025],[0.045,-0.025],[-0.045,0.025],[0.045,0.025]].map(([x, z]) => {
  const hole = new Solid(OG_PRIMITIVE_CYLINDER, { radius: 0.004, height: 0.02 });
  hole.transform(OG_TRANSFORM_TRANSLATE, { offset: [x, -0.005, z] });
  return hole;
});

plate.operate(OG_OPERATION_SUBTRACT, { tools: holes });

// 它本身就是个 THREE.Group,直接进场景
scene.add(plate);

// 导出毫米制 STEP,交给下游 CAD/CAM
const { text, report } = await OpenGeometry.exportStep({
  nodes: [plate], unit: 'millimetre', upAxis: 'Z',
});

就这么点代码,一块带圆角、带四个通孔的板子就出来了,而且是一次布尔挖完的,不是四个 mesh 叠在一起。最后那行拿到的 text 就是 STEP 文件内容,直接扔给工厂的软件就能打开。

现在还没有的东西

老实说清楚,别让人踩坑:

  • 3.0 没有样条、没有椭圆、没有椭圆弧。
  • 没有 loft,没有圆角(fillet),没有 STL 导出,没有投影。
  • 公开的三角化、2.0 里的 Cuboid、Polygon、Opening、Vector3 这些类,3.0 都换掉了,迁移要看 MIGRATION.md。

这些不是“以后再说”的托词,是眼下明确的边界。你要做的是需要样条和圆角的复杂曲面零件,现在还得看别的方案。

适合谁,不适合谁

适合:产品配置器、电商下单页、机械零件和机箱、制造下单工具、建筑构件、机器人夹具、几何教学演示、服务端批量出 STEP,以及所有“想让 AI 直接产出可制造几何”的尝试。

不适合:你想要一个桌面 CAD 软件(我们是个库,不是应用);你只是想展示已有的网格(Three.js 就够了);你必须用样条、圆角和 STL。

最后

项目一直在更新,目前 550 个 star 左右,文档、示例和在线 demo 都有。demo 打开就能在浏览器里直接算,不用装任何东西,想验证效果的话点进去比看文章快。

如果你也在浏览器里被“只能画网格”卡过,欢迎来试试;踩到坑直接提 issue,或者来 Discord 找我们聊。

  • 仓库:https://github.com/OpenGeometry-io/OpenGeometry
  • 官网:https://opengeometry.io
  • 文档:https://docs.opengeometry.io
  • 在线 demo:https://demos.opengeometry.io
© 版权声明
THE END
喜欢就支持一下吧
点赞1.2W+ 分享