sharp-gui

🚀 v1.4.0

Sharp GUI 1.4.0 带来统一的模型资产库、界面内自更新，以及 MKV 视频与音轨兼容改进，让模型整理、日常浏览和版本升级更加方便。 / Sharp GUI 1.4.0 introduces a unified model library, in-app updates, and improved MKV video and audio compatibility, making model management, browsing, and upgrades easier.

🗂️ 全新模型资产库 / New Model Library

• 统一管理模型: 在同一个资产库中浏览生成模型与导入模型，支持 PLY、SPZ、SPLAT 和 RAD 格式 / Browse generated and imported models in one library, with support for PLY, SPZ, SPLAT, and RAD.
• 批量导入与临时预览: 支持拖拽多个模型批量入库，也可先预览单个模型再加入资产库；导入时显示上传进度和处理结果 / Drag multiple models into the library, or preview a single model before saving it; imports show upload progress and results.
• 资料与封面管理: 支持编辑模型名称、标签和备注，自动生成模型封面，也可上传或刷新封面 / Edit model names, tags, and notes, with automatically generated covers and options to upload or refresh them.
• 查找与浏览更方便: 支持筛选、排序、网格密度调整、滚动加载、近期模型和详情面板；预览返回后保留浏览位置 / Filter, sort, adjust grid density, browse recent models, and inspect details, with incremental loading and browsing position preserved after preview.
• 批量下载与删除: 多选模型后可打包为一个 ZIP 下载，本机管理者可批量删除；部分操作失败时保留失败项，方便继续处理 / Download selected models as a single ZIP, or batch-delete them as the local owner; failed items remain selected for follow-up.
• 格式偏好与工作区隔离: 打开和下载优先使用设置中的默认模型格式，不可用时自动选择已有格式；不同工作区分别保存各自的模型资产 / Opening and downloading respect your preferred model format and fall back when needed; each workspace keeps its own model library.

🔄 界面内自更新 / In-App Updates

• 更新中心: 在设置中查看当前版本、检查更新、查看更新进度并安装兼容版本，更新后应用自动重启 / View your version, check for updates, follow progress, and install compatible updates from Settings, with automatic restart.
• 稳定版与最新代码: Stable 仅获取正式 vX.Y.Z 版本；Latest 获取 main 分支最新提交，包含正式发布之后的改动，测试程度较低 / Stable selects formal vX.Y.Z releases only; Latest follows main, including changes made after official releases, with less testing.
• 保留数据与环境: 兼容代码更新只替换应用代码，保留工作区、模型、配置、证书和运行环境；Windows 新便携包无需另外安装 Git / Compatible code updates replace only application code, preserving workspaces, models, settings, certificates, and runtime environments; new Windows portable bundles require no separate Git installation.
• 更新前检查与失败恢复: 更新前检查运行中的任务、本地代码修改和版本兼容性，并显示阻止更新的原因；新版本验证失败时自动恢复到更新前的版本 / Pre-update checks detect active tasks, local code changes, and compatibility issues and explain blockers; failed new-version validation automatically restores the previous version.

🎬 视频与模型预览改进 / Video and Model Preview Improvements

• MKV 支持: 本地媒体图库新增 MKV 扫描、上传和预览支持，并可从 MKV 视频进入 3D 重建流程 / The media gallery now supports scanning, uploading, and previewing MKV files, with access to the video-to-3D reconstruction workflow.
• 兼容更多音轨: 对 EAC3、AC3、DTS 和 TrueHD 等音轨提供按需 AAC 兼容播放，改善音画同步、拖动恢复和预缓冲体验，无需保存整段转换音轨；需要可用的 ffmpeg / On-demand AAC playback improves compatibility with EAC3, AC3, DTS, and TrueHD audio, with better synchronization, seeking, and buffering without storing a full converted audio track; ffmpeg is required.
• 多格式模型浏览: 同名的不同格式模型合并展示，完善格式选择、下载和已有模型的分享导出体验；转换时保留原始 PLY 文件 / Models with matching names across formats are grouped together, with improved format selection, downloads, and sharing/export for existing models; conversions preserve the original PLY.
• 加载与分享更流畅: 模型加载进度按实际文件大小反馈，进度条与百分比同步；优化大型模型独立 HTML 分享页的内存占用，并支持快捷关闭当前预览 / Model loading progress reflects actual file size with synchronized percentages, large standalone HTML shares use memory more efficiently, and the current preview can be closed quickly.

🐛 Bug 修复 / Bug Fixes

• 模型预览方向: 修复图片生成、视频重建和导入模型的初始预览方向不稳定，以及快速切换模型时状态相互影响的问题 / Fixed inconsistent initial orientation across image-generated, video-reconstructed, and imported models, along with state interference during rapid switching.
• 中文名称与重名上传: 保留中文展示名和下载名，避免同名图片上传相互覆盖，并修复部分多格式模型文件定位问题 / Preserved Chinese display and download names, prevented same-name image uploads from overwriting each other, and fixed file lookup issues for multi-format models.
• 任务队列同步: 修复连续上传、取消任务或状态刷新时任务丢失、状态被旧结果

🚀 v1.3.0

Sharp GUI 1.3.0 聚焦视频 3DGS 重建、视频重建完整便携包和本地媒体图库体验升级，让本地视频可以从图库或拖拽入口进入 3D 模型生成流程。 / Sharp GUI 1.3.0 focuses on Video 3DGS reconstruction, a dedicated video reconstruction portable bundle, and local media gallery improvements, letting local videos enter the 3D model workflow from the gallery or drag-and-drop entries.

🎥 视频 3DGS 重建 / Video 3DGS Reconstruction

• 视频生成 3D 模型: 支持从本地相册视频或拖入视频创建静态 Gaussian Splat .ply/.spz 模型 / Create static Gaussian Splat .ply/.spz models from local album videos or dropped video files
• 稳定重建路线: 通过 Nerfstudio/Splatfacto、COLMAP 和 ffmpeg/ffprobe 完成抽帧、位姿估计、高斯优化和导出 / Uses the stable Nerfstudio/Splatfacto, COLMAP, and ffmpeg/ffprobe route for frames, poses, Gaussian optimization, and export
• 模式与质量档: 支持自动、物品、环境模式，以及快速预览、高质量、极致和自定义参数 / Supports Auto, Object, and Environment modes, plus Quick Preview, High Quality, Extreme, and Custom settings
• 自定义长视频参数: 可按单次任务调整帧数、训练迭代、输入下采样、匹配方式和图像缓存 / Tune frame count, training iterations, input downscale, matching method, and image cache per task
• 任务阶段可见: 任务队列展示抽帧、位姿估计、高斯优化、导出、SPZ 压缩、耗时和实时进度入口 / The task queue shows frame extraction, pose estimation, optimization, export, SPZ compression, timing, and live progress links
• 模型图库集成: 生成结果进入现有模型图库，支持视频封面缩略图、原视频回看和视频模型预览方向适配 / Results appear in the existing model gallery with video-poster thumbnails, source-video replay, and viewer orientation adaptation

📦 Windows 完整便携包 / Windows Portable Bundles

• 新增视频重建完整包: 新增 cu128-rtx50-video-recon，包含视频重建运行时并面向 RTX 50 / CUDA 12.8 路线 / Added cu128-rtx50-video-recon with bundled video reconstruction runtime for the RTX 50 / CUDA 12.8 route
• 核心包保持独立: cu128-rtx50 和 cu126-mainstream 继续面向图片生成、模型浏览和图库等核心功能 / cu128-rtx50 and cu126-mainstream remain focused on core image generation, model viewing, and gallery features
• 校验方式明确: 每个完整包均提供 SHA256，下载后请先校验再解压运行 / Every portable bundle includes SHA256; verify it before extracting and running

🗂️ 图库与远程体验 / Gallery and Remote Experience

• 工作目录记忆相册: 相册配置按工作目录分桶保存，切换工作区后会恢复对应相册 / Album roots are remembered per workspace and restored when switching back
• 拖拽入口统一: 模型文件直接预览，图片进入 SHARP 生成，单个视频进入视频重建 / Unified drag-and-drop: models preview directly, images enter SHARP generation, and single videos enter reconstruction
• 局域网生成交互: 远程设备在允许生成时可取消图片和视频任务，上传阶段显示百分比进度 / Authorized LAN clients can cancel image and video tasks, with upload percentage shown before queue progress
• 门禁页面修复: 修复 PC 端访问门禁页背景和面板布局问题 / Fixed desktop access-gate background and panel layout

🐛 Bug 修复 / Bug Fixes

• 取消任务更可靠: 视频重建取消会终止相关外部进程并清理受控临时文件 / Video reconstruction cancellation now terminates related external processes and cleans controlled temporary files
• 训练进度更准确: 长时间高斯优化阶段会解析并显示更真实的训练进度 / Long Gaussian optimization stages now report more accurate training progress
• 视频匹配更稳: 质量档按策略选择匹配方式，并限制高帧数完整匹配导致的压力爆炸 / Quality presets choose matching strategies more safely and limit risky high-frame exhaustive matching
• 低相机数回退: 相机数量不足时回退采样策略，避免训练阶段断言崩溃 / Falls back to safer camera sampling when too few cameras are registered
• 大写图片清理: 删除模型时更好清理大写 .JPEG/.WEBP 等关联原图 / Model deletion now better cleans related uppercase .JPEG/.WEBP source images

🔧 技术改进 / Technical Improvements

• 依赖状态缓存: 视频重建依赖在后端启动后异步预热，打开首页或弹窗不再同步阻塞扫描 / Video reconstruction dependency status warms asynchronously after backend startup, avoiding blocking checks on home page or dialog open
• 测试覆盖增强: 补充 API、服务、安全、设置、任务队列、失败路径和视频重建参数校验测试 / Expanded tests cover APIs, services, security, settings, task queue, failure paths, and video reconstruction validation
• 文档同步完善: README 中英文补充视频重建流程、手动环境搭建、便携包选择和已验证平台说明 / Chinese and English READMEs now document video reconstruction, manual setup, portable bundle choices, and verified platform notes

🆕 近期重点更新 / Recent Highlights

• 本地媒体图库: 继续保留照片/视频混合浏览、视频预览、当前相册上传和按需索引能力 / The local media gallery keeps

🚀 v1.2.0

Sharp GUI 1.2.0 聚焦本地媒体图库、安全部署和后端架构升级。图库现在支持图片与视频混合浏览、当前相册上传、视频预览和懒加载索引，显著优化项目启动首屏加载时间；局域网访问进一步收紧文件暴露面；后端也完成完全重构模块化拆分，为后续维护和测试打下基础。

Sharp GUI 1.2.0 focuses on local media browsing, safer LAN deployment, and backend architecture improvements. The gallery now supports mixed photo/video browsing, uploading into the current album, video preview, and lazy indexing, Significantly improve the first-screen load time at project launch; LAN access is hardened; and the backend has been fully refactored and modularized for better maintenance and testing.

🖼️ 媒体图库升级 / Media Gallery Upgrade

• 图片与视频混合浏览: 本地图库支持照片和视频统一索引、筛选和浏览 / The local gallery now indexes, filters, and browses photos and videos together
• 本地视频预览: 支持视频 poster、Range 播放、下载、全屏、移动端精细拖动和失败降级 / Added video posters, range playback, download, fullscreen, precise mobile seeking, and fallback UI
• 当前相册上传: 可直接把图片上传到当前相册目录，支持文件选择和拖拽上传 / Upload photos directly into the current album with picker and drag-and-drop support
• 图库操作优化: 工具栏、筛选、移动端状态切换、视频控制栏和回到顶部按钮更顺手 / Improved toolbar, filters, mobile states, video controls, and back-to-top navigation
• 懒加载索引: 显著优化项目启动首屏加载时间，启动时不再等待完整图库扫描，进入相册后按需加载并显示扫描状态 / Startup no longer waits for full gallery scans; albums load on demand with scan status

🔐 局域网安全加固 / LAN Security Hardening

• 文件服务收敛: /files/* 只允许访问输出模型和允许的缓存文件，阻止配置、私钥、源码和路径逃逸 / /files/* is restricted to allowed outputs and cache files, blocking config, private keys, source files, and path escapes
• 调试模式默认关闭: 默认关闭 Flask debug，避免局域网部署时暴露堆栈和调试器 / Flask debug is off by default to avoid exposing stack traces and debugger surfaces on LAN
• 局域网绑定生效: 设置页的局域网绑定开关真正控制监听地址，重启后不再假生效 / The LAN bind setting now actually controls the listening address after restart
• 访问码安全提示: HTTP 明文访问时提示访问码传输风险，帮助用户正确部署 HTTPS / Plain HTTP access now warns about access-code transport risk and encourages HTTPS

🧱 后端完全重构与测试 / Backend Refactored & Tests

• 模块化后端: Flask 后端拆分为 app factory、routes、services、security、config、paths 等模块 / The Flask backend is split into app factory, routes, services, security, config, and paths modules
• 兼容旧入口: 保留 app.py 和原有启动方式，现有脚本和部署方式继续可用 / app.py and existing startup scripts remain compatible
• 自动化测试补强: 新增后端路由、安全、服务、API 契约、任务队列和图库边界测试 / Added backend tests for routes, security, services, API contracts, task queue, and gallery boundaries
• 发布包同步: Release 和 Windows 便携包流程已包含新的 backend/ 目录 / Release and Windows portable packaging now include the new backend/ directory

🎬 介绍视频与展示 / Intro Video & Presentation

• 视频节奏优化: 介绍视频 v11 将实时预览、多设备访问、图库和门禁场景前置 / Intro video v11 moves live preview, multi-device access, gallery, and access gate scenes earlier
• 加载体验优化: LOD 和 reveal 效果加载更快，减少重放黑屏等待 / LOD and reveal effects load faster with less black-screen waiting on replay

🐛 Bug 修复 / Bug Fixes

• 安卓 HDR 预览: 安卓 Chrome 预览 JPG 时降级为 SDR 安全预览，避免 HDR 解码导致闪屏或黑屏 / Android Chrome JPG preview now uses an SDR-safe preview to avoid HDR flicker or black screens
• 局域网重启绑定: 修复切换局域网访问后重启仍绑定旧地址的问题 / Fixed restart keeping the old bind address after LAN access changes
• 移动端图库工具栏: 修复移动端工具栏状态切换和上传后的刷新体验 / Fixed mobile toolbar state switching and refresh behavior after uploads
• 渲染特效加载: 优化高级特效起始时间、显现曲线和 LOD 切换后的重新加载 / Improved reveal timing, loading curve, and reload behavior after LOD changes

🔧 规范与维护 / Maintenance

• OpenSpec 同步能力: 新增 specs 同步工作流和 openspec-sync-specs skill / Added specs sync workflow and the openspec-sync-specs skill
• 发布规范完善: 补充 release note、便携包和提交规范要求 / Expanded release note, portable package, and commit message rules
• 项目文档更新: README、Agent 规则、测试规范和后端/前端规范已同步 / Updated README, Agent rules, testing guide, and backend/frontend documentation

📦 快速使用 / Quick Start

1. 下载 sharp-gui-v1.2.0.zip / Download the zip file
2. 解压后运行安装脚本 / Extract and run install script:
   • Linux/macOS: `./install.sh

🚀 v1.1.0

Sharp GUI 1.1.0 是 1.0 系列以来最大的一次更新。我们围绕"本地资产入口"做了两件大事：让 Sharp GUI 不只是 3D 生成器，也是一个轻量的本地照片图库；同时为局域网部署补上了可选的访问码门禁，让你放心把它开在家里和移动端连接使用。

This is the biggest update since 1.0. Sharp GUI now doubles as a lightweight local photo gallery, and ships an optional LAN access gate so you can safely keep it running on your home network.

🖼️ 本地照片图库 / Local Photo Album Gallery

把电脑、移动硬盘、挂载盘或 NAS 目录配置成相册，在浏览器中浏览、预览原图、下载，并一键送进 3D 生成队列。

Configure folders as albums, browse them in the browser, preview originals, download, and send any photo straight into the 3D pipeline.

• 多目录相册 / Multi-folder albums：每个配置目录作为一个相册，封面自动取首图或最近照片 / Each configured folder becomes an album with an auto-picked cover
• 瀑布流浏览 / Masonry grid：响应式列数 + 懒加载 + 缩略图缓存，千张照片也能顺滑滚动 / Responsive masonry with lazy load and thumbnail caching, smooth even with 1k+ photos
• 列数密度调节 / Density slider：桌面下拉滑块、移动端双指捏合，任意切换 1-8 列 / Slider on desktop, pinch on mobile, 1–8 columns
• 多种排序 / Flexible sorting：修改时间、创建时间、文件名、文件大小，升降序自由切换 / Sort by mtime / ctime / name / size, ascending or descending
• 原图预览 / Full-resolution viewer：预览层始终加载原图而非缩略图，支持上一张/下一张、下载、生成 3D / Lightbox always loads originals, with prev/next, download, and convert to 3D
• 批量转 3D / Batch convert to 3D：多选若干照片，一键加入生成队列，复用现有任务流和模型图库 / Multi-select photos and queue them all for 3D generation
• 移动端操作栏 / Mobile action bar：浮动操作栏 + 批量下载，触控尺寸友好 / Floating action bar with batch download, sized for touch
• 跨平台路径安全 / Cross-platform path safety：Windows、Linux、macOS 统一路径归一化与目录边界校验，杜绝相册外访问 / Unified path normalization and root checks across OSes

🔐 可选局域网门禁 / Optional LAN Access Control

部署在局域网时，默认任何同网段设备都能直接访问图片和模型——这次给你一道可选的轻量门禁。

When you expose Sharp GUI on the LAN, anyone on the same network can reach your photos and models. This release adds an optional, lightweight gate.

• 一道访问码 / One access code：远程设备首次访问需要输入访问码，解锁后通过 HttpOnly Cookie 持续浏览 / Remote devices unlock with a single access code, persisted via an HttpOnly cookie
• localhost 免登录 / Local owner bypass：本机始终是 owner，日常使用不被打扰 / The local machine is always the owner and skips the gate
• 管理操作仍限 owner / Admin actions stay local：设置、目录管理、删除、重启、批量转换等高风险操作只允许本机执行 / Settings, folder management, deletion, restart and batch ops remain local-only
• 远程生成开关 / Remote generation toggle：默认关闭；显式开启后已解锁的远程设备才能提交生成任务 / Off by default; remote devices can submit generation jobs only after you explicitly allow it
• 会话可撤销 / Session revoke：一键让所有远程设备的旧会话失效，可配置会话有效期 / One click revokes every remote session; session length is configurable
• 抗暴力猜测 / Brute-force resistance：登录失败按客户端递增延迟，避免短访问码被快速猜中 / Failed logins back off per client to deter weak-code guessing
• 抗 DNS rebinding / Origin hardening：Host 允许列表 + 真实连接地址校验，不信任 X-Forwarded-For 提升 owner 权限 / Host allowlist and trusted-origin checks, never trusting forwarded headers for owner privilege
• HTTPS 提醒 / HTTPS reminder：UI 与 README 明确说明门禁不替代传输加密，建议局域网启用 HTTPS / The UI and README make clear the gate is not a substitute for transport encryption

门禁默认关闭，旧 config.json 无需迁移；本机首次启动会温和提醒一次，可选"稍后"或"不再提示"。 / The gate is off by default; existing config.json files keep working unchanged.

🎬 介绍视频与文档 / Intro Video & Docs

• HyperFrames 介绍视频工程 / HyperFrames intro project：新增视频源工程、ElevenLabs v9 中文旁白脚本与高码率渲染脚本 / Added video project sources, ElevenLabs v9 narration script and high-bitrate render scripts
• README 同步 / README sync：补充本地照片图库与局域网门禁说明，更新中英文使用指引 / Documented the new gallery and access gate in both Chinese and English READMEs
• OpenSpec 归档 / OpenSpec archives：add-local-photo-album-gallery、add-lan-access-control 完成实现并归档 / Both OpenSpec changes are implemented and archived

🔧 体验改进 / Improvements

• 跨平台 Verbose 日志 / Cross-platform verbose logging：新增 run_verbose.bat / run_verbose.sh，反馈问题时可直接生成 sharp-gui-verbose.log / New verbose entry points generate sharp-gui-verbose.log for issue reports
• **便携