留境 RoomScan 0.6.0-preview · 记录空间，离线探索

留境 RoomScan 0.6.0-preview

用 Android 记录空间，在局域网电脑上重建，在手机上离线探索。

下载

• 下载 Windows EXE 便携包：Windows x64，包含 EXE、核心运行环境和 Brush。
• 下载 Android APK：Android 12+ / ARM64，使用独立发布密钥签名。
• 完整源码：下方 GitHub 自动生成的 Source code ZIP / TAR.GZ。
• 校验与许可：SHA256SUMS.txt 及 RoomScan-third-party-sources.zip。

Windows 已包含 Python、核心服务依赖和 Brush。首次启动需要联网从官方 PyPI 安装并校验 PyCOLMAP 位姿引擎；之后可离线使用。
如已有不同签名的调试版，请先备份手机采集数据，必要时卸载后安装。

安装与使用

1. 将 Windows ZIP 完整解压到可写目录，保留 _internal/ 和 .tools/，双击 RoomScan.exe。
2. 首次启动保持联网，等待位姿引擎安装完成。训练需要支持 Vulkan/WebGPU 的显卡和合适驱动，无需另装 Python 或 CUDA。
3. 在 Android 手机上安装上述 APK。如系统询问安装来源权限，只为本次使用的下载应用开启相应权限。
4. 手机与电脑连接同一局域网，打开「留境」，扫描电脑窗口的配对二维码。
5. 录制并同步扫描记录，等待电脑重建。模型下载到手机后可以离线探索；关闭电脑窗口会停止服务和训练。

下载后可用 PowerShell 的 Get-FileHash -Algorithm SHA256 <文件路径> 计算摘要，与附件 SHA256SUMS.txt 中同名文件的值核对。

源码仓库维护源代码、必要资源、测试、构建脚本、文档和许可证。编译好的 EXE、APK 与运行环境统一通过此 Releases 页面分发。

本版功能

• Camera2 多镜头采集、传感器画幅与标定、关键帧筛选及本地视频回看。
• 局域网自动发现、一次性二维码配对、TLS 证书固定、分块校验与续传。
• 持久任务队列、COLMAP 位姿求解和 Brush 高斯训练。
• 模型下载校验与离线缓存，浮动摇杆、升降、多指操作及横竖屏探索。
• Windows 独立服务窗口及关闭时的服务 / 训练进程回收。
• MIT 原创源码、完整构建说明、上游许可文本与研究致谢。

验证与边界

本地 Python 测试 22 项、查看器逻辑测试 19 项通过。Windows 便携运行时有隔离目录验证，APK 经 Android SDK apksigner 校验。
本次发布未重新完成所有机型及完整实景重建回归，更多设备的兼容性仍需验证。

这是预览版本。精确视觉惯性定位、真实空间 AR 放置、碰撞、大场景 LOD 及覆盖引导仍在开发。
Windows EXE 尚无商业代码签名，训练需要支持 Vulkan/WebGPU 的显卡和合适驱动。

原始视频默认留在手机。请仅在可信局域网使用，不要将服务转发到公网。
项目原创代码采用 MIT；第三方组件保留原有许可证，PyCOLMAP 的原生依赖包含 GPL 组件，ARCore 适用 Google 条款，详见仓库 THIRD_PARTY_NOTICES.md。

Android 签名证书 SHA-256：
49fbb6f533fa8ff2c8182865b14e9828ed752c77bfd3a75cf2c5f1e87156fb1a