Repository navigation
🚀 v2.0.0
Important
Windows 推荐:网盘下载完整便携包。 下方 GitHub Assets 中的源码安装 ZIP 与 Source code 不包含 Python/CUDA 运行环境和模型权重,需要另行安装依赖。
Recommended for Windows: Download the full portable packages. The source/install ZIP and Source code assets below do not include the Python/CUDA runtime or model weights and require dependency installation.
📥 Windows 完整便携包(推荐) / Windows Full Portable Bundles (Recommended)
网盘下载:打开便携包文件夹 / Download: Open portable bundle folder.
| 适用显卡与用途 / GPU and Use | 文件 / File | 大小 / Size | SHA256 |
|---|---|---|---|
| RTX 50,核心功能 / RTX 50, core | sharp-gui-v2.0.0-windows-cu128-rtx50-portable.zip |
6.06 GiB | 7409AF727E5E46721ED6F19C5D29DC80774E50FEAB1D807810FD07229ECEC0FD |
| RTX 50,含视频重建 / RTX 50, video reconstruction | sharp-gui-v2.0.0-windows-cu128-rtx50-video-recon-portable.zip |
6.73 GiB | 9584010AFF3944C52A37BFEA5EF54D9938321D826918905A510E11C1D565583D |
| RTX 50 以下主流 NVIDIA,核心功能 / Mainstream NVIDIA below RTX 50, core | sharp-gui-v2.0.0-windows-cu126-mainstream-portable.zip |
5.55 GiB | 139985D660B24527290A192B3D6E80C4D184B28EEA9D5FA67C176C6BE2517FC7 |
- 显卡与用途:RTX 50 选择 CUDA 12.8 核心包,需要视频重建时选择视频完整包;RTX 50 以下主流 NVIDIA 选择 CUDA 12.6 核心包。当前没有纯 CPU 便携包 / Choose CUDA 12.8 core for RTX 50, or its video bundle for reconstruction; mainstream NVIDIA GPUs below RTX 50 use CUDA 12.6 core. No CPU-only portable bundle is provided.
- 校验后再解压:下载 ZIP 和同名
.sha256.txt,使用 PowerShell 的Get-FileHash -Algorithm SHA256 "下载的ZIP文件路径"核对结果 / Download the ZIP and matching.sha256.txt, then verify with PowerShell:Get-FileHash -Algorithm SHA256 "path-to-downloaded.zip".
🚀 v2.0.0 功能更新 / Features
从一张照片或一段视频开始,把重建、整理、编辑、运镜与分享串成完整的空间影像创作流程。v2.0.0 保留单图空间照片的便捷体验,重构视频重建,并带来模型编辑、动画导出和原片联动。 / Start with a photo or video and move through reconstruction, organization, editing, camera animation, and sharing. v2.0.0 keeps single-photo creation simple while rebuilding video reconstruction and adding model editing, animation export, and source-media links.
升级提示:v1.4.0 及更早的 Windows 便携包必须下载 v2.0.0 新完整包,不能只更新代码。 本版更换了视频重建工具链与便携运行环境;原工作区、模型和相册目录请保留。 / Windows portable users on v1.4.0 or earlier must download a new full v2.0.0 bundle; a code-only update is insufficient. This release changes the video reconstruction toolchain and portable runtime. Keep your existing workspace, models, and album folders.
🎥 视频重建全面升级 / Rebuilt Video Reconstruction
- 画质与效率提升:重构抽帧、相机配准、训练与导出流程,采用 COLMAP + Brush 训练路线并升级训练引擎与跨帧匹配,相比旧路线改善主体细节、边缘与场景层次,并减少处理耗时 / Rebuilt frame extraction, camera alignment, training, and export around COLMAP and Brush with an updated training engine and cross-frame matching, improving detail, edges, and scene depth while reducing processing time compared with the previous pipeline.
- 三档质量与自定义:提供快速预览、高质量和极致档;高质量保持 1920 长边,极致档在已验证的 12 GB 环境下保留 3840 长边,也可手动调参 / Choose Preview, High Quality, or Extreme, or customize settings. High Quality retains a 1920-pixel long edge; Extreme retains 3840 pixels in the validated 12 GB setup.
- 进度与结果更清楚:显示分阶段进度、配准检查与训练预览,输出 PLY / SPZ,生成后可回看原视频并继续编辑或导出动画 / Follow stage progress, alignment checks, and training previews, then open PLY / SPZ results, revisit the source video, edit the model, or export an animation.
- 生成信息可追溯:单图和视频模型新增实际生成耗时、分阶段耗时及输入规格、引擎和训练条件,资产详情可直接查看;编辑副本保留原始生成来源 / Image and video results now record processing time, stage timings, input specifications, engine, and training settings in model details; edited copies retain their reconstruction provenance.
- 失败提示更准确:区分显存不足、设备中断和系统内存不足,避免用无关的降配重试掩盖真实问题 / Clearer messages distinguish GPU memory limits, device interruptions, and system memory shortages, avoiding unrelated quality reductions or retries.
实际画质和耗时取决于素材、档位与设备;部分素材与大幅偏转视角仍可能出现漂浮物或闪烁;完整视频流程已在 Windows + RTX 5070 Ti Laptop(12 GB)验证。 / Quality and processing time depend on footage, settings, and hardware; floaters or flicker may remain with some footage or large viewpoint changes. The complete video workflow has been validated on Windows with an RTX 5070 Ti Laptop GPU (12 GB).
✂️ 模型编辑与坐标校准 / Model Editing and Calibration
- 清理模型:矩形、球形、盒形选择高斯点,支持删除选中或仅保留选中,以及撤销 / 重做 / Select splats with rectangle, sphere, or box tools, delete the selection or keep only it, and undo or redo edits.
- 拖动即可调整:直接拖动选区边界、双向箭头或数值调整范围,保留键盘输入、滚轮与 Shift 精细调节 / Drag selection boundaries, double arrows, or numeric controls, with typed values, wheel adjustments, and Shift for precision.
- 校准原点与朝向:设置实际原点,绕选定原点调平模型;支持重置朝向和记录初始视角,保存后校准写入模型文件 / Set the actual origin, level the model around it, reset orientation, and save an initial view. Saved calibration is written into the model file.
- 副本或覆盖保存:从资产卡片、详情或查看器进入编辑器,保存新模型或覆盖受控资产;临时打开的外部模型可选择「加入并编辑」 / Enter editing from an asset card, details, or the viewer, then save a copy or overwrite the managed asset. Temporary external previews offer Add & Edit.
编辑支持标准高斯 PLY、支持版本的 SPZ 和 SPLAT;原版 ml-sharp 含附加相机元素的 PLY、RAD 与普通点云暂不支持编辑。 / Editing supports standard Gaussian PLY, supported SPZ versions, and SPLAT. Original ml-sharp PLY files with extra camera elements, RAD, and ordinary point clouds remain unsupported for editing.
🎬 导出动画与可视化轨迹 / Animation Export and Camera Paths
- 自己设计镜头:记录、替换和排序关键帧,调整过渡时长,预览播放,并将镜头方案保存为 JSON 或重新载入 / Record, replace, and reorder keyframes, adjust transition durations, preview playback, and save or load camera plans as JSON.
- 五种运动曲线:连续平滑、标准缓入缓出、正弦缓入缓出、柔和停靠和匀速直线,让环绕、升降与特写更自然 / Choose continuous smoothing, standard easing, sine easing, gentle stops, or constant-speed straight motion for orbits, rises, and close-ups.
- 看得见运动路线:轨迹总览显示编号关键帧、路径、运动方向与相机视锥;时间轴同步当前镜头,辅助线不会出现在成片中 / Inspect numbered keyframes, paths, motion direction, and camera frustums, with timeline synchronization and no guides in the exported video.
- 横竖屏视频输出:支持 1080p / 4K、24 / 30 / 60 fps,默认 WebM,也可选择 MP4(H.264);支持取消导出及恢复初始视角,保留镜头草稿 / Export landscape or portrait video at 1080p / 4K and 24 / 30 / 60 fps, using default WebM or optional H.264 MP4. Cancel exports or restore the initial view while keeping keyframes.
视频不含音轨,可用格式与分辨率取决于浏览器编码能力;不支持时会明确提示。 / Videos contain no audio. Available formats and resolutions depend on browser encoding support, with clear messages when unavailable.
🔗 图库与模型真正联动 / Connected Gallery and Models
- 原片直达 3D:已生成模型的图片和视频显示蓝色 3D 标识,预览页可直接打开关联模型,也可再次生成 / Images and videos with model results show a blue 3D badge, with direct model access and regeneration from the preview.
- 多个结果有序管理:同一原片多次生成、编辑出的多个模型集中展示,可选择查看版本并设置默认模型 / Keep repeated reconstructions and edited variants together, choose a version, and set the default model for each source.
- 模型原片相册:固定相册汇总已有模型对应的图片与视频;编辑后的模型继续保留原片关联 / A fixed Model Sources album collects images and videos with model results, and edited variants retain their source links.
📤 独立 HTML 分享升级 / Improved Standalone HTML Sharing
- 保留作品的打开效果:分享页同步模型方向与保存的初始视角,支持全模型取景、自动环绕、背景切换、全屏与双语帮助 / Shared pages preserve orientation and the saved initial view, with full-model framing, auto-orbit, backgrounds, fullscreen, and bilingual help.
- 单文件离线打开:模型与查看器嵌入 HTML,支持鼠标、键盘和移动端控制;发给他人后可直接在支持的浏览器中离线查看 / The model and viewer are embedded in one HTML file, with mouse, keyboard, and mobile controls for offline viewing in supported browsers.
独立 HTML 分享目前适用于生成结果;直接导入或临时打开的模型暂不支持。 / Standalone HTML sharing currently supports generated results; directly imported or temporary models are not supported.
⚙️ 设置与换包体验 / Settings and Package Migration
- 按用途分组:常规、访问与安全、查看器、图库、视频重建和更新中心分组展示,切换分组保留未保存内容 / Settings are grouped into General, Access & Security, Viewer, Gallery, Video Reconstruction, and Updates, preserving drafts across sections.
- 配置不再跟着旧包走:配置保存在系统用户目录,同一账号换新版完整包可继续使用原工作区和相册;支持从旧包预览并恢复配置 / Settings live in the system user directory, allowing a new full bundle under the same account to reuse the workspace and albums, with preview and recovery of older package settings.
🐛 日常体验修复 / Everyday Fixes
- 排序与完整信息:近期模型和资产库默认按最近创建排序;恢复长名称、文件格式和大小的统一悬浮提示 / Recent models and the library default to newest-created order, with restored tooltips for long names, formats, and sizes.
- 原片缩略图:优先复用已有高清相册缩略图,原相册或缓存不可用时回退模型封面 / Reuse existing high-resolution gallery thumbnails where available, with model-cover fallback when the album or cache is unavailable.
- 离线相册:断开的移动硬盘、NAS 或缺失目录不会导致相册被误删,显示不可用状态并避免打开失效缓存 / Disconnected drives, NAS locations, and missing folders no longer remove albums; unavailable states prevent stale previews.
- 外部模型预览:未知外部模型采用视频预览与居中取景,识别完整 ml-sharp PLY 结构时使用单图预览;保留明确校准,不改写导入文件 / Unknown external models use video-style preview and centered framing; complete ml-sharp PLY schemas use the single-image view. Explicit calibration is preserved and imported files are not rewritten.
- 文档与主页:补齐编辑、动画和原片联动示意,精简高收益媒体资源,恢复四栏目录,并把日常启动与首次安装分开 / Updated editing, animation, and source-link examples, optimized high-impact media assets, restored the four-column contents layout, and separated daily startup from installation.
🔄 从旧版本更新 / Update from Previous Versions
- 旧 Windows 便携包:v1.4.0 及更早版本请下载本次新完整包,不能通过代码更新补齐新的大型运行环境;不要删除原工作区、模型和相册目录 / Users of v1.4.0 or earlier Windows portable bundles must download this release's full bundle. Code updates cannot supply the new runtime; keep existing workspace, model, and album folders.
- 恢复旧配置:首次启动会尝试读取旧配置;若新版没有显示原模型或相册,在「设置 → 常规」选择旧包配置进行恢复 / First startup attempts to import older settings. If models or albums are missing, restore the old package configuration from Settings → General.
- 后续兼容更新:新版受管便携包可在「设置 → 更新中心」更新兼容代码,保留工作区、模型、配置、证书和运行环境;更新验证失败时自动恢复 / Managed bundles can install compatible code from Settings → Updates while preserving workspaces, models, settings, certificates, and runtime. Failed update validation restores the previous version automatically.
- 更新通道:Stable 只获取正式
vX.Y.Z版本;Latest 包含正式发布之后的主分支提交,测试程度较低 / Stable selects formalvX.Y.Zreleases only; Latest includes main-branch commits made after releases, with less testing. - Git 与通用 ZIP:Git 用户拉取后重新运行安装脚本,并按视频环境指南准备新工具;通用 Release ZIP 需安装依赖,且不支持直接应用自更新 / Git users should pull, rerun installation, and prepare new video tools using the setup guide. Generic Release ZIPs require dependency installation and cannot apply in-app updates.
📦 快速使用 / Quick Start
- Windows 完整便携包:下载匹配显卡的 ZIP,校验 SHA256,解压后双击
portable-run.bat,无需运行安装脚本 / Download the bundle for your GPU, verify SHA256, extract it, and double-clickportable-run.bat; no installation script is needed. - 源码或通用 Release ZIP:Windows 首次运行
install.bat,之后使用run.bat;Linux/macOS 首次运行./install.sh,之后使用./run.sh/ On Windows, install once withinstall.bat, then start withrun.bat. On Linux/macOS, install with./install.sh, then use./run.sh. - 浏览器访问:启动后打开
https://127.0.0.1:5050;同一局域网的设备使用部署电脑的 IP / Openhttps://127.0.0.1:5050; other LAN devices use the host computer's IP.
📖 中文详细教程:查看 README
📖 English Guide: View README.en.md
完整变更 / Full Changelog: v1.4.0 → v2.0.0