转完没变小，甚至变大了
先看源格式。SPZ 的“约 1/10”是相对 PLY 说的；如果源文件已经是 SPLAT、SOG 或 KSPLAT，再转 SPZ 可能接近甚至变大。
再看目标格式。SPLAT 固定 32 字节/点，10 万点是 3.2 MB；如果当前文件只有 2.5 MB，转 SPLAT 必然变大。体积优先时，先算目标格式的每点成本，再决定。
- PLY → SPZ：通常明显变小
- SPZ → SPLAT：可能变大
- SOG → SPZ：通常变大
- KSPLAT → SPZ：取决于分块与压缩设置
打不开 / 认不出格式
本工具按文件头判断格式，不信扩展名。改过后缀的 .ply.txt、.splat 会被按内容纠正；如果头部不匹配六种容器，就会提示认不出。
常见原因：文件下载不完整、把普通点云 PLY 当 3DGS、把 zip 或图片改成了 .splat。先确认源文件能被打包它的工具打开，再试。
打开是黑的 / 只有一个小点
先看信息条上的「后端」：显示 WebGL 兼容说明在用兜底路径，大模型可能慢，但不该全黑。可以试 `?backend=webgl` 强制兼容后端，排除 WebGPU 驱动差异。
再看点数、包围盒、SH 是否正常。如果这些都有值但画面仍黑，换 Chrome/Edge 最新版，或把 console 报错和 `window.__splatApp.debug()` 的输出发给我们。
手机上崩溃 / 内存不够
移动端上限 100 MB，桌面端 300 MB。超过上限时浏览器很容易被系统杀掉，尤其是 iOS Safari。
处理顺序：先转 SPZ 降低体积；再关掉其它标签页；仍然失败就换桌面浏览器。不要用手机处理几百万点的原始 PLY。
颜色发白 / 细节糊
如果是 SPLAT 或 SOG，先怀疑量化：颜色 8 位、尺度与旋转量化、没有球谐，都会让高光和薄结构变平。换回 SPZ 或 PLY 对比，差异通常立刻可见。
如果所有格式都发白，检查源文件本身的颜色空间与曝光；格式转换不会修正训练时的色彩问题。
SPZ v4 读不了
v4 用 NGSP magic + zstd，需要较新的加载器。three.js r187 的 SPZLoader 支持 v4，但老版本 SuperSplat、旧插件或自建 loader 可能只认 v3。
把输出改成 v3 再发；本工具在转换面板里可以选版本。给别人文件时默认 v3 最稳。
用官方小样本复现
我们准备了一组 1,432 点的六格式小样本，体积都在几十到几百 KB，适合确认“是文件问题还是工具问题”。
打开 `/qa/` 下载 tiny.ply / tiny.splat / tiny.v3.spz 等，逐个拖进来；如果小样本正常、你的文件不正常，问题更可能在文件本身。
- QA 小样本（7 个文件）PLY / Compressed PLY / SPLAT / KSPLAT / SPZ v3 / SPZ v4 / SOG，均为 1,432 点
- 六种格式对照先确认你手上是哪种容器，再排查
常见问题
为什么文件拖进来没有反应？
先看文件大小是否超过上限（桌面 300 MB / 移动 100 MB），再看是不是六种容器之一。扩展名对但内容不对时，工具会按文件头提示认不出。
黑屏是文件坏了还是浏览器问题？
用 /qa/ 的 tiny 样本试一次：小样本也黑，偏浏览器/GPU；小样本正常，偏你的文件或体积。再看信息条上的后端是 WebGPU 还是 WebGL 兼容。
转完的文件怎么确认没坏？
把输出文件再拖回本页，能出画面且点数与源文件一致；需要更严格时做一次回环（如 spz → ply），比较点数与包围盒。