作者：陈墨｜OC 技术编辑

据开发者 magik 在 技术复盘中介绍，约150万行 C++、70万行 Python 的 FreeCAD 已被移植到 WebAssembly，可以在 Chromium 浏览器中运行17个以上工作台、嵌入式 Python、OpenCASCADE 几何内核和3D视图。作者称主要实现工作由 AI Agent Fable 在约四天内完成，并公开了48条人类提示词和会话记录。

一句话结论：这不是“网页重写了一个简化 CAD”，而是把一套强烈依赖桌面操作系统的原生软件静态塞进浏览器；它证明了 Agent 可以推进大型跨平台工程，也同时暴露了浏览器版距离日常生产工具还有多远。

这项工作的难点首先是 FreeCAD 根本不是一个单体程序。它下面叠着 Qt、OpenCASCADE、Coin3D、CPython、PySide6、VTK 和 SMESH，大量模块原本依靠动态加载、线程、子进程、传统 OpenGL 和本地文件系统。WebAssembly 环境里，这些假设大多不存在。

移植方案把 Python 扩展全部静态链接进一个196MB 的 wasm 模块，用 PyImport_AppendInittab 注册；为185处 C++ 模态对话框和大量 Python exec() 保留同步语义，又必须依赖 WebAssembly JSPI 暂停调用栈。因此当前只支持 Chrome/Edge 137 以上版本，Firefox 和 Safari 尚不能直接运行。

3D渲染更麻烦。Coin3D 使用上世纪固定管线 OpenGL，包括 glBegin、矩阵栈和旧式光照，而 WebGL2 已经没有这些接口。项目为此写了约900行兼容层，把需要的固定管线行为翻译到 GLES 3.0；又因为浏览器里的 WebGL context 不能像桌面 OpenGL 那样共享纹理，只能先渲染到离屏缓冲区，再读回交给 Qt 合成。

“四天完成”应该怎样理解

这四天并不是零准备。项目沿用了此前 LibreCAD 和 OpenSCAD 的移植经验，运行在作者所说的高性能机器上，使用三个 Claude Code 会话、15个多 Agent 工作流和159次子 Agent 调用。人类负责确定路线、安装环境、试用界面和报告视觉错误，Agent 负责阅读代码、交叉编译、调试和修改。

这仍然很惊人，但它不是“输入一句提示词，四天后得到 FreeCAD”。更准确的说法是：一名懂目标、愿意持续测试的工程师，把大量实现和排查工作并行委托给 Agent。项目还存在96MB 首次下载、单线程重计算会卡住页面、不能运行外部 FEM 求解器、没有 Addon Manager 和 IFC 等限制。

关键事实

• 首次加载约96MB，完整未压缩资源约277MB。
• 当前使用 wasm32，内存上限4GB，并且主要计算为单线程。
• 17个以上工作台可加载，FEM 可显示已有网格和结果，但不能在浏览器内调用外部求解器。
• 作者公开了源代码、构建脚本、提示词和 Agent 会话，关键说法具有可审查材料。

OC 判断

这个项目最重要的信号不是 FreeCAD 会不会因此变成在线 SaaS，而是软件移植的经济性变了。以前只有资金充足的团队才会尝试这种依赖深、失败面广的工程；现在一个懂系统边界的人可以让 Agent 并行啃掉大量构建与兼容问题。Agent 没有消灭工程判断，反而放大了工程判断的价值。

为什么重要

• 开发者：大型遗留项目的移植、升级和依赖替换，正在成为代码 Agent 的强场景。
• 企业：可验证的会话、补丁和测试记录，比“AI 写了多少代码”更有采购意义。
• 用户：浏览器版已可体验，但重型 CAD 工作暂时仍不能完全替代桌面版。

参考来源

• magik：FreeCAD in your browser
• GitHub：FreeCAD 官方源代码
• FreeCAD Project Association：2026 annual report