Serpentine3D:一个人写的开源 NURBS 建模器,Rhino 的手感、AI 的脑子

我做 Serpentine3D,起因特别简单:我想要一个装在自己电脑上、不用订阅、不用联网登录,但真能建出可以拿去加工的东西的建模软件。

市面上不是没得选。Rhino 很好,我用了很多年,但它是商业软件;Fusion 也好用,可模型躺在别人的服务器上;FreeCAD 开源,但那是另一套交互逻辑,你会的那些命令它不认。

所以我想试试:如果命令行的肌肉记忆跟 Rhino 一样,几何内核用的是同一类精确 NURBS 数学,但整个东西是 MIT 开源、免费、Linux / Windows / macOS 都能跑,会怎么样?

Serpentine3D 就是这个答案。

它做的是精确几何,不是网格

这是整件事的地基。内核是 OpenCASCADE 7.9,通过 cadquery-ocp 的 pip wheel 装进来——没有 conda,没有系统包,三个平台上装法完全一样。你建的是 BREP/NURBS 曲线、曲面和实体,跟 Rhino 和 STEP 用的是同一类数学。

差别在哪?一个半径 300 mm 的圆,在任何缩放级别、任何一张图纸上都还是 300 mm。倒角出来的是一个真曲面,不是一堆三角形拼出的近似。视口只在画的时候把精确几何临时网格化,分辨率跟物体尺寸挂钩——这也解释了为什么导出 STL / OBJ / glTF 时会有一个”网格质量 / 偏差”的选项:那是你在决定把精确曲面采样得多细。

拖动一个控制点,整张曲面跟着走,而且仍然是光滑的。这就是 NURBS 和网格最本质的区别——网格动一个顶点,周围会皱。

Serpentine3D 用四条曲线放样出来的花瓶
一张曲面,放样穿过四条曲线——花瓶

先看东西:下面这六件都是在它里面建出来的

样品文件全部随仓库发布,每一个都能用 File ▸ Open 打开、拆开看。我做它们不是为了秀效果,是为了逼自己把真实工作流走一遍——一个模型能不能出图、能不能交接、能不能加工,是建模器真正的考题。

Serpentine3D 建模的扭转塔楼,50 层转四分之一圈
建筑:50 层塔楼,整体扭转四分之一圈
Serpentine3D 建模的六爪钻戒,57 面明亮式切工
珠宝:六爪镶嵌,57 面明亮式切工
Serpentine3D 建模的影视拱门布景,35 个对象 8 个图层
影视布景:一座拱门,35 个对象、8 个图层、3.6 米高
Serpentine3D 建模的旋转楼梯,14 级橡木踏板
室内:旋转楼梯,14 级橡木踏板,3 米升高

命令行说的是 Rhino

这是我最在意的部分。学一个新 CAD,最贵的成本从来不是软件钱,是你那十几年攒下来的手指头。所以 Serpentine3D 的命令行是照着 Rhino 做的,不是”参考”,是尽量能对上。

loft、sweep2、revolve、filletedge、booleanunion、pushpull……两百多个命令,名字和别名都按 Rhino 来。输入 l 是 line,pl 是 polyline,c 是 circle,o 是 offset。提示里括号中的单词就是选项,跟 Rhino 一样,敲前缀或者点旁边的胶囊按钮都行。

  • 坐标直接敲:10,5,0 绝对、@5,0,0 相对、10<45 极坐标
  • Tab 锁定方向,定住方向再输距离,锁定期间对象捕捉照样有效
  • Ctrl + 单击是”电梯”——在构造平面上点一个位置,拉一根竖线上去定高度
  • 右键是回车,Shift 平移、Ctrl 缩放、右键拖拽旋转视图
  • Gumball 做移动 / 旋转 / 缩放,Ctrl+Shift 单击面或边直接推拉和倒圆
  • 对象捕捉一整排:端点、中点、圆心、象限点、交点、垂点、最近点
  • 图层、显示模式(wireframe / shaded / ghosted / rendered / technical)、线型,还有属性面板里的 Attribute User Text

更省事的:Rhino 里 Options → Aliases → Export 导出的别名文件,可以直接在 Settings → Aliases 里导入。认识的命令会自动映射到 Serpentine3D 的对应命令,简单的宏(比如 '_Zoom _Extents)也会翻译过去。快捷键同理,一行一个 F5 zoomextents 就能绑。

文件交换上,Rhino 5–8 的 .3dm 能直接读,图层会跟着进来;写出去时曲线保持精确 NURBS,曲面会转成网格——所以曲面要精确往返,请走 STEP。另外 STEP、DXF、SVG、OBJ、FBX、STL 进出都有,glTF、USD、3MF 可以出,E57 点云可以进。

从模型到一张车间能照着做的图纸

很多开源建模器到”导出一个 STL”就结束了。但真实世界里,模型之后的下一站往往是图纸。

Serpentine3D 是模型空间 + 图纸空间的两套布局,跟 Rhino 的 Layout 一个意思。A4 到 A0 的图幅,detail view 可以按 1:25、1:50 这种真实比例挂着;消隐线视图、尺寸标注、引线、剖面填充、比例尺、标题栏,全部从模型本身生成,最后直接打成矢量 PDF。

Serpentine3D 里把拱门模型布置到 A3 图纸上出图
同一座拱门,布置到 A3 图纸上出图——尺寸、填充、标题栏都来自模型

消隐线这种活是 CAD 里最容易崩的地方,内核遇到退化输入会直接挂掉。所以我把这类操作放到一个独立的 worker 子进程里跑,挂了自动重启——一次失败的投影永远带不走整个程序。自动保存每几分钟一次,崩溃之后可以恢复。

一个能看见视口的 AI 助手

这是我认为最该被拿出来说的一点,因为它不是”外挂一个聊天框”,而是接在同一条命令总线上。

每个命令在内核里都是一个 Python 生成器,它 yield 出”我需要什么输入”:PointReq("Center")、NumberReq("Radius")。同一个命令,四套前端共用——你敲命令行、你在视口里点、脚本调用 doc.run()、AI 通过 MCP 调工具。写一遍,到处能用,撤销、对象捕捉、预览全都是免费送的。

所以助手干的事跟你一模一样:跑命令、看视口截图、检查自己做得对不对、不对就改。改错了?撤销。整条链路是可以回滚的。

接哪家模型都行:

  • Claude:填 Anthropic API Key,或者先设好 ANTHROPIC_API_KEY 环境变量再启动
  • ChatGPT 账号:走官方 Codex app-server,先装 Codex CLI,然后在助手面板里选 ChatGPT 登录
  • OpenAI API Key:直接填
  • 本地模型:LM Studio 的开发者模式起本地服务,地址一般 http://127.0.0.1:1234,Discover 一下选模型就行。推理全程不出这台机器,不需要任何 Key
Serpentine3D 的 AI 助手在视口里生成旋转楼梯
助手在生成旋转楼梯——同一套命令,同一份撤销历史

如果你已经在用 Claude Code、Cursor 这类客户端,还有更直接的用法:助手面板里选 External assistant · MCP,它会给你一段现成的配置。加上之后,你外面那个 agent 就能直接操作当前打开的 Serpentine 会话。它拿到的工具包括 serp_command(能跑你能敲的任何命令)、serp_screenshot(截视口)、serp_scene_info、serp_measure、serp_export、serp_undo 等等。

通讯是本地回环上的 JSON-RPC:程序在 ~/.serpentine3d/rpc.port 写一个端口号,MCP 服务去连。设 SERP3D_NO_RPC=1 可以关掉。

没界面,它也是同一个引擎

因为命令层从来不 import Qt,整个建模内核脱离 GUI 也能跑。同一个引擎,三种跑法:内置编辑器的脚本、命令行的 serp3d-batch、MCP 驱动的实时会话。

# make_part.py,运行:serp3d-batch make_part.py crate.step
box = doc.add(geo.make_box((0, 0, 0), 100, 100, 100), name="Crate")
doc.run("filletedge", ["Crate", "", "5"])
doc.export(args[0] if args else "crate.step")

doc.run 的玩法是”替命令回答问题”——你给命令名和一个回答列表,它按提示顺序走一遍。所以任何能在界面上敲的命令,都能在脚本里跑。批量生成一百个尺寸变体、在没显示器的 CI 服务器上跑、挂到构建流水线里,都行。

动手做之前,先检查

建模器最容易骗人的地方,是”看起来没问题”。所以内置了几个专门的检查命令:

  • zebra 斑马纹——看两张曲面相接的地方是 G1 还是 G2
  • curvature / curvaturegraph 曲率着色和曲率梳,找出局部的鼓包和急转
  • draftanalysis 拔模分析,确认模具能脱模
  • printcheck 3D 打印检查:开口边、薄壁、悬垂角,在切片软件之前先把问题找出来

下载

当前版本 0.13.1。每个包里都自带 OpenCASCADE 内核和它自己的 Python,不需要你另外配环境;界面需要 OpenGL 3.3 的显卡,纯无界面用法在哪都能跑。

平台文件大小说明
LinuxSerpentine3D-x86_64.AppImage509 MB加个可执行位直接双击,不用装
WindowsSerpentine3D-Setup-x86_64.exe119 MB暂时没签名,弹窗选”更多信息 → 仍要运行”
macOSSerpentine3D-0.13.1-arm64.dmg268 MBApple Silicon,macOS 14+,首次右键打开

想从源码跑也行,Python 3.10 以上:

git clone https://github.com/chisomobanzi/Serpentine3D && cd Serpentine3D
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/serp3d        # 启动
.venv/bin/pytest        # 跑测试

它现在还不是什么

这点我想说清楚,省得你下载完失望。Serpentine3D 是个年轻、目标很窄的建模器:它把直接建模的 NURBS/BREP 和制图这两件事做得不错,但它不是 Rhino 的完整替代品。目前明确没有的:

  • Grasshopper 那种可视化编程,也没有完整的参数化历史(recordhistory 只覆盖 loft / extrude / revolve)
  • SubD 细分建模
  • 真正的渲染引擎——rendered 是有光照的预览,不是光线追踪;材质和灯光的深度也远不如 Rhino
  • 那些长尾的专业命令,以及第三方插件生态

如果你依赖的某个命令不在了,大概率是在路线图上——去 GitHub 提,是有人看的。

最后

Serpentine3D 是免费的,而且会一直免费:没有订阅,没有许可服务器,没有”升级到 Pro”。这东西是我在别的工作之间挤时间一个人写的,一直有人在用我就一直往下做。如果它对你有用,在 Ko-fi 上请我喝杯咖啡就能让它继续跑下去。

Serpentine3D 建模的镂空环形雕塑,蛇纹石材质
蛇纹石里的镂空环——名字的另一个来处

名字的来源有两层:一个是津巴布韦绍纳雕塑用的蛇纹石(serpentine),一个是 NURBS 几何里那条贯穿始终的 S 形曲线。两个意思我都喜欢,就都用上了。

代码 MIT 协议,随便改、随便商用。仓库在这里:github.com/chisomobanzi/Serpentine3D,官网和文档在 chisomobanzi.github.io/Serpentine3D。如果你也是从 Rhino 过来的,文档里专门有一页 Coming from Rhino,把习惯怎么迁、缺什么,一条条列清楚了。

© 版权声明
THE END
喜欢就支持一下吧
点赞1.8W+ 分享