简介这是一份名为 supersplat 的 Node.js 项目压缩包项目环境与依赖已预先配置好可通过 npm run develop 直接启动面向前端开发者、Node.js 初学者以及需要搭建项目脚手架的技术人员既可用于工程参考也可作为二次开发的基准。压缩包共包含 2000 个文件约 52.83MB其中 1116 个 JavaScript 文件构成核心逻辑与模块脚本711 个 Markdown 文件多为项目说明或开发笔记166 个 JSON 文件管理依赖与各类配置另有少量 TXT 文本从文件预览可见项目集成了 js-yaml、typebox、argparse 等工具涉及 YAML 解析、类型校验和命令行参数处理具备相当的实用功能。整体目录结构完整运行环境已配好适合快速启动开发阅读其源码与文档可以掌握 Node.js 项目的模块划分方式、常用第三方库的调用方法以及从零配置开发环境的一般思路。目前已有 134 人学习下载参考价值明确。 直接说结论supersplat.zip这个名字看着像某个压缩包其实是 3D 高斯泼溅3DGS圈子里最近热度很高的一个开源在线编辑器Supersplat。它由 PlayCanvas 团队维护主打的是“不装软件、打开网页就能编辑 3DGS 模型”而且默认把编辑好的场景打包成 zip 场景包。很多第一次接触的人包括我自己都是先被“这个 zip 到底怎么用”卡住的。如果你手里有 PLY 格式的高斯模型想切割、裁剪、抠掉不需要的部分或者想转成可发布的场景格式这篇就是给你写的。我实际用下来的感受是Supersplat 的定位很像“3DGS 界的格式工厂轻量编辑器”。它不追求替代 Blender 那种重型 DCC 工具而是解决 3DGS 工作流里最痛的几个问题——怎么看、怎么剪、怎么导、怎么转。本文会从工具拆解讲到实操重点把“如何将 PLY 切割成两部分”这个高频需求完整过一遍最后附上我踩过的坑。1. 项目整体拆解Supersplat 到底解决什么问题1.1 3DGS 与 Supersplat 的关系先花一分钟说清楚 3DGS 是什么因为这是理解 Supersplat 一切功能的前提。3D 高斯泼溅3D Gaussian Splatting是一种新兴的三维场景表示方法它用成千上万个带有位置、旋转、缩放、颜色和不透明度的高斯椭球来拟合真实场景。和传统网格mesh不同它没有三角形面只有一堆“点”但这些点带体积感渲染出来极其细腻尤其适合实景扫描、NeRF 替代方案。但问题也来了这种数据格式以 PLY 文件为主动辄几百 MB普通查看器要么不兼容要么卡成幻灯片。更麻烦的是扫描出来的场景经常包含大量不需要的区域——比如误扫进去的摄影三脚架、走动的人影、背景杂物。你要把这些部分去掉传统做法是在桌面端软件里处理但很多工具对 3DGS 支持并不完善。Supersplat 就是为了解决这些痛点出现的。它直接在浏览器里读取 PLY渲染效率很高支持选点、删除、分割、平移、复制等基础编辑操作还能导出成多种格式比如.splat、.ply、.ksz以及标准的 zip 场景包。换句话说它就是 3DGS 的“瑞士军刀”轻量、快速、零安装成本。1.2 为什么会有“zip”这个后缀Supersplat 默认的保存格式是 zip这一点让不少新手困惑。其实它的设计逻辑很清晰一个 3DGS 场景除了点云本身还应该包含相机参数、元数据、缩略图以及可选的标注信息。把这么多文件打包成一个 zip既方便传输也方便在 Web 端按需加载。我自己在项目里经常这样用用手机或无人机采集一段视频跑完 3D 重建拿到一个 PLY 文件然后拖进 Supersplat 做清理和分割最后导出成 zip 上传到自己的 Web 查看器。这个流程里zip 实际上充当了“场景容器”的角色。所以你在搜索框里搜“supersplat 3dgs”也好搜“zip 解压”也好本质上都在围绕同一个工具链转圈。2. 核心实操如何把 PLY 切割成两部分2.1 切割前要搞明白的 3 个概念在点选删除之前有几个概念必须先在脑子里过一遍否则很容易把模型弄得面目全非第一高斯点不是顶点。每个高斯点都是一个独立的椭球实体你在 Supersplat 里选中它、删除它影响的只是局部区域的“显示密度”不会像 mesh 那样产生破洞。这既是优点也是缺点——好处是切割后边缘不会有镂空感坏处是你可能在视觉上“以为删干净了”旋转视角才发现还有残留。第二切割的本质是“选中删除”或“选中分离”。Supersplat 并没有直接提供一个“一刀切两半”的按钮你需要通过Select工具圈选范围然后决定是删除选中区域还是把选中区域另存为独立对象。这个思维转换很重要它和 Blender 的P键分离不同Supersplat 的操作更接近“按区域选择”加“对象管理”。第三被切割出的部分保存的是视角信息。如果你只导出一个切割后的 PLY那么场景的坐标原点不会变但如果你导出 zip它会连相机位姿一起打包这在做 Web 展示时非常关键。2.2 具体操作流程亲测可用以我自己最常用的踩坑路径为例前提是你已经有一个 PLY 文件比如用 COLMAP 或 Nerfstudio 导出的重建结果。第一步打开 Supersplat 官方编辑器 直接把.ply文件拖进浏览器窗口。页面会自动进入预览模式渲染通常需要几秒到几十秒取决于点数。如果你的文件超过 1000 万点建议先用官方命令行工具做一次抽稀否则浏览器会明显掉帧。第二步点击左侧工具栏中的Select工具然后用鼠标画一个矩形框或套索框住你想保留或删除的部分。Supersplat 支持三种选择模式矩形、套索、以及基于射线批选择。我实际测试下来套索最适合切割建筑物轮廓矩形适合规整的平面区域。按住Shift可以加选按住Alt可以减选这个和 Blender 的习惯一致。第三步如果你想“切掉一块”直接按Delete键删除选中区域。注意这里删除是不可逆的所以操作前最好先右上角Save存一份原始文件。如果你想把某一部分独立出来路径完全不同选中目标区域后点击左侧Object面板的“复制所选”或者用快捷键Ctrl D复制一份然后把原来的部分框选删除。这样你就得到了“背景剩余”和“独立对象”两个部分分别导出即可。第四步导出。在Export面板里你可以选择导出全部场景还是仅当前选中对象。格式上我一般用PLY或Zip。如果你的后续流程是在其他软件里渲染优先导出.ply如果是给 Web 项目用导出 Zip 是最稳妥的。2.3 切割时容易踩的 3 个坑第一个坑是边缘残留。因为高斯点有小大之分你选中的边界附近可能有一些“半透明”的点没有被框选住但渲染时它们会露出一截。解决方案很简单选择半径稍微向外扩一圈然后删除后立即旋转视角检查多删几次。第二个坑是选错对象。Supersplat 里默认场景是一个整体对象你导入第二个 PLY 后它会变成一个新的对象。很多人在切割时以为自己在编辑对象 A实际编辑器当前激活的是对象 B导致一顿操作后发现改错地方。我习惯在Object面板里双击对象重命名并留意当前高亮的是哪个。第三个坑是坐标轴偏移。如果你发现切割出来的两部分在导入其他软件时“对不上”多半是因为导出时勾选了“仅选中对象”导致新文件以选中对象自己的中心为原点。解决办法是导回 Supersplat 时用Align工具做一次粗略对齐或者在导出界面取消勾选“Center to origin”。3. 进阶玩法与工具链衔接3.1 用 Supersplat 做场景清理和标注切割只是第一步实际项目中更常用的其实是场景清理。比如你扫描了一个室内空间地面、天花板、墙面都没问题但桌子底下有一团乱七八糟的重建残渣这时候你用套索工具一顿框选删除很快就能让场景干净很多。我个人非常推荐配合Orthographic视角来做这件事。把视角切换到正交模式从顶视图看残渣和主体会分得很清楚矩形选择几乎可以做到“所见即所得”。比自由视角瞎框一圈效率高太多。另外一个技巧是Supersplat 支持键盘快捷键F聚焦选中对象当你选择了一堆点后按F会缩放视角到选区范围方便你快速核对选中的区域是否符合预期。3.2 从 PLY 到 ZIP 的格式转换思路很多人搜“zip”相关关键词其实只是想找个办法把超大 PLY 压缩一下方便传输。这里我要提醒一句SUP 的 zip 不是普通压缩包你不能解压后直接拿到一个改好的 PLY 直接给别的软件用。它是给 Supersplat 自己用的“工程文件”里面包含了你还没完全处理的编辑状态、标注、相机参数等信息。正确的跨软件工作流是这样在 Supersplat 里完成切割、清理后先导出成.ply主文件再导出 zip 存档。后续如果要在 Unity 或 Unreal 里用记得用官方提供的spatial-hawk插件或superview库去加载不要试图直接解析 zip。如果你只是要一个“更小的高斯文件”可以在导出时勾选“压缩”选项或者先用抽稀工具降点再导出。4. 常见问题与排查技巧4.1 导入失败invalid zip archive: could not find EOCD这是搜索热词里出现频次很高的一条报错我一开始也被它卡了很久。这个报错的意思是你拖进 Supersplat 的不是一个有效的 zip 文件或者文件被截断了。常见原因有三个你下载的文件是 HTML 页面的伪装文件实际上是个网页源码扩展名硬改成了.zip。下载中断导致文件尾部缺失zip 中央目录EOCD在文件末尾一旦丢尾巴就找不到。部分网盘工具会把 zip 二次转存成.rar或.7z你在本地改扩展名没用必须真正解压再重新打包。排查方法很简单先用 Bandizip 或 7-Zip 打开这个 zip如果打不开或提示“意外结尾”果断重新下载源文件。如果你是在某个 Git release 页面下载的包检查一下是否用了浏览器插件拦截了部分内容。4.2 浏览器打不开或渲染卡顿怎么办Supersplat 是基于 WebGPU/WebGL 的对显卡要求较高。如果你用的 Chrome 版本较老或者显卡驱动没更新打开编辑页只会看到黑屏或白屏。我的建议是优先用最新版 Chrome 或 Edge并在地址栏输入chrome://gpu查看 WebGL 是否自动禁用。如果显示“WebGL 硬件加速不可用”尝试在系统设置里开启硬件加速后重启浏览器。渲染卡顿则多半是点数太多。我这里提供一个保底思路先用官方命令行工具supersplat的--input参数做一次降采样或者直接在编辑器的Scene面板里调整Point Budget把可见点数限制在 500 万左右性能会明显回升。4.3 切割后导出 PLY 再导入其他软件颜色发灰怎么办这是一个非常隐蔽的坑。Supersplat 导出 PLY 时会根据原始格式重新映射颜色空间如果你导入的是SH球谐数据而导出的目标是RGB软件会自行展开或丢弃参数导致颜色偏灰、发暗。解决方案是导出时在对话框里选择 “Compressed” 或者 “Full”不要勾选 “Minimal”。同时在Viewport菜单里把颜色空间从sRGB切换到Linear观察变化找到视觉上最接近原色的组合。如果你只是临时展示可以忽略但如果你把这些数据喂给训练代码做 fine-tune颜色错误是致命的。5. 实际使用感受与后续扩展思路Supersplat 目前还处于快速迭代期但它已经是 3DGS 工作流里少有的“开箱即用”工具。我不建议把它当成最终渲染器更推荐把它当作一个场景预处理与中转站PLY 导入、切割清理、标注关键点、转出 zip 或 PLY然后交给专门的渲染管线去继续处理。它在 Web 端协同预览上的优势是桌面软件暂时无法比的尤其是你和其他人远程协作时发一个链接就能让对方看到切割后的效果这点非常实用。我在实际项目中还发现Supersplat 的“标注”功能很适合做数据预处理。比如给一个城市扫描场景打上建筑物、道路、植被标签然后导出带有 semantic 信息的格式配合自训练的分割模型使用能大幅提升标注效率。虽然现在标注工具还很初级但已经具备成为整个数据管线一部分的潜质。最后再分享一个小技巧如果你想把切割出来的两部分分别用不同颜色区分不需要额外软件。在 Supersplat 里对独立对象重新指定颜色属性然后冻结成静态 PLY导出后导入其他查看器时颜色差异会保留下来。很多视觉调试场景下这一招比单独画框直观得多。如果你手里正好有一堆 PLY 不知道怎么清理不妨打开 Supersplat 编辑器 拖一个文件进去试试。整个过程不会超过五分钟但你会立刻明白为什么这个工具能在 3DGS 社区里火起来。本文还有配套的精品资源点击获取