Jasna 工具集

Jasna 能做什么

Jasna 用于恢复视频和图像中的马赛克区域，仅修改检测到的马赛克部分，画面其余内容保持原样。提供两种恢复模型：免费的 BasicVSR++（速度较快）和仅向支持者提供的 LTX（仅 NVIDIA，细节更丰富但速度较慢）。还可通过 Segment Editor 仅恢复指定区域并查看预览，支持 VR180 视频与静态图像（SD 1.5，仅支持者）。Video Player 支持实时观看恢复结果而无需先生成文件。

硬件与运行要求

• NVIDIA：GTX 16 系列 / RTX 20 系列及更新显卡，Windows 驱动 610+、Linux 驱动 580+；GTX 10 系列及更旧型号不支持。计算能力需 ≥ 7.5。
• AMD：Radeon RX 7000/9000 等 ROCm 支持显卡（实验性）；Windows 需 Adrenalin 26.8.1+；辅助恢复与 LTX 仅限 NVIDIA。
• 存储：工作目录所在路径不得包含中文、日文、重音字符等非英文字符；Windows 需 NTFS，Linux 需 ext4/Btrfs/XFS/ZFS；不支持网络盘；SSD 体验更佳。
• LTX 额外要求：NVIDIA RTX，至少 8 GB 显存与 16 GB 内存。

快速开始

1. 下载对应系统与 GPU 的发行版。
2. 解压至纯英文路径目录。
3. 启动应用： - Windows：双击 jasna.exe - Linux（NVIDIA）：执行 jasna - Linux（AMD）：执行 run_jasna_amd.sh
4. 添加视频、调整设置并点击底部 ▶ 按钮开始。

首次任务耗时较长，NVIDIA 用户需为当前 GPU 编译模型（约 15–60 分钟，仅一次）。升级时复制 model_weights 目录到新版本可避免重复编译。显存不足时可降低 Max Clip Size（如从 90 调至 60）。每个设置项均有 ⓘ 提示。

工作流程

GPU 全程参与处理：解码 → 检测 → 跟踪并按场景切分剪辑 → BasicVSR++ 恢复 → 可选二次升清（UNet 4x / RTX Super Res / Topaz TVAI） → 合成回原帧 → 编码（音频默认直接复制）。剪辑间略有重叠以避免跳变。LTX 采用 4 遍处理（检测、准备、扩散恢复、保存），细节更佳但更慢。

命令行用法

# 处理单个视频
jasna --input input.mp4 --output output.mkv

# 处理单个图像
jasna --input photo.png --output restored.png

# 处理整个目录
jasna --input input_folder --output output_folder

jasna --help 查看完整选项，详见 CLI 参考文档。

支持者模型

每个 License 码可在 3 台设备上激活，激活后可离线使用。建议先用 Trial mode 测试 LTX 在本地 GPU 上的运行速度。

性能基准

RTX 5090（Linux）下完整恢复一段 3:22 视频的耗时：

显存占用典型值：720p 约 4.2 GB、1080p 约 4.8 GB、2160p 约 7.2 GB。

许可证

应用源代码采用 AGPL-3.0；模型与依赖项保留各自许可条款。

致谢

• Lada：Jasna 受其启发并在部分实现上基于其代码；mosaic_restoration_1.2 模型由 ladaapp 训练。
• ZeLeFans：提供 VR 检测模型及马赛克形状与 VR 投影的分析支持。