ooolabdev/ooosplat

项目介绍

OOOSplat 是一款 Tauri 桌面应用，把普通视频、图片序列或已拼接的 360° 全景素材跑完整条 Gaussian Splatting 流程。用户只需选择素材、项目目录和质量档位，应用就会完成抽帧、COLMAP 相机重建、Brush 训练并发布 final.ply，无需手动拼接命令。Windows 与 Apple Silicon macOS 安装包内置 FFmpeg、FFprobe、COLMAP 和 Brush；Ubuntu 24.04 x86_64 以 Alpha 版 .deb 提供。

生成流程默认在本机完成，素材、工作文件、模型和日志只写入用户选择的项目目录，不依赖云端重建服务。React 界面通过 Tauri 直接调用 Rust 后端，普通生成和预览不需要额外的本地 HTTP 服务。应用还提供预览编辑（Transform、裁切、删点、反选、撤销）、补拍、多任务队列，以及标准／压缩 PLY、SPZ v4、SOG、MP4 和离线 HTML 等多种导出。

快速使用

1. 从 0.7.1 发布页 下载对应平台安装包：Windows 11 x64 使用 OOOSplat-0.7.1-x64-windows.exe；Apple Silicon macOS 15+ 打开 OOOSplat-0.7.1-arm64-macos.dmg 并拖入“应用程序”；Ubuntu 24.04 执行 sudo apt install ./OOOSplat-0.7.1-x64-linux.deb。
2. 启动应用，确认顶栏内置引擎状态正常；右上角 EN / 中文 可即时切换界面语言。
3. 在右侧“任务列表 → 新任务”中选择草稿或新增，再选视频文件或图片文件夹，等待类型检测；无法判断时在素材框内手动选择普通或全景。
4. 选择项目根目录和质量档位（快速／均衡／精细），查看 COLMAP 加速状态后点击“开始生成”。图片超过 100 张时需先确认文件名是否按拍摄顺序排列，未确认不能启动。
5. 左侧查看阶段、进度和日志；完成的项目进入“已完成”，点击“预览”打开预览工作区。
6. 在“调整”中做 Transform、裁切、删点和反选，编辑记录自动保存；通过“导出”菜单选择标准／压缩 PLY、SPZ v4 或单文件 SOG，或切到“动画”导出 MP4 和离线 HTML。

README 还提供测试素材用于体验生成流程。需要脚本化调用时可用仓库内的 splatstudio 诊断 CLI（health、probe、plan、extract、generate），以及默认关闭、仅监听 127.0.0.1 的 MCP 服务，配置见 MCP 文档。

使用约束

• Windows 11 x64：需要 WebView2 Runtime；视频导出依赖 WebView2 的 WebCodecs AVC 编码，不支持时“导出视频”不可用。COLMAP 的 CUDA 加速需要 NVIDIA 显卡、驱动 580.00 或更高、Compute Capability 7.5 或更高，不满足时自动回退 CPU。Brush 训练需要可用的 GPU 图形后端。安装为整机模式，可能需要管理员权限。
• macOS 15+ Alpha（仅 Apple Silicon）：交付的是未签名、未公证的 .app/.dmg，首次打开可能被 Gatekeeper 阻止，需在“系统设置 → 隐私与安全性”中允许；COLMAP 在该平台固定用 CPU，Brush 使用 Metal。
• Ubuntu 24.04 x86_64 Alpha：仅声明支持该版本；系统 ffmpeg/ffprobe 来自 apt，COLMAP 与 Brush 为随包分发的校验版本。完全 CPU-only 的软件 Vulkan 后端尚未完成端到端验证。
• 每个项目保留源素材副本、输入画面、COLMAP 数据和 Brush 中间文件，长视频或精细档可能占用大量磁盘；删除任务会把整个项目目录移入回收站，失败时不会降级为永久删除。
• 全景仅接受已拼接、完整的 2:1 ERP 素材，不支持双鱼眼、双目、VR180、裁切全景等；普通与全景投影不能混合补拍。
• 匿名使用统计默认开启（随机安装 ID、版本、系统、CPU 架构、事件名、阶段耗时、质量档位、匿名规划指标以及显卡厂商与总显存），可在“设置 → 隐私”关闭，不发送素材、文件名、路径或个人信息。主动错误报告是单独的每次授权。

许可与生成结果

第一方代码与文档以 Apache-2.0 发布（LICENSE），但该许可不授予 OOOSplat 名称、Logo 和图标的商标使用权（商标政策）。随包分发的 FFmpeg、COLMAP、Brush 各自保留原有许可证，不因随应用分发而改用 Apache-2.0。生成的 final.ply 不会仅因使用 OOOSplat 就自动适用随附软件许可证，也不处理输入素材本身的版权归属（生成结果说明）。README 说明第三方通知清单尚未覆盖 Qt、Boost、Ceres 等传递依赖的完整许可审计。

HotRepo 点评

在 2026-11-09 的 Rust 日榜记录中，OOOSplat 累计 2,378 Star、284 Fork，当日新增 109 Star，Rust 日榜最好名次为第 10。README 给出的流水线细节比较具体：三档质量各自规定抽帧帧率、COLMAP 长边与最大特征数、Brush 训练迭代数和分辨率，全景还有独立点数预算，这类说明比只调用几条外部命令的包装层更能反映真实实现。潜在用户主要需要权衡交付形态：可执行安装包与源码树的对应关系在仓库材料中无法验证，macOS 版未签名未公证，Linux 支持仍是 Alpha 且端到端验证目前只在 NVIDIA 硬件上完成。