企业官网建设流程全解析

• 桌面应用
• 图形学
• 3D渲染
• 计算机视觉

OOOSplat 是一款一键将视频和图片转换成 3D 高斯泼溅（Gaussian Splats）的本地桌面应用。它的"一键生成"背后，其实跑着 FFmpeg、COLMAP、Brush 三台"隐形引擎"。而这三台引擎的版本与 SHA-256 哈希被严格锁定，这正是 OOOSplat 保证每次重建结果稳定、可复现、来源可追溯的核心机制。本文将带你完整看懂这套引擎锁定机制是如何工作的。

为什么必须锁定引擎版本 🎯

普通用户只需"选个视频 → 点一下生成"，但重建管线依赖的三方引擎各自有独立的版本演化：

• FFmpeg / FFprobe：负责视频抽帧与媒体探测；
• COLMAP：负责特征提取、SfM 重建相机位姿；
• Brush（OOOBrush）：负责高斯泼溅的训练与 PLY 导出。

如果不做锁定，"上周还能跑通的设置，这周突然报错"就会成为常态。OOOSplat 的做法是：原生二进制不存进 Git，但它们的来源 URL、版本、提交号、档案哈希、可执行文件哈希全部钉死在清单文件里。任何一环校验不过，构建直接失败——没有系统回退，也不会从 apt 或 PATH 里"凑合"找一个 COLMAP。

三平台锁定清单：唯一事实来源

所有锁定信息集中在 engines/ 目录下的三份清单中：

以 Windows 清单为例，每款引擎的锁定信息一目了然：

在应用的任务工作区右上角，你能看到FFmpeg · COLMAP · Brush 就绪的状态提示——这背后就是锁定校验全部通过的信号。

三层哈希校验体系 🔐

OOOSplat 的校验不是"验一次就完"，而是分成三个层级：

第一层：下载档案校验。每个引擎只允许从清单中钉死的sourceUrl下载，且档案的 SHA-256 必须与archiveSha256完全一致。下载后的档案缓存在.cache/engines/，坏档案会被直接拒绝，不会污染安装目录。

第二层：安装后二进制校验。清单里的requiredFiles段逐一列出关键可执行文件及其哈希，例如engines/ffmpeg/ffmpeg.exe、engines/colmap/SHA256SUMS、engines/brush/brush_app.exe，逐个重算 SHA-256 对比，不匹配立即报错。

第三层：身份与行为校验。

• COLMAP 由 engines/colmap-runtime.json 独立锁定：源码提交、构建脚本提交、CUDA 工具包版本（13.2.0）、GPU 架构策略（7.5/8.0/8.6/8.9/9.0/10.0/12.0）、离线词汇树哈希都在锁内；
• Brush 的锁校验器（scripts/brush-runtime.mjs）会核对版本、标签、提交号、目标平台，并真正运行--help检查--total-train-iters等训练参数是否齐全；
• scripts/verify-colmap-lock.mjs 还会交叉比对"构建锁"与"运行时锁"是否同源，并明确禁止 Linux 使用系统 COLMAP。

如何验证与更新锁定

开发者本机验证：两条命令即可完成引擎准备与校验。

npm run setup:engines npm run verify:engines

setup从钉死的 URL 下载并解压到engines/对应目录；verify则按平台调用 scripts/verify-engines.ps1（Windows）、scripts/verify-engines-linux.sh、scripts/verify-engines-macos.sh，逐一执行上述三层校验，最后输出类似Verified 4 locked engine files; COLMAP CUDA and Brush CLI are valid.的结论。

正式构建：build:bundle会把verify:bundle-resources、verify:engines、verify:licenses串联在构建之前，任何校验失败都会阻断打包。Windows 安装包因此内嵌了完整的已验证运行时，最终用户无需自行下载或配置任何引擎。

引擎升级流程（面向维护者）：

1. 通过 COLMAP 专用工作流构建新运行时档案，审核BUILD-INFO.json、SHA256SUMS、许可证等元数据；
2. 以新的不可变标签发布资产，用 scripts/lock-engine-archive.mjs 重算档案哈希并写入对应平台清单，状态标记为hash-locked；
3. 再跑一遍干净主机与真实 GPU 验收后，才允许分发给用户。

小结：从"钉死来源"到"三层哈希"，再到"构建前强制校验"，OOOSplat 的引擎锁定机制让 FFmpeg、COLMAP、Brush 的每一次参与都可验证、可复现——这也是"一键生成 3D"能够稳定交付的底层保障。🔒

• 桌面应用
• 图形学
• 3D渲染
• 计算机视觉