SuperSplat 上手指南：10 分钟在浏览器里打开、编辑并导出 3D 高斯泼溅

SuperSplat 上手指南：10 分钟在浏览器里打开、编辑并导出 3D 高斯泼溅

【免费下载链接】super-splat3D Gaussian Splat Editor项目地址: https://gitcode.com/gh_mirrors/su/super-splat

SuperSplat 是一款免费开源的 3D Gaussian Splat 编辑器，基于 Web 技术构建，直接在浏览器中运行——不用安装任何软件，打开页面就能查看、裁剪、合并、压缩并导出.ply高斯泼溅文件。如果你刚接触 3D Gaussian Splatting（3D 高斯泼溅）这种由大量「高斯点」构成场景的新技术，SuperSplat 是目前最省事的切入点：选区、移动、旋转、缩放、直方图分析、时间轴动画，全都做进了一个网页里。

下面按「先跑起来 → 再做修改 → 后出结果」的顺序讲，每一步都能直接照做。

🔍 SuperSplat 能做什么：一张功能清单

先建立整体印象。SuperSplat 的核心能力可以归成五类：

下面这张截图来自项目仓库，左侧是控制面板，右侧是正在渲染的水果静物场景：

🚀 3 步上手：打开、载入、保存

SuperSplat 是网页应用，「安装」这一步被压缩成了「打开浏览器」。

第 1 步：打开应用。在浏览器中访问 SuperSplat 编辑器页面即可。如果打算长期使用，可以把它安装为 PWA（渐进式 Web 应用）：系统会生成桌面/主屏幕图标，并把.ply文件关联到 SuperSplat，双击文件直接打开。

第 2 步：载入.ply文件。有三种方式，任选其一：

1. 把.ply文件拖进窗口；
2. 菜单Scene > Open，从文件选择器中挑选（支持多选）；
3. 用 URL 参数?load=<PLY_URL>直接加载远程文件，例如https://superspl.at/editor?load=你的ply地址——适合把链接发给别人，对方点开就能看到你编辑的场景。

注意：SuperSplat 只识别包含高斯泼溅数据的.ply文件。普通 PLY 网格或点云数据会加载失败，这是最常见的「打不开」原因。

第 3 步：保存。编辑完成后，Scene > Save或Save As保存.ply；如果要压缩体积，走Scene > Export（后文详述）。

🎮 相机与视图操作速查表

进入 3D 视图后，最常用的是相机操作，建议先看这张表：

视图还有两个细节值得知道：

• 渲染模式：Centers模式在每个高斯中心画蓝点，Rings模式画外边界圆环；按Space可临时关掉这些标记，看真实渲染效果。
• 网格与工具坐标空间：按G切换地面网格，Shift + C在工具的世界/局部坐标间切换。

✂️ 选择与修改：最常用的工作流

裁剪掉扫描中的杂物（比如临时站在画面里的人），是 SuperSplat 最高频的用法。流程是「选工具 → 选点 → 删除」。

几个实用技巧：

• 笔刷大小用[和]调整；
• 球体选择工具可以双击某个 splat 来重新定位球体中心，用体积加减选点；
• 选完之后按Delete删除，Ctrl + Z/Ctrl + Shift + Z撤销重做；
• Ctrl + A全选、Ctrl + I反选、Ctrl + Shift + A取消选择。

这张来自项目仓库的截图展示了在 Centers 模式下对场景做选区的状态，左侧可以看到选择、修改、场景变换等面板：

📦 导出格式对照：4 种输出怎么选

保存时选哪个格式？对照这张表：

另外，合并多个 splat也很直接：把任意数量的.ply一次性载入场景管理器，对每个分别做变换和编辑，再Scene > Save出一个合并文件即可。

📊 进阶两件套：数据面板与时间轴动画

数据面板（Data Panel）是分析场景的利器：

• 按Ctrl + D或点击面板标题展开底部直方图面板；
• 直方图会绘制场景各类属性（如位置、尺度、不透明度等）的分布；
• 可以直接在直方图拖拽来选点，Shift加选、Ctrl减选——比如把「不透明度低于阈值」的点全部挑出来删掉，比在 3D 视图里一个个框选快得多。

时间轴动画（Timeline）让 SuperSplat 不只是静态编辑器：

• 一次载入多个带编号的.ply帧文件（如frame001.ply、frame002.ply），会自动识别为序列并按帧号排序；
• Ctrl + T展开时间轴面板，Space播放/暂停，,和.逐帧前进后退；
• 对变换参数打关键帧（Enter加帧、Shift + Enter删帧），就能做 splat 的位移动画。

相关实现可以参考 src/timeline.ts 和 src/ply-sequence.ts。

💻 本地开发与贡献：3 条命令跑起来

想改源码或参与贡献，本地开发环境三步搭好：

1. 克隆仓库：

   git clone https://gitcode.com/gh_mirrors/su/super-splat cd super-splat

2. 安装依赖（需要 Node.js 20.19 及以上，README 中要求 18 及以上）：

   npm install

3. 构建并启动本地服务，源码有改动会自动重新构建：

   npm run develop

   然后浏览器打开http://localhost:3000。本地调试时记得关掉 Service Worker 缓存，否则看到的可能是旧版本。

添加新语言是个低门槛的参与方式：在 static/locales/ 目录新增一个<locale>.json（已有en、zh-CN、ja、ko等 8 种语言），再到 src/ui/localization.ts 注册，最后用http://localhost:3000/?lng=<语言码>验证。

项目主体代码在 src/ 下，按模块清晰划分：tools/是各类选择与变换工具，shaders/是渲染着色器，io/负责文件读写，ui/是界面层。

🧯 常见问题快查

📚 延伸阅读与资源

• 官方用户指南：docs/index.md（含相机操作、选择工具、数据面板的完整说明）
• 界面快捷键定义：src/shortcut-manager.ts
• 语言包目录：static/locales/
• 导出与发布逻辑：src/ui/export-popup.ts、src/publish.ts

SuperSplat 的价值在于把高斯泼溅后处理从「命令行拼脚本」变成了「浏览器里点点点」。按本文流程走一遍——载入、选区裁剪、合并、压缩导出——你大概只需要 10 分钟，就能产出第一个可分享的 splat 场景。

【免费下载链接】super-splat3D Gaussian Splat Editor项目地址: https://gitcode.com/gh_mirrors/su/super-splat