OOOSplat

下载 | 中文 | English

OOOSplat 是一款将普通或全景视频、图片序列一键转换为 3D Gaussian Splatting 的本地桌面应用。选择素材、项目目录和质量档位，即可自动完成生成，并直接预览、编辑和导出结果。

Windows 和 Apple Silicon macOS Alpha 均随应用提供 FFmpeg、FFprobe、COLMAP 和 Brush；Linux 支持目前仅作为 Ubuntu 24.04 LTS x86_64 Alpha 提供。整个生成流程使用本机 CPU 和 GPU，输入素材、工程文件、模型与日志无需上传到云端重建或训练服务。React 界面通过 Tauri 直接调用本机 Rust 后端，普通生成与预览不需要额外启动 HTTP 服务。

查看 OOOSplat Roadmap 了解后续规划。

0.7.1 更新默认生成、自动重试与精细档预算，加入分级抽帧和漫游调速，完善补拍、图片 GPS 辅助、导出及错误诊断。

以下以当前 main 源码功能为准，安装包内容以对应版本说明为准。

核心优势

• 一键生成高斯泼溅：只需选择输入视频或图片序列、项目目录和质量档位，即可自动完成画面准备、COLMAP 相机重建、Brush 训练和 final.ply 发布，无需手动拼接命令或配置引擎。
• 全平台兼容：支持 Windows、macOS 和 Linux，可在三大主流桌面系统上完成本地高斯泼溅生成；具体系统与处理器要求请参阅下方兼容性说明。
• 安全与隐私保护：素材、抽帧、相机重建数据、高斯模型和日志默认只保存在用户选择的本地项目目录，核心生成流程在本机完成，无需将原始视频、图像或模型上传到第三方重建与训练平台，从而减少数据在网络传输、云端留存和未经授权访问过程中的泄露风险。
• 完全本地化算力：重建与训练均在用户自己的电脑上运行，不调用远程计算服务。满足要求时 COLMAP 自动使用本机 NVIDIA GPU 加速，否则回退 CPU，过程和数据始终由用户掌控。

展示视频

https://github.com/user-attachments/assets/5b9e8cef-4c71-4bfa-ba23-641fcdd37659

界面预览

创建与管理任务

高斯泼溅预览与调整

主要功能

• 一键生成：支持 MP4、MOV 和 JPG、JPEG、PNG 图片序列，自动完成画面准备、相机重建、训练和 PLY 发布。
• 全景素材：支持已拼接、单目、完整 360°×180° 的 2:1 ERP MP4 和图片文件夹；自动检测类型，无法确定时在素材框中选择。
• 图片顺序确认：普通及全景图片超过100张时，生成前询问拍摄顺序；已排序使用顺序匹配，未排序或100张及以下使用穷举匹配。
• 图片 GPS：识别内嵌定位信息，在通过校验的 Windows x64 路径中辅助匹配与重建，可靠时提供北向与米制尺度；信息不足自动沿用原流程。范围及验证
• 导入外部模型：可从“已完成”分组导入标准/压缩 PLY、SOG、SPZ、SPLAT 和 KSPLAT；完整 COLMAP 数据会自动关联，通过兼容性校验后可补拍，外部文件保持只读。
• 三种质量档位：默认启用重建优化与自动补帧，视频可分级调整抽帧比例，手动比例任务最多额外补20%；精细档保留原始训练分辨率，普通素材按有效像素与重建轨迹计算 Splat 上限（系数0.5），全景保持独立预算。
• 自动重试：默认开启，允许显存不足后减少点数重试或调整补拍方案；可关闭，实际重试后在完成详情标记。
• 透明素材：支持透明 MOV 和 PNG，保留原始颜色与 Alpha，并自动生成 COLMAP 黑白蒙版。
• 多任务管理：任务列表分为新任务、已完成和未完成，可保存多个草稿、调整顺序并自动执行下一个任务；同一时间只运行一个生成任务，支持取消和断点续跑。
• 补拍：根据原模型情况选择重建方式及是否沿用原模型，训练参数与正常生成一致；支持跨尺寸普通素材和完整 ERP 全景补拍，派生项目不覆盖原结果。
• 预览与编辑：支持 WebGPU／WebGL2、移动轴与旋转环、裁切、删点、反选和撤销重做；静止画面停止重绘，交互最高60 FPS。支持0.1×–5.0×水平 WASD 漫游与首帧训练视角定位。
• 多种导出：支持标准 PLY、压缩 PLY、SPZ v4、单文件 SOG，以及竖屏或横屏 MP4、单文件离线 HTML。SPZ 坐标越界时，经确认可仅调整导出副本。
• 本地运行：COLMAP 重建与 Brush 训练都在本机完成；满足条件时自动使用 GPU，否则使用可用的兼容路径。
• 跨平台与双语界面：支持 Windows、Apple Silicon macOS 和 Ubuntu，并可在简体中文与英文之间切换。

全景图片每批需至少两张且尺寸一致；仅有 2:1 比例不会自动判为全景。不支持双鱼眼、双目、VR180、裁切全景或厂商私有原片；普通与全景投影不能混合补拍。全景缓存不再设固定 20 GiB 上限，请预留足够磁盘空间；单幅解码仍限 512 MiB。格式、参数和验证范围见全景视频、全景图片与补拍说明。

压缩 PLY、SPZ 和 SOG 不再按估算内存拒绝导出，但仍受实际内存、磁盘和格式约束影响；取消人为门槛不代表大模型一定能够导出。详见导出说明与验证。

Gaussian 编辑快捷键

• 矩形选择时，左键拖动替换选区，Shift + 左键拖动添加，Ctrl + 左键拖动移除；中键旋转视角，右键平移，滚轮缩放。
• 黄色高亮表示当前选区；按 Delete 或 Backspace 删除选中 Gaussian，按 Esc 清空临时选区。
• 在矩形、球形或盒形选择中，点击“反选”或按 Ctrl + I（macOS 为 ⌘ + I）切换保留或选中的部分。
• 球形或盒形选择会自动进入正交视图，可切换侧视图、正视图和顶视图，并通过视口控制器或数值面板调整位置与大小。
• 变换面板中的“场景操作轴”可切换“移动／旋转”，再次点击当前选中的按钮即可关闭；左键拖轴操作模型，拖动空白处转动视角。旋转环和面板旋转都围绕模型中心；松开提交一次编辑，Esc 取消本次拖轴，操作轴模式保存在本机。
• 使用 WASD 沿水平面漫游，Shift 三倍加速；编辑完成后可直接继续漫游，右下角滑轨支持0.1×–5.0×调速并记住本机设置。速度随缩放调整，仅透视视图可用。
• Ctrl + Z 撤销，Ctrl + Shift + Z 或 Ctrl + Y 重做。模型变换、裁切和删除共享同一历史记录；相机移动和临时黄色选区不计入历史。

处理流程

输入视频或图片序列
  │
  ├─ 视频：FFprobe 分析，FFmpeg 按档位目标 FPS 或手动比例及工作分辨率抽帧；透明视频同步生成 RGBA 画面与 Mask
  ├─ 图片：快速扫描文件头并按文件名自然排序，复制源素材后优先硬链接复用；按需生成 Alpha Mask
  ├─ COLMAP：自动选择 CPU 或 CUDA GPU 提取特征；视频顺序匹配，图片默认穷举匹配，超过100张可确认按序匹配；顺序匹配沿用档位闭环检测规则
  ├─ COLMAP：增量重建并验证注册率和三维点，按需桥接补帧；仅实际透明素材启用两视图三角化
  ├─ 全景：先保留整幅 ERP 做球面重建，仅将已注册画面转为六面训练图片
  ├─ Brush：使用可用 GPU 训练 Gaussian Splats；精细档按原始训练分辨率规划
  └─ 校验 PLY 后原子发布为 final.ply

COLMAP 生成至少一张注册图像和有效三维点后，普通生成任务会继续进入 Brush。注册率低于 80% 时会给出质量警告，不会仅因注册率低而终止；补拍还要求至少一张新增画面成功注册。

图片序列预检只读取 JPG/PNG 文件头，检查数量、尺寸和 Alpha 通道，不提前解码全部像素。“检测到 Alpha 通道”不等于已经找到透明区域，生成时才检查实际透明度并按需启用 Mask。项目仍保留一份源素材副本；项目内的画面优先通过硬链接复用，不支持时回退复制，素材导入和画面准备期间会持续显示进度与日志。

系统要求

• Windows 11，x64。
• 支持 WebView2 Runtime。
• 视频导出需要 WebView2 提供 WebCodecs AVC 编码能力；不支持时仍可在“动画”模式播放效果，但“导出视频”会显示不可用原因。
• Brush 训练需要可用的 GPU 图形后端，建议使用独立显卡。
• COLMAP 的 CUDA 加速需要 NVIDIA 显卡、Windows 驱动 580.00 或更高版本，以及 Compute Capability 7.5 或更高版本；不满足要求时程序会自动使用 CPU，无需用户配置。
• 项目磁盘需要容纳源素材副本、输入图像、COLMAP 数据、Brush 中间文件和最终 PLY。长视频、大型图片序列或精细档位可能占用大量空间。
• 安装模式为整机安装，安装时可能需要管理员权限。

Windows 内置的 COLMAP 使用同时支持 CPU 与 CUDA GPU 的构建，运行前会自动选择可用后端；Brush 训练使用可用图形后端，二者的 GPU 检测与运行机制相互独立。

macOS 15+ Alpha（仅限 Apple Silicon）

当前交付为未签名、未公证的 .app/.dmg Alpha，仅支持 M1 或更新的 Apple Silicon Mac，不支持 Intel Mac 或 Universal Binary。

• 内置原生 arm64 FFmpeg 8.1.2、独立 FFprobe、COLMAP 4.2.1 Ceres CPU CLI-only 和 OOOBrush ooo-v1.0.0 CLI。
• 用户不需要安装 Homebrew，也不会回退到 Homebrew 或系统 PATH 中的同名程序。
• COLMAP 固定使用 CPU；Brush 独立选择可用的 Metal 图形后端，界面会明确显示该原因。
• 首次打开未签名版本时，macOS Gatekeeper 可能阻止启动。确认应用来自可信来源且未被修改后，可按 Apple 官方打开说明，在“系统设置 → 隐私与安全性”中选择“仍要打开”；macOS 15 及以上不再支持右键绕过该提示。

Ubuntu 24.04 Alpha（仅限 x86_64）

本 Alpha 交付由 Ubuntu 24.04 构建的 x86_64 .deb 安装包；不声明支持 Ubuntu 22.04、其他 Linux 发行版或生产环境部署。

• Ubuntu 24.04 LTS，x86_64。
• Brush 支持的图形后端和对应驱动；Brush 官方支持 AMD、Intel 和 NVIDIA GPU。当前端到端验证使用 NVIDIA GPU，CPU-only 软件图形后端尚未验证，但不会被启动检查人为阻止。
• 从源码构建需要 Node.js 22.12+、Rust stable 和 Tauri 2 的 WebKitGTK 开发依赖；安装 .deb 的用户不需要这些开发工具。
• Ubuntu 24.04 系统 ffmpeg、ffprobe；COLMAP 4.2.1 使用校验后随应用分发的自编译版本，不使用 apt/PATH COLMAP。
• OOOBrush ooo-v1.0.0 Linux x86_64 CLI，由 npm run setup:engines 下载并校验。

Ubuntu 依赖安装：

sudo apt update
sudo apt install -y \
  build-essential curl file ffmpeg \
  libwebkit2gtk-4.1-dev libxdo-dev libssl-dev \
  libayatana-appindicator3-dev librsvg2-dev libdbus-1-dev

请为显卡安装可用的 Vulkan 驱动（例如 NVIDIA 专有驱动，或 AMD/Intel 的 Mesa 驱动）。内置 COLMAP 在兼容 NVIDIA 设备上使用 CUDA/Caspar，否则使用 CPU/Ceres；Brush 独立选择图形后端。完全 CPU-only 的软件 Vulkan 后端尚未完成端到端验证。

从 main 分支 GitHub Actions 下载 OOOSplat-0.7.1-x64-linux Artifact 后，可执行：

sudo apt install ./OOOSplat-0.7.1-x64-linux.deb

.deb 仅通过 Ubuntu 包管理器安装 FFmpeg/FFprobe；锁定的 COLMAP 和 Brush 已包含在安装包中。

安装与使用

测试素材：夸克网盘下载，可用于测试或体验生成流程。

1. Windows 运行 OOOSplat-0.7.1-x64-windows.exe；Apple Silicon Mac 打开 OOOSplat-0.7.1-arm64-macos.dmg 并将 OOOSplat 拖入“应用程序”；Ubuntu 24.04 使用 sudo apt install ./OOOSplat-0.7.1-x64-linux.deb。
2. 启动 OOOSplat，确认顶栏中的内置引擎状态正常；可使用右上角的 EN / 中文 按钮即时切换界面语言。
3. 在右侧“任务列表 → 新任务”中选择草稿或点击“新增”，再选择视频文件或图片文件夹。等待类型检测完成；无法确定时，在素材框内选择普通或全景类型。
4. 选择项目根目录；程序会记住上次使用的位置。
5. 选择“快速”“均衡”或“精细”档位。
6. 查看 COLMAP 加速状态并点击“开始生成”；图片超过100张时，需确认文件名是否按拍摄顺序排列，未选择不能启动。
7. 在左侧查看所选任务的阶段、进度和日志；点击右侧任意任务可切换详情。生成出的项目按状态进入“已完成”或“未完成”，已完成项目可点击“预览”。
8. 在“预览”的“调整”模式中修改模型，变换、裁切和删除记录会自动保存到项目中，视角按项目保存在本机。点击“保存编辑”可确认当前编辑与视角已保存；需要模型文件时，在“导出”菜单直接选择标准 PLY、压缩 PLY、SPZ 或 SOG，无需再次确认格式。调整和动画模式均可使用。
9. 切换到“动画”，在命令栏中间选择“竖屏 / 横屏”，通过“导出 → 导出视频”生成 30 FPS、23 秒 MP4，分辨率分别为 1080×1920 和 1920×1080；调整或动画模式均可导出离线 HTML。导出使用当前编辑结果，可取消，完成后可打开所在文件夹。
10. 如需补充细节，在已完成项目中点击“补拍”，选择新素材并检查类型，按需调整质量和自动重试。点击“开始生成”后回答原模型情况，普通素材还需确认拍摄设置是否相同，无需再次确认方案；开启自动重试时允许失败后改用更耗时的方案。新旧素材须属于同一场景并有足够重叠。

使用提示：

• 拖动左右面板之间的分界线可以调整宽度；双击分界线恢复默认比例。
• 点击右下角百分比按钮可缩小、恢复或放大整个界面。
• 新任务草稿会在本机保存，重启后重新检查素材。运行中的任务参数不能修改，但可以切换并编辑其他草稿；不能同时启动第二个任务。
• 新任务可拖动排序。“自动执行下一个任务”默认关闭，开启后按顺序执行，不跳过未就绪任务；图片顺序确认会暂停启动，取消则关闭队列。
• 新补拍默认继承源项目质量，自动重试默认开启，启动前可修改。普通补拍支持不同尺寸、宽高比和设备／镜头；全景仅接收完整 ERP，批次之间可不同尺寸。不能重复输入原素材，缺少可信图片或重建数据时不能启动。
• 沿用原模型时，从未经编辑的生成 PLY 初始化，旧图、新图共同使用正常完整训练配方，不另行缩短步数或降低学习率。只有确认拍摄设置相同且单相机、工作图片尺寸及方向兼容时才复用原内参。它不是完整断点续训，也不保证只改变新增区域；派生项目不继承删除或裁切。已有任务仍按原快照执行。实测范围见补拍说明。
• 任务页日志保留最近 500 条，完整引擎日志位于项目的 logs/ 目录。训练资源面板默认隐藏，可在“设置 → 界面”中开启。
• 点击“删除”会回收整个项目目录，包括源视频副本和所有中间文件；如果移入回收站失败，程序不会降级为永久删除。

质量档位

原自动优化的基础策略现为默认设置。快速／均衡保留工作分辨率限制，精细档使用原始训练分辨率；不放大低分辨率素材。图片保留全部有效输入，视频可在档位上方分级调整抽帧比例，并保留按源 FPS 换算的精确默认档。

新策略、自动重试规则与兼容说明见默认生成策略；历史配方和开发环境配置见参数配置。

视频和已确认按序排列的图片默认使用档位对应的离线闭环检测，不保证所有素材均能闭环。补拍独立匹配新旧画面，新增画面之间沿用窗口10和档位闭环规则。自动补帧不受自动重试开关影响。

手动抽帧的新任务在初始注册率低于80%、存在有效初始模型时，可按未注册区间尝试一轮桥接补帧，最多额外补首次实际帧数的20%，且不超过源视频可用帧数。例如首次360张，最多再补72张；100%抽帧不再新增。首次帧数仍遵守最少30帧规则，源帧不足时全部采用。默认抽帧仍用下表的桥接候选预算。旧任务中断续跑保留原规则；1.2倍只是帧数预算，不保证耗时或成功率。详见补帧规则与验证。

下表为普通素材。普通精细档按已注册训练图片的有效像素与平均重建轨迹长度计算 Splat 上限，系数为0.5；完全透明像素不计入，初始化点数不被削减。公式与适用范围见精细档预算。

全景使用独立训练配方和点数预算。精细档保留原始 ERP，训练六面边长为 floor(ERP宽度 / 4)，不放大素材。点数预算按原始球面模型统计，不因六面转换乘六。所有上限均不保证实际点数、画质或显存安全。