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

先把身份交代清楚:这个项目是我们自己做的,仓库在 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







