在机械设计与 3D 建模领域SolidWorks 几乎是许多工程师的第一选择但它属于商业授权软件采购成本高、License 管理复杂也摆脱不了对 Windows 环境的依赖。这几年出现了不少试图替代它的开源项目其中 Partmode 是一条值得关注的技术路线。Partmode 是一个基于浏览器的参数化 3D 建模开源项目面向机械设计场景把建模能力打包进 Web 环境并提供 Live Browser Demo方便用户体验和评估。本文围绕 Partmode 展开从参数化建模原理、浏览器端运行机制、STEP/DXF 数据交换到常见故障排查完整梳理一遍。整篇文章适合三类读者第一类是正在做开源 CAD 选型调研的开发者第二类是使用 SolidWorks 但在评估能否用浏览器方案做轻量建模的机械工程师第三类是计划在 Web 端集成 3D 建模能力的前端工程师。读完这篇内容你会理解 Partmode 的边界在哪里、浏览器实时建模是怎么实现的、导入导出数据时容易踩哪些坑以及从 Demo 进入自部署生产环境之前还需要补齐哪些工程能力。1. 先理解 Partmode 的定位浏览器里的参数化 CAD而不是一个简单三维查看器1.1 它解决什么问题传统 CAD 软件的核心能力不是画一个立方体而是维护一组可编辑、可约束、可联动的几何关系。SolidWorks 这类桌面软件通过特征树、草图约束、参数方程把模型组织成一条可追溯的设计历史链修改一个尺寸下游特征自动重建。Partmode 想做的事情就是把这条设计历史链搬到浏览器里。用户不需要安装客户端不需要处理 Windows 注册表不需要下载几个 GB 的安装包只需要打开浏览器就能创建草图、拉伸成体、修改参数并实时看到结果。这种能力对团队协作非常有价值模型文件可以放在 Web 服务器上所有人打开同一个 URL 就能查看和编辑版本管理可以直接对接 Git设计评审不用再传大附件。Partmode 的 Live Browser Demo 就是让用户在决定是否选型之前先花几分钟在真实模型上验证这条链路是否可行。1.2 它和 SolidWorks 的边界为什么不能简单画等号Partmode 出现在 SolidWorks open source alternative 的语义下但它和 SolidWorks 的关系不是完全代餐而是特定场景下的开源替代方案。两者都需要先讲清楚。SolidWorks 是完整的商业化桌面 CAD 套件覆盖从零件建模、装配体约束、工程图出图、运动仿真、有限元分析到 PDM 数据管理的一整条结构化流程。它依赖本地高性能 GPU 和多核 CPU支持大量工业级文件格式也拥有几十年积累的用户生态和插件库。Partmode 这类 Web CAD 的优势主要在轻量、跨平台、易协作但它的成熟度还受到几何内核性能、浏览器内存限制、复杂装配体能力不足的约束。替代更适合理解为在一个成本敏感、需要快速迭代、以中轻度建模为主的团队里用 Partmode 替换部分原本需要付费 CAD 才能完成的工作。1.3 这类开源自部署 CAD 适合谁用考虑到输入材料里大量出现solidworks下载、solidworks安装、solidworks卸载这类热词说明很多用户对传统桌面 CAD 的安装部署和维护已经厌倦了尤其是许可证不可用、系统更新后环境损坏这类问题几乎每天都在消耗时间。Partmode 的浏览器模式天然规避了这些维护负担。适合采用 Partmode 的场景至少包括教学场景学生使用浏览器即可完成基础草图与拉伸练习省去机房安装授权。轻量出图与方案验证快速创建结构外形、检查尺寸、导出 STEP 给上下游。云原生 CAD 产品原型开发者基于 Partmode 快速搭建定制化 Web 建模工具。内网隔离环境把前端静态产物和模型数据部署在内网浏览器访问即可使用。不适合的场景则是大型装配体、高复杂度曲面建模、标准化出图以及依赖 SolidWorks 专属宏和插件生态的既有生产线。选型之前先按模型复杂度做一次评估比直接替换要稳妥得多。2. 跑通 Partmode 的 Live Browser Demo从打开网页到完成第一个拉伸特征2.1 环境准备先确认浏览器、GPU 和网络三项条件Partmode 的核心能力在浏览器里运行所以不需要安装 C 盘依赖也不需要配置环境变量。但浏览器 CAD 不是一个普通网页它依赖 WebAssembly 执行几何内核依赖 WebGL/WebGL2 渲染三维场景还依赖较大的前端资源包。这三项条件不满足表现通常是白屏或加载卡死。在进入 Demo 页面之前先按下面的清单确认环境检查项要求检查方式浏览器版本建议 Chrome / Edge 最新版访问chrome://version查看版本WebGL2必须开启浏览器地址栏访问chrome://gpu查看 WebGL 状态JavaScript 内存建议 4GB 以上可用内存任务管理器确认空闲内存网络首次加载需要下载几何内核 Wasm 文件观察浏览器网络面板资源加载情况可以使用浏览器控制台执行下面这段 JavaScript快速判断 WebGL2 是否可用const canvas document.createElement(canvas); const gl canvas.getContext(webgl2); console.log(gl ? WebGL2 available : WebGL2 unavailable);如果执行结果是WebGL2 unavailable说明浏览器禁用了硬件加速或者当前机器没有可用的 GPU 驱动。进入浏览器设置打开硬件加速重启浏览器后再试。Partmode 在软件渲染下也能运行但大型模型会明显卡顿。2.2 进入 Demo 页面后先看模型树和参数面板打开 Partmode 官方 GitHub 仓库或项目首页找到 Live Browser Demo 入口。页面加载完成后通常能看到三个关键区域左侧是特征树或零件列表中间是三维视口右侧或底部是参数面板。第一次打开不要急着操作先确认这三个区域是否正常渲染。这里要解释清楚为什么先看特征树很重要。Partmode 的建模方式不是直接拖拽一个立方体到场景里而是通过创建草图 - 添加约束 - 拉伸或切除 - 再次编辑参数这条链路来生成模型。特征树记录的就是这条链路。如果特征树区域是空的说明还没有创建任何特征如果特征树有节点但视口不显示则大概率是渲染层问题。可以通过拖动鼠标观察视口交互是否流畅按住中键旋转、滚轮缩放、右键平移。如果模型旋转时有明显掉帧或画面撕裂先调整浏览器硬件加速设置再检查显卡驱动。2.3 用参数化草图生成第一个拉伸特征为了测试 Partmode 的实际建模能力建议从最基础的特征开始草图矩形、标注尺寸、拉伸成体。下面是完整操作思路实际按钮名称以当前 Demo 版本为准但流程具备代表性新建一个零件。选择基准面通常是 Top Plane 或 XY Plane。进入草图模式创建矩形草图。给矩形两条边添加尺寸约束例如长度 100、宽度 60。退出草图。选择拉伸命令设置拉伸高度 40。确认生成拉伸特征。在参数面板中拉伸高度会作为一个独立参数暴露出来。尝试把高度从 40 改成 80观察模型是否实时更新。如果模型能在数秒内完成重建说明浏览器的 WebAssembly 几何内核工作正常。到这里第一个拉伸特征已经完成。这个过程背后涉及两个关键机制草图约束如何驱动几何体重建以及特征在浏览器内存中如何被记录。接下来会展开说明。2.4 修改参数并观察实时预览验证参数化链路参数化建模的核心是参数改变 - 特征重建 - 模型更新这一条链路。在 Partmode 的 Demo 中这种实时的反馈能力远远比重新导入模型文件高效。实际操作时可以多试几个参数场景把宽度从 60 改成 90观察矩形是否按预期变宽。在草图中给矩形中心和原点添加重合约束再移动原点观察整个矩形是否跟随。在拉伸特征上方再叠加一个圆孔草图使用切除命令观察特征树中是否新增一个Cut节点。如果第二个特征依赖于第一个特征的表面Partmode 需要能识别模型的拓扑面。这个能力由几何内核提供不同开源项目实现程度不同。如果在复杂模型上出现面选择失败或特征重建报错那是几何内核覆盖度的问题不是操作错误需要记录复现步骤并提交到项目 issue。3. 参数化机制的底层几何内核、特征树与 WebAssembly 如何配合3.1 为什么参数化建模比布尔运算更适合设计迭代创建三维模型有很多种方式。最简单的思路是直接拉伸、旋转、差集像做布尔运算一样拼出一个造型。这种方式适合一次性建模但不适合修改如果客户要求把孔距从 40 毫米改成 50 毫米模型设计师需要重新选择所有相关面、重新做一次布尔运算效率很低。参数化建模把创建过程也变成模型的一部分。建模时记录这里创建了一个矩形草图长 100宽 60然后在该草图所在平面法向拉伸 40 毫米。当长宽参数变化时内核会按顺序回放这条建模历史自动重建拉伸结果。这就是 SolidWorks 特征树的本质也是 Partmode 想复刻的核心能力。在 Partmode 中特征树里的每个节点都是一次几何操作节点之间的父子关系构成了重建顺序。修改参数时系统会标记下游所有节点为需要重建然后逐个重新执行。这种机制同时带来两个结果一是模型具备很强的可编辑性二是复杂模型重建会非常消耗计算资源。浏览器里做实时重建对内核性能要求更高。3.2 OCCT 转 WebAssembly 后的能力边界Partmode 这类 Web 端参数化 CAD 项目几乎绕不开一个底层库OCCTOpen CASCADE Technology。OCCT 是开源几何内核提供 B-Rep 实体建模、参数化曲线曲面、布尔运算和 STEP 文件读写等能力是许多开源 CAD 项目的基础。在桌面端OCCT 以 C 库形式存在。要在浏览器里使用它需要把 C 代码编译成 WebAssembly也就是常说的 OpenCascade.js 这类方案。WebAssembly 的优势是执行效率接近原生但需要下载一个较大的.wasm文件首次加载会比较慢。这里有一个容易误解的点浏览器里的 OCCT 并不是简化版而是同一套 C 代码的交叉编译产物核心算法一致。但实际可用性会受内存限制、单线程性能和前端封装程度影响。复杂装配体或高精度曲面模型在浏览器里重建时可能变慢甚至失败。这不是 OCCT 算法的问题而是 WebAssembly 运行时资源和浏览器内存上限的问题。3.3 特征树结构草图和特征如何在浏览器里保持可编辑状态Partmode 的模型在浏览器里不是一张静态的三角网格而是一棵可解释的设计历史树。网格只是最终渲染结果真正的数据对象仍然包含草图曲线、约束、尺寸、特征类型和参数。这种设计决定了模型能否被继续编辑。一个典型零件的数据结构可以简化如下数据对象作用示例Sketch保存二维曲线、点和约束一个矩形草图Constraint约束曲线之间的几何关系水平、垂直、重合、等长Dimension保存数值参数长 100、宽 60Feature把草图和三维操作绑定Extrude、Cut、Fillet 等FeatureTree维护特征依赖顺序草图1 - 拉伸1 - 草图2 - 切除1修改参数时Partmode 会把用户修改的值写入 Dimension 对象然后通知 FeatureTree 从该节点开始重新执行后续特征。这也是为什么模型绘制过程要先有草图再建特征因为特征需要引用草图曲线作为几何输入。理解这个结构之后再去看 Live Demo 的特征树和参数面板就不会觉得它们只是装饰。它们直接映射到内核中的设计历史链是参数化建模的核心控制面。4. 数据交换STEP 和 DXF 在 Web 端的导入导出路径4.1 先搞清格式差异避免在格式选择上踩坑在 CAD 生态里数据交换是绕不开的话题。Partmode 这类 Web CAD 不能只在自己内部闭环必须能接收上游的 STEP 模型也必须能输出下游需要的格式。常见的两种格式用途完全不同格式主要场景特点STEP (.step/.stp)三维实体模型交换保留 B-Rep 实体和曲面保真度高DXF (.dxf)二维图纸与轮廓数据主要用于草图和平面轮廓STL (.stl)3D 打印和网格显示只保存三角面片丢失参数信息OBJ (.obj)渲染场景网格数据不支持特征树对于导入 SolidWorks 模型继续编辑这个需求STEP 是正确的选择因为 STEP 能保存曲面和实体拓扑。STL 只能用于查看外观不能用于参数化编辑。4.2 导入 STEP 文件的浏览器操作流程在 Partmode 中导入 STEP 文件一般有两种入口从文件菜单选择导入或者把.step文件直接拖拽到三维视口。浏览器会读取本地文件传给 OCCT 内核解析再生成渲染数据。需要注意浏览器端的 STEP 导入不是简单的二进制解析而是要完成以下几件事读取 STEP 头段和数据段。识别实体类型例如 ADVANCED_BREP_SHAPE_REPRESENTATION。在 OCCT 中重建 B-Rep 拓扑结构。把 B-Rep 模型离散成三角网格用于显示。执行完成后特征树里出现的通常是一个导入实体节点而不是原始建模步骤。这意味着导入的 STEP 模型可以作为整体查看和输出但无法像原生建模那样点击一个尺寸就去修改参数。这是当前 Web 参数化 CAD 的普遍边界OpenCascade.js 的解析能力也存在版本差异。4.3 导出格式的选择要看下游要什么Partmode 的输出能力决定了它能不能进入真实工作流。如果下游是 SolidWorks 用户应优先导出 STEP因为 SolidWorks 对 STEP 的支持成熟能保留完整实体模型。如果下游是激光切割或平面加工需要导出 DXF 轮廓。如果只是做 3D 打印STL 就够用。导出 STEP 时如果遇到模型导入 SolidWorks 后特征变成只读实体这是正常现象因为 STEP 本身不保存创建历史。这不是 Partmode 的 bug而是格式语义的限制。导出 DXF 时常见问题是圆弧和多段线的精度、单位选择以及图层命名。不同 CAD 软件对 DXF 的读取实现有差异建议导出后在下游软件里逐个检查关键尺寸而不是直接信任预览图。4.4 为什么导入导出最容易出现看起来没问题但下游报错这类问题在数据交换中非常典型。浏览器里模型显示正常但把文件发给同事后对方打开报错或尺寸对不上。常见原因有问题现象常见原因检查方式SolidWorks 打开 STEP 后是坏面导入时几何容差过大调整导入容差后重新导出DXF 尺寸比例不对单位设置不一致例如 mm 和 inch统一检查单位和比例模型破面、有缝隙原始 STEP 文件本身有缺陷用其他查看器交叉验证导入后特征树为空STEP 是 B-Rep 实体不含创建历史查看 Face/Edge 拓扑而非特征树建议在导出前先做一次交叉验证用另一个开源查看器打开导出的 STEP确认实体完整再发给下游。这可以隔离是 Partmode 导出问题还是下游 CAD 导入问题。5. 浏览器 CAD 的常见故障与排查路径5.1 现象页面白屏或模型区不渲染Partmode 打开后白屏是最常见的故障原因通常不在建模逻辑而在浏览器渲染链路。按顺序排查打开浏览器开发者工具F12切到 Console 面板看是否有 JavaScript 报错。在 Network 面板查看.wasm文件是否加载成功如果显示失败说明几何内核文件没有正确加载。执行 WebGL2 检测脚本确认渲染上下文可用。查看浏览器的硬件加速状态关闭硬件加速会导致 WebGL 不可用。尝试无痕窗口排除浏览器缓存或扩展脚本干扰。// 在控制台运行检查 WebGL 上下文是否可用 const canvas document.createElement(canvas); const gl canvas.getContext(webgl2); console.log(gl ? WebGL2 OK : WebGL2 unavailable);如果控制台出现类似Error fetching wasm的提示说明项目的.wasm文件没有正确部署或没有通过 HTTP 服务器访问。注意直接双击 HTML 文件使用file://协议打开时WebAssembly 加载通常会因为跨域限制失败必须通过本地服务器访问。5.2 现象大文件导入后浏览器崩溃或无响应浏览器端建模受内存限制影响很大。STEP 文件内部是精确的几何实体单个实体可能包含大量曲面和边界边。导入时 OCCT 会建立拓扑结构同时生成三角网格这会在很短时间内消耗数百 MB 甚至 1GB 以上内存。如果导入大文件时页面卡死优先检查任务管理器中浏览器进程的内存占用。解决方案是按层级推进先导入只含几十个实体的测试模型确认流程正常再逐步提升复杂度。超大模型不建议直接拖入浏览器可以先在桌面端简化模型或把装配体按零件拆分后逐个导入。5.3 现象模型显示错乱或尺寸不对显示错乱的根源通常是两种三角网格离散精度不足或单位换算错误。Partmode 内部生成的网格是为了显示用的不是精确几何。如果模型出现锯齿、破面、倒角显示不圆滑需要调整网格离散精度参数。在 OCCT 中常用linear deflection和angular deflection控制网格精度降低线性偏差值会让曲面更光滑但也会增加渲染开销。尺寸不对则优先怀疑单位。STEP 文件本身可以携带单位信息但不同软件导出时的处理方式不一致。如果模型在 Partmode 中打开后长度是预期的 25.4 倍基本可以判定是英寸和毫米的换算问题。这时候需要检查导入设置里是否有单位选项或先在源软件中把模型切到毫米单位再导出。5.4 现象本地部署后 Wasm 加载失败Live Demo 在官网能正常打开但自己部署到内网后加载失败通常不是代码问题而是静态服务器的配置问题。.wasm文件需要正确的内容类型MIME 类型才能被浏览器执行。如果服务器返回的 Content-Type 是application/octet-stream部分浏览器会拒绝执行。常见的静态服务器配置如下location /wasm/ { add_header Content-Type application/wasm; }同时要注意OCCT 的 Wasm 文件体积较大如果服务器开启了压缩需要确认 gzip 或 brotli 压缩不会导致二进制文件损坏。部署完成后直接访问.wasm文件的 URL确认浏览器能以application/wasm类型加载。5.5 排查顺序速查表遇到浏览器 CAD 故障时不要一开始就怀疑模型数据先按这个顺序排查排查层级检查内容工具1. 输入文件格式、单位、导出软件文件管理器、阅读器2. 环境浏览器版本、WebGL2、内存chrome://gpu、控制台3. 加载Wasm 是否成功下载Network 面板4. 渲染WebGL 是否报错、GPU 是否可用Console 面板5. 数据处理导入容差、单位、网格精度导入设置6. 逻辑特征重建是否失败特征树、日志输出这套顺序同样适用于其他 Web 端 CAD 工具不只是 Partmode。6. 开源替代方案选型Partmode 与桌面 CAD 的场景差异6.1 两者的本质差异不在功能数量而在数据所有权Partmode 和 SolidWorks 的关键差异不只是免费与付费而是数据所有权和工作流方式。SolidWorks 把数据保存在本地文件或 PDM 系统里依赖 Windows 客户端Partmode 把模型数据保存在浏览器内存和文件系统中天然适合 Web 部署和协作。同时要意识到开源不等于免费维护。Partmode 的代码可以自部署但部署、升级、二次开发、培训都需要投入工程资源。如果团队没有前端和 WebAssembly 基础直接上开源 Web CAD 的维护成本可能比买许可证更高。6.2 什么情况下选择 Partmode 才是理性决策从实践角度Partmode 适合在以下条件同时成立时选用条件说明模型复杂度适中以中小型零件和简单装配为主需要 Web 协作团队分布在多地需要浏览器访问预算受限无法覆盖每台机器的商业授权费用有开发能力团队能处理自部署、二次开发和 bug 反馈下游格式可控只需要 STEP/DXF 等基础交换格式如果其中两条不满足风险会明显增加。尤其是大型装配体和复杂曲面场景Web 端的内存和计算资源很容易成为瓶颈。6.3 引入开源 CAD 前要做的五项检查把 Partmode 引入团队之前建议先做一次完整的可行性检查避免上线后才发现无法支撑业务拿 20 个实际生产模型做导入测试统计导入成功率、耗时和内存峰值。让 3 名工程师分别完成从草图到拉伸、切除、圆角的完整建模流程记录问题。确认 STEP 导出文件能被下游 SolidWorks、NX 或 Catia 正常打开。评估内网部署的硬件资源确认页面加载时间在可接受范围。检查团队的 WebAssembly 和三维图形能力确定遇到深度问题时能否自己解决。这五项检查的结果比任何宣传文字都更能说明问题。开源 CAD 的价值在于可定制但可定制的前提是团队有能力理解它依赖的底层技术栈。7. 最佳实践从 Demo 走向生产环境还需要补齐哪些工程能力7.1 数据安全与权限不能把浏览器当成万能保险箱浏览器只是运行环境不是数据安全边界。如果 Partmode 接入生产环境必须把模型文件看成和源代码同等级别的核心资产。至少要做到三件事模型文件按项目分目录管理导入导出操作记录审计日志对外提供文件下载时设置访问权限。如果部署在公网一定要在反向代理层加上 HTTPS、访问控制和上传大小限制防止未经授权的用户直接访问模型文件路径。浏览器端并不是天然安全的前端代码和模型文件都可能被下载要在数据层面做好分级管理。7.2 自部署时的目录结构和发布建议Partmode 在本地运行时的目录结构通常由构建工具生成生产部署时只需要关注静态产物和模型数据目录。一个比较稳妥的做法是把项目分成三个独立区域前端静态资源、模型数据目录、构建产物目录。部署时前端资源只做只读发布模型数据放在独立卷中避免代码升级时覆盖用户上传的模型文件。# 生产环境目录规划示例 /opt/partmode/ ├── app/ # 前端构建产物 ├── data/ # 模型文件存储目录 ├── logs/ # 访问日志和错误日志 └── backup/ # 模型数据库或文件备份发布前把版本号固定到具体 commit记录依赖包的 lock 文件。开源项目迭代速度可能很快没有版本锁定会导致今天能用的环境下周构建就失败。7.3 备份与导出模型文件是核心资产必须有独立备份Partmode 的模型要么以文件形式保存在本地要么通过浏览器存储保存在本地缓存。强烈建议养成模型导出后单独备份的习惯。浏览器本地存储可能出现数据丢失例如清理浏览器缓存、换设备、无痕模式关闭。任何重要模型都应该导出 STEP 文件并放到 Git 仓库或对象存储中。这里需要特别强调不要使用file://协议打开 Partmode 并希望自动保存所有数据到磁盘。浏览器对本地文件系统访问限制严格可靠的持久化方式必须是显式导出 后端存储。7.4 Partmode 最佳实践清单在实际项目中建议把这套清单贴在团队文档里类别最佳实践环境统一使用现代 Chromium 内核浏览器关闭兼容模式模型大模型先简化再导入避免一场崩溃单位建模前全局统一毫米导入导出都检查单位数据每个模型完成后导出 STEP 备份到 Git协作多人分工时拆分零件不直接编辑同一份装配体部署Wasm 文件单独配置 MIME 类型记录部署版本排错记录 Console 报错和模型复现步骤反馈给上游项目扩展优先选择基于 OCCT 的生态避免绑定私有内核7.5 下一步可以继续跟踪的方向Partmode 这类 Web CAD 项目还处于快速迭代期。如果你有兴趣深入可以沿着三条线继续学习。第一条线是几何内核。学习 OCCT 的 B-Rep 数据结构理解 Face、Edge、Vertex 与特征的映射关系。第二条线是前端渲染。理解如何从 B-Rep 数据生成网格以及 WebGL 如何承载高并发渲染。第三条线是格式转换。研究 STEP 文本结构弄清楚文件头段、数据段和实体定义之间的关系这对排查导入导出问题非常有帮助。这三条线不是割裂的。真正的浏览器 CAD 开发者需要同时理解 C 内核、WebAssembly 编译和前端交互。从这个角度看Partmode 的 Live Browser Demo 不只是一个试用入口更是一份很好的技术学习素材。你可以从一次简单的拉伸开始慢慢打开浏览器控制台观察几何内核加载过程尝试导入不同类型文件逐步建立一个完整的 Web CAD 心智模型。 Partmode解析：浏览器里的开源参数化CAD与SolidWorks替代方案
在机械设计与 3D 建模领域SolidWorks 几乎是许多工程师的第一选择但它属于商业授权软件采购成本高、License 管理复杂也摆脱不了对 Windows 环境的依赖。这几年出现了不少试图替代它的开源项目其中 Partmode 是一条值得关注的技术路线。Partmode 是一个基于浏览器的参数化 3D 建模开源项目面向机械设计场景把建模能力打包进 Web 环境并提供 Live Browser Demo方便用户体验和评估。本文围绕 Partmode 展开从参数化建模原理、浏览器端运行机制、STEP/DXF 数据交换到常见故障排查完整梳理一遍。整篇文章适合三类读者第一类是正在做开源 CAD 选型调研的开发者第二类是使用 SolidWorks 但在评估能否用浏览器方案做轻量建模的机械工程师第三类是计划在 Web 端集成 3D 建模能力的前端工程师。读完这篇内容你会理解 Partmode 的边界在哪里、浏览器实时建模是怎么实现的、导入导出数据时容易踩哪些坑以及从 Demo 进入自部署生产环境之前还需要补齐哪些工程能力。1. 先理解 Partmode 的定位浏览器里的参数化 CAD而不是一个简单三维查看器1.1 它解决什么问题传统 CAD 软件的核心能力不是画一个立方体而是维护一组可编辑、可约束、可联动的几何关系。SolidWorks 这类桌面软件通过特征树、草图约束、参数方程把模型组织成一条可追溯的设计历史链修改一个尺寸下游特征自动重建。Partmode 想做的事情就是把这条设计历史链搬到浏览器里。用户不需要安装客户端不需要处理 Windows 注册表不需要下载几个 GB 的安装包只需要打开浏览器就能创建草图、拉伸成体、修改参数并实时看到结果。这种能力对团队协作非常有价值模型文件可以放在 Web 服务器上所有人打开同一个 URL 就能查看和编辑版本管理可以直接对接 Git设计评审不用再传大附件。Partmode 的 Live Browser Demo 就是让用户在决定是否选型之前先花几分钟在真实模型上验证这条链路是否可行。1.2 它和 SolidWorks 的边界为什么不能简单画等号Partmode 出现在 SolidWorks open source alternative 的语义下但它和 SolidWorks 的关系不是完全代餐而是特定场景下的开源替代方案。两者都需要先讲清楚。SolidWorks 是完整的商业化桌面 CAD 套件覆盖从零件建模、装配体约束、工程图出图、运动仿真、有限元分析到 PDM 数据管理的一整条结构化流程。它依赖本地高性能 GPU 和多核 CPU支持大量工业级文件格式也拥有几十年积累的用户生态和插件库。Partmode 这类 Web CAD 的优势主要在轻量、跨平台、易协作但它的成熟度还受到几何内核性能、浏览器内存限制、复杂装配体能力不足的约束。替代更适合理解为在一个成本敏感、需要快速迭代、以中轻度建模为主的团队里用 Partmode 替换部分原本需要付费 CAD 才能完成的工作。1.3 这类开源自部署 CAD 适合谁用考虑到输入材料里大量出现solidworks下载、solidworks安装、solidworks卸载这类热词说明很多用户对传统桌面 CAD 的安装部署和维护已经厌倦了尤其是许可证不可用、系统更新后环境损坏这类问题几乎每天都在消耗时间。Partmode 的浏览器模式天然规避了这些维护负担。适合采用 Partmode 的场景至少包括教学场景学生使用浏览器即可完成基础草图与拉伸练习省去机房安装授权。轻量出图与方案验证快速创建结构外形、检查尺寸、导出 STEP 给上下游。云原生 CAD 产品原型开发者基于 Partmode 快速搭建定制化 Web 建模工具。内网隔离环境把前端静态产物和模型数据部署在内网浏览器访问即可使用。不适合的场景则是大型装配体、高复杂度曲面建模、标准化出图以及依赖 SolidWorks 专属宏和插件生态的既有生产线。选型之前先按模型复杂度做一次评估比直接替换要稳妥得多。2. 跑通 Partmode 的 Live Browser Demo从打开网页到完成第一个拉伸特征2.1 环境准备先确认浏览器、GPU 和网络三项条件Partmode 的核心能力在浏览器里运行所以不需要安装 C 盘依赖也不需要配置环境变量。但浏览器 CAD 不是一个普通网页它依赖 WebAssembly 执行几何内核依赖 WebGL/WebGL2 渲染三维场景还依赖较大的前端资源包。这三项条件不满足表现通常是白屏或加载卡死。在进入 Demo 页面之前先按下面的清单确认环境检查项要求检查方式浏览器版本建议 Chrome / Edge 最新版访问chrome://version查看版本WebGL2必须开启浏览器地址栏访问chrome://gpu查看 WebGL 状态JavaScript 内存建议 4GB 以上可用内存任务管理器确认空闲内存网络首次加载需要下载几何内核 Wasm 文件观察浏览器网络面板资源加载情况可以使用浏览器控制台执行下面这段 JavaScript快速判断 WebGL2 是否可用const canvas document.createElement(canvas); const gl canvas.getContext(webgl2); console.log(gl ? WebGL2 available : WebGL2 unavailable);如果执行结果是WebGL2 unavailable说明浏览器禁用了硬件加速或者当前机器没有可用的 GPU 驱动。进入浏览器设置打开硬件加速重启浏览器后再试。Partmode 在软件渲染下也能运行但大型模型会明显卡顿。2.2 进入 Demo 页面后先看模型树和参数面板打开 Partmode 官方 GitHub 仓库或项目首页找到 Live Browser Demo 入口。页面加载完成后通常能看到三个关键区域左侧是特征树或零件列表中间是三维视口右侧或底部是参数面板。第一次打开不要急着操作先确认这三个区域是否正常渲染。这里要解释清楚为什么先看特征树很重要。Partmode 的建模方式不是直接拖拽一个立方体到场景里而是通过创建草图 - 添加约束 - 拉伸或切除 - 再次编辑参数这条链路来生成模型。特征树记录的就是这条链路。如果特征树区域是空的说明还没有创建任何特征如果特征树有节点但视口不显示则大概率是渲染层问题。可以通过拖动鼠标观察视口交互是否流畅按住中键旋转、滚轮缩放、右键平移。如果模型旋转时有明显掉帧或画面撕裂先调整浏览器硬件加速设置再检查显卡驱动。2.3 用参数化草图生成第一个拉伸特征为了测试 Partmode 的实际建模能力建议从最基础的特征开始草图矩形、标注尺寸、拉伸成体。下面是完整操作思路实际按钮名称以当前 Demo 版本为准但流程具备代表性新建一个零件。选择基准面通常是 Top Plane 或 XY Plane。进入草图模式创建矩形草图。给矩形两条边添加尺寸约束例如长度 100、宽度 60。退出草图。选择拉伸命令设置拉伸高度 40。确认生成拉伸特征。在参数面板中拉伸高度会作为一个独立参数暴露出来。尝试把高度从 40 改成 80观察模型是否实时更新。如果模型能在数秒内完成重建说明浏览器的 WebAssembly 几何内核工作正常。到这里第一个拉伸特征已经完成。这个过程背后涉及两个关键机制草图约束如何驱动几何体重建以及特征在浏览器内存中如何被记录。接下来会展开说明。2.4 修改参数并观察实时预览验证参数化链路参数化建模的核心是参数改变 - 特征重建 - 模型更新这一条链路。在 Partmode 的 Demo 中这种实时的反馈能力远远比重新导入模型文件高效。实际操作时可以多试几个参数场景把宽度从 60 改成 90观察矩形是否按预期变宽。在草图中给矩形中心和原点添加重合约束再移动原点观察整个矩形是否跟随。在拉伸特征上方再叠加一个圆孔草图使用切除命令观察特征树中是否新增一个Cut节点。如果第二个特征依赖于第一个特征的表面Partmode 需要能识别模型的拓扑面。这个能力由几何内核提供不同开源项目实现程度不同。如果在复杂模型上出现面选择失败或特征重建报错那是几何内核覆盖度的问题不是操作错误需要记录复现步骤并提交到项目 issue。3. 参数化机制的底层几何内核、特征树与 WebAssembly 如何配合3.1 为什么参数化建模比布尔运算更适合设计迭代创建三维模型有很多种方式。最简单的思路是直接拉伸、旋转、差集像做布尔运算一样拼出一个造型。这种方式适合一次性建模但不适合修改如果客户要求把孔距从 40 毫米改成 50 毫米模型设计师需要重新选择所有相关面、重新做一次布尔运算效率很低。参数化建模把创建过程也变成模型的一部分。建模时记录这里创建了一个矩形草图长 100宽 60然后在该草图所在平面法向拉伸 40 毫米。当长宽参数变化时内核会按顺序回放这条建模历史自动重建拉伸结果。这就是 SolidWorks 特征树的本质也是 Partmode 想复刻的核心能力。在 Partmode 中特征树里的每个节点都是一次几何操作节点之间的父子关系构成了重建顺序。修改参数时系统会标记下游所有节点为需要重建然后逐个重新执行。这种机制同时带来两个结果一是模型具备很强的可编辑性二是复杂模型重建会非常消耗计算资源。浏览器里做实时重建对内核性能要求更高。3.2 OCCT 转 WebAssembly 后的能力边界Partmode 这类 Web 端参数化 CAD 项目几乎绕不开一个底层库OCCTOpen CASCADE Technology。OCCT 是开源几何内核提供 B-Rep 实体建模、参数化曲线曲面、布尔运算和 STEP 文件读写等能力是许多开源 CAD 项目的基础。在桌面端OCCT 以 C 库形式存在。要在浏览器里使用它需要把 C 代码编译成 WebAssembly也就是常说的 OpenCascade.js 这类方案。WebAssembly 的优势是执行效率接近原生但需要下载一个较大的.wasm文件首次加载会比较慢。这里有一个容易误解的点浏览器里的 OCCT 并不是简化版而是同一套 C 代码的交叉编译产物核心算法一致。但实际可用性会受内存限制、单线程性能和前端封装程度影响。复杂装配体或高精度曲面模型在浏览器里重建时可能变慢甚至失败。这不是 OCCT 算法的问题而是 WebAssembly 运行时资源和浏览器内存上限的问题。3.3 特征树结构草图和特征如何在浏览器里保持可编辑状态Partmode 的模型在浏览器里不是一张静态的三角网格而是一棵可解释的设计历史树。网格只是最终渲染结果真正的数据对象仍然包含草图曲线、约束、尺寸、特征类型和参数。这种设计决定了模型能否被继续编辑。一个典型零件的数据结构可以简化如下数据对象作用示例Sketch保存二维曲线、点和约束一个矩形草图Constraint约束曲线之间的几何关系水平、垂直、重合、等长Dimension保存数值参数长 100、宽 60Feature把草图和三维操作绑定Extrude、Cut、Fillet 等FeatureTree维护特征依赖顺序草图1 - 拉伸1 - 草图2 - 切除1修改参数时Partmode 会把用户修改的值写入 Dimension 对象然后通知 FeatureTree 从该节点开始重新执行后续特征。这也是为什么模型绘制过程要先有草图再建特征因为特征需要引用草图曲线作为几何输入。理解这个结构之后再去看 Live Demo 的特征树和参数面板就不会觉得它们只是装饰。它们直接映射到内核中的设计历史链是参数化建模的核心控制面。4. 数据交换STEP 和 DXF 在 Web 端的导入导出路径4.1 先搞清格式差异避免在格式选择上踩坑在 CAD 生态里数据交换是绕不开的话题。Partmode 这类 Web CAD 不能只在自己内部闭环必须能接收上游的 STEP 模型也必须能输出下游需要的格式。常见的两种格式用途完全不同格式主要场景特点STEP (.step/.stp)三维实体模型交换保留 B-Rep 实体和曲面保真度高DXF (.dxf)二维图纸与轮廓数据主要用于草图和平面轮廓STL (.stl)3D 打印和网格显示只保存三角面片丢失参数信息OBJ (.obj)渲染场景网格数据不支持特征树对于导入 SolidWorks 模型继续编辑这个需求STEP 是正确的选择因为 STEP 能保存曲面和实体拓扑。STL 只能用于查看外观不能用于参数化编辑。4.2 导入 STEP 文件的浏览器操作流程在 Partmode 中导入 STEP 文件一般有两种入口从文件菜单选择导入或者把.step文件直接拖拽到三维视口。浏览器会读取本地文件传给 OCCT 内核解析再生成渲染数据。需要注意浏览器端的 STEP 导入不是简单的二进制解析而是要完成以下几件事读取 STEP 头段和数据段。识别实体类型例如 ADVANCED_BREP_SHAPE_REPRESENTATION。在 OCCT 中重建 B-Rep 拓扑结构。把 B-Rep 模型离散成三角网格用于显示。执行完成后特征树里出现的通常是一个导入实体节点而不是原始建模步骤。这意味着导入的 STEP 模型可以作为整体查看和输出但无法像原生建模那样点击一个尺寸就去修改参数。这是当前 Web 参数化 CAD 的普遍边界OpenCascade.js 的解析能力也存在版本差异。4.3 导出格式的选择要看下游要什么Partmode 的输出能力决定了它能不能进入真实工作流。如果下游是 SolidWorks 用户应优先导出 STEP因为 SolidWorks 对 STEP 的支持成熟能保留完整实体模型。如果下游是激光切割或平面加工需要导出 DXF 轮廓。如果只是做 3D 打印STL 就够用。导出 STEP 时如果遇到模型导入 SolidWorks 后特征变成只读实体这是正常现象因为 STEP 本身不保存创建历史。这不是 Partmode 的 bug而是格式语义的限制。导出 DXF 时常见问题是圆弧和多段线的精度、单位选择以及图层命名。不同 CAD 软件对 DXF 的读取实现有差异建议导出后在下游软件里逐个检查关键尺寸而不是直接信任预览图。4.4 为什么导入导出最容易出现看起来没问题但下游报错这类问题在数据交换中非常典型。浏览器里模型显示正常但把文件发给同事后对方打开报错或尺寸对不上。常见原因有问题现象常见原因检查方式SolidWorks 打开 STEP 后是坏面导入时几何容差过大调整导入容差后重新导出DXF 尺寸比例不对单位设置不一致例如 mm 和 inch统一检查单位和比例模型破面、有缝隙原始 STEP 文件本身有缺陷用其他查看器交叉验证导入后特征树为空STEP 是 B-Rep 实体不含创建历史查看 Face/Edge 拓扑而非特征树建议在导出前先做一次交叉验证用另一个开源查看器打开导出的 STEP确认实体完整再发给下游。这可以隔离是 Partmode 导出问题还是下游 CAD 导入问题。5. 浏览器 CAD 的常见故障与排查路径5.1 现象页面白屏或模型区不渲染Partmode 打开后白屏是最常见的故障原因通常不在建模逻辑而在浏览器渲染链路。按顺序排查打开浏览器开发者工具F12切到 Console 面板看是否有 JavaScript 报错。在 Network 面板查看.wasm文件是否加载成功如果显示失败说明几何内核文件没有正确加载。执行 WebGL2 检测脚本确认渲染上下文可用。查看浏览器的硬件加速状态关闭硬件加速会导致 WebGL 不可用。尝试无痕窗口排除浏览器缓存或扩展脚本干扰。// 在控制台运行检查 WebGL 上下文是否可用 const canvas document.createElement(canvas); const gl canvas.getContext(webgl2); console.log(gl ? WebGL2 OK : WebGL2 unavailable);如果控制台出现类似Error fetching wasm的提示说明项目的.wasm文件没有正确部署或没有通过 HTTP 服务器访问。注意直接双击 HTML 文件使用file://协议打开时WebAssembly 加载通常会因为跨域限制失败必须通过本地服务器访问。5.2 现象大文件导入后浏览器崩溃或无响应浏览器端建模受内存限制影响很大。STEP 文件内部是精确的几何实体单个实体可能包含大量曲面和边界边。导入时 OCCT 会建立拓扑结构同时生成三角网格这会在很短时间内消耗数百 MB 甚至 1GB 以上内存。如果导入大文件时页面卡死优先检查任务管理器中浏览器进程的内存占用。解决方案是按层级推进先导入只含几十个实体的测试模型确认流程正常再逐步提升复杂度。超大模型不建议直接拖入浏览器可以先在桌面端简化模型或把装配体按零件拆分后逐个导入。5.3 现象模型显示错乱或尺寸不对显示错乱的根源通常是两种三角网格离散精度不足或单位换算错误。Partmode 内部生成的网格是为了显示用的不是精确几何。如果模型出现锯齿、破面、倒角显示不圆滑需要调整网格离散精度参数。在 OCCT 中常用linear deflection和angular deflection控制网格精度降低线性偏差值会让曲面更光滑但也会增加渲染开销。尺寸不对则优先怀疑单位。STEP 文件本身可以携带单位信息但不同软件导出时的处理方式不一致。如果模型在 Partmode 中打开后长度是预期的 25.4 倍基本可以判定是英寸和毫米的换算问题。这时候需要检查导入设置里是否有单位选项或先在源软件中把模型切到毫米单位再导出。5.4 现象本地部署后 Wasm 加载失败Live Demo 在官网能正常打开但自己部署到内网后加载失败通常不是代码问题而是静态服务器的配置问题。.wasm文件需要正确的内容类型MIME 类型才能被浏览器执行。如果服务器返回的 Content-Type 是application/octet-stream部分浏览器会拒绝执行。常见的静态服务器配置如下location /wasm/ { add_header Content-Type application/wasm; }同时要注意OCCT 的 Wasm 文件体积较大如果服务器开启了压缩需要确认 gzip 或 brotli 压缩不会导致二进制文件损坏。部署完成后直接访问.wasm文件的 URL确认浏览器能以application/wasm类型加载。5.5 排查顺序速查表遇到浏览器 CAD 故障时不要一开始就怀疑模型数据先按这个顺序排查排查层级检查内容工具1. 输入文件格式、单位、导出软件文件管理器、阅读器2. 环境浏览器版本、WebGL2、内存chrome://gpu、控制台3. 加载Wasm 是否成功下载Network 面板4. 渲染WebGL 是否报错、GPU 是否可用Console 面板5. 数据处理导入容差、单位、网格精度导入设置6. 逻辑特征重建是否失败特征树、日志输出这套顺序同样适用于其他 Web 端 CAD 工具不只是 Partmode。6. 开源替代方案选型Partmode 与桌面 CAD 的场景差异6.1 两者的本质差异不在功能数量而在数据所有权Partmode 和 SolidWorks 的关键差异不只是免费与付费而是数据所有权和工作流方式。SolidWorks 把数据保存在本地文件或 PDM 系统里依赖 Windows 客户端Partmode 把模型数据保存在浏览器内存和文件系统中天然适合 Web 部署和协作。同时要意识到开源不等于免费维护。Partmode 的代码可以自部署但部署、升级、二次开发、培训都需要投入工程资源。如果团队没有前端和 WebAssembly 基础直接上开源 Web CAD 的维护成本可能比买许可证更高。6.2 什么情况下选择 Partmode 才是理性决策从实践角度Partmode 适合在以下条件同时成立时选用条件说明模型复杂度适中以中小型零件和简单装配为主需要 Web 协作团队分布在多地需要浏览器访问预算受限无法覆盖每台机器的商业授权费用有开发能力团队能处理自部署、二次开发和 bug 反馈下游格式可控只需要 STEP/DXF 等基础交换格式如果其中两条不满足风险会明显增加。尤其是大型装配体和复杂曲面场景Web 端的内存和计算资源很容易成为瓶颈。6.3 引入开源 CAD 前要做的五项检查把 Partmode 引入团队之前建议先做一次完整的可行性检查避免上线后才发现无法支撑业务拿 20 个实际生产模型做导入测试统计导入成功率、耗时和内存峰值。让 3 名工程师分别完成从草图到拉伸、切除、圆角的完整建模流程记录问题。确认 STEP 导出文件能被下游 SolidWorks、NX 或 Catia 正常打开。评估内网部署的硬件资源确认页面加载时间在可接受范围。检查团队的 WebAssembly 和三维图形能力确定遇到深度问题时能否自己解决。这五项检查的结果比任何宣传文字都更能说明问题。开源 CAD 的价值在于可定制但可定制的前提是团队有能力理解它依赖的底层技术栈。7. 最佳实践从 Demo 走向生产环境还需要补齐哪些工程能力7.1 数据安全与权限不能把浏览器当成万能保险箱浏览器只是运行环境不是数据安全边界。如果 Partmode 接入生产环境必须把模型文件看成和源代码同等级别的核心资产。至少要做到三件事模型文件按项目分目录管理导入导出操作记录审计日志对外提供文件下载时设置访问权限。如果部署在公网一定要在反向代理层加上 HTTPS、访问控制和上传大小限制防止未经授权的用户直接访问模型文件路径。浏览器端并不是天然安全的前端代码和模型文件都可能被下载要在数据层面做好分级管理。7.2 自部署时的目录结构和发布建议Partmode 在本地运行时的目录结构通常由构建工具生成生产部署时只需要关注静态产物和模型数据目录。一个比较稳妥的做法是把项目分成三个独立区域前端静态资源、模型数据目录、构建产物目录。部署时前端资源只做只读发布模型数据放在独立卷中避免代码升级时覆盖用户上传的模型文件。# 生产环境目录规划示例 /opt/partmode/ ├── app/ # 前端构建产物 ├── data/ # 模型文件存储目录 ├── logs/ # 访问日志和错误日志 └── backup/ # 模型数据库或文件备份发布前把版本号固定到具体 commit记录依赖包的 lock 文件。开源项目迭代速度可能很快没有版本锁定会导致今天能用的环境下周构建就失败。7.3 备份与导出模型文件是核心资产必须有独立备份Partmode 的模型要么以文件形式保存在本地要么通过浏览器存储保存在本地缓存。强烈建议养成模型导出后单独备份的习惯。浏览器本地存储可能出现数据丢失例如清理浏览器缓存、换设备、无痕模式关闭。任何重要模型都应该导出 STEP 文件并放到 Git 仓库或对象存储中。这里需要特别强调不要使用file://协议打开 Partmode 并希望自动保存所有数据到磁盘。浏览器对本地文件系统访问限制严格可靠的持久化方式必须是显式导出 后端存储。7.4 Partmode 最佳实践清单在实际项目中建议把这套清单贴在团队文档里类别最佳实践环境统一使用现代 Chromium 内核浏览器关闭兼容模式模型大模型先简化再导入避免一场崩溃单位建模前全局统一毫米导入导出都检查单位数据每个模型完成后导出 STEP 备份到 Git协作多人分工时拆分零件不直接编辑同一份装配体部署Wasm 文件单独配置 MIME 类型记录部署版本排错记录 Console 报错和模型复现步骤反馈给上游项目扩展优先选择基于 OCCT 的生态避免绑定私有内核7.5 下一步可以继续跟踪的方向Partmode 这类 Web CAD 项目还处于快速迭代期。如果你有兴趣深入可以沿着三条线继续学习。第一条线是几何内核。学习 OCCT 的 B-Rep 数据结构理解 Face、Edge、Vertex 与特征的映射关系。第二条线是前端渲染。理解如何从 B-Rep 数据生成网格以及 WebGL 如何承载高并发渲染。第三条线是格式转换。研究 STEP 文本结构弄清楚文件头段、数据段和实体定义之间的关系这对排查导入导出问题非常有帮助。这三条线不是割裂的。真正的浏览器 CAD 开发者需要同时理解 C 内核、WebAssembly 编译和前端交互。从这个角度看Partmode 的 Live Browser Demo 不只是一个试用入口更是一份很好的技术学习素材。你可以从一次简单的拉伸开始慢慢打开浏览器控制台观察几何内核加载过程尝试导入不同类型文件逐步建立一个完整的 Web CAD 心智模型。