offline-step-viewer

通用 STEP 离线 3D 查看器 · 单文件 HTML · 双击即用 · 无需安装任何 CAD 软件

想看一个 STEP 模型，但电脑上没装 SolidWorks / AutoCAD / FreeCAD？下载本仓库里的一个 HTML 文件就够了。

使用方法（3 步）

1. 下载 offline-step-viewer.html（约 12MB）

   • 点击文件名 → 右上角 Download 按钮保存；或 git clone 本仓库

2. 双击文件，用任意现代浏览器打开（Chrome / Edge / Firefox）

3. 拖入 .step / .stp 文件（或点击"打开文件"按钮），即可旋转、缩放、平移浏览 3D 模型

就这么简单——零安装、零配置、零联网。

Related MCP server: gitcad

特性

• 📂 单文件交付：几何内核（OCCT-WASM）+ 渲染引擎（Three.js）全部内嵌在这一个 HTML 里

• 🔒 完全离线：模型数据不出本机，适合涉密或内部图纸的快速检查

• 🖱️ 标准查看操作：鼠标左键旋转、滚轮缩放、右键平移

• 🌐 无浏览器插件：纯 WebGL 渲染，不需要装任何扩展

适用场景

• 客户/供应商发来 STEP 图纸，先快速过目再决定要不要导入 CAD 深入处理

• 检查从 GrabCAD / Printables / MakerWorld 等渠道下载的 3D 打印模型

• 临时电脑、车间电脑等没有 CAD 授权的机器上看图

• 机械臂二开选型：核对外形尺寸、安装孔位、接口形式

常见问题

Q: 为什么文件有 12MB？ A: OpenCASCADE 几何内核的 WebAssembly 版本以 base64 形式内嵌在文件里——这正是它能"零安装解析 STEP"的原因。

Q: 会把我的模型上传到服务器吗？ A: 不会。解析和渲染全部在浏览器本地完成，断网也能用。

Q: 能编辑/修改模型吗？ A: 不能，这是一个纯查看器。如需修改请使用 CAD 软件（FreeCAD 开源免费）。

技术原理（给感兴趣的工程师）

.step 文件 ──► occt-import-js (OCCT-WASM) ──► 网格化 (mesh) ──► Three.js WebGL 渲染
                浏览器内本地解析                  内存中转换           GPU 实时渲染

• 几何内核：OpenCASCADE 的 WASM 编译版（occt-import-js），在浏览器里解析 STEP 实体数据

• 渲染：Three.js，把解析出的网格交给 WebGL 实时绘制

License

MIT