Jasna 视频马赛克修复 GPU 入门与进阶指南：从硬件自检到只修局部

【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna

Jasna 是一款免费的 GPU 视频马赛克修复工具：AI 定位画面中的马赛克区域，用模型重建被遮挡的部分，其余画面原样保留，最后输出干净的成片。全文先回答"我的电脑能不能跑"，再带你装出第一个成片，最后覆盖局部修复、二级增强、VR180、实时预览和编码后处理这些进阶能力。

一页快判：你的硬件在不在门槛线内

先说结论：NVIDIA 主流卡基本都能跑，AMD 只有最新一代能用且是实验性质，更老的卡没有软件层面的绕行办法。

首次启动的自检和两个常见死因

每个版本第一次启动时，Jasna 会逐项核对 FFprobe、GPU、驱动和安装路径，AMD 上还会额外检查 AMF 视频运行库。更新驱动后可从页眉手动重跑一次。

自检不通过基本就两类原因：

从下载包到第一个成片的最短路径

按系统和显卡厂商选对发行包，然后四步走完：

1. 下载：选择与你的操作系统和显卡厂商匹配的发行包。
2. 解压：目标路径只含英文字母和数字。
3. 启动：Windows 双击jasna.exe；Linux NVIDIA 直接运行jasna文件；Linux AMD 先装好 AMF 运行库，再运行run_jasna_amd.sh。
4. 开跑：把视频拖进队列，按需调整设置，点界面底部的▶。

界面里每个设置旁边都有 ⓘ 图标，悬停即可看到解释，新手不需要翻文档。

第一次任务为什么要等 15–60 分钟

NVIDIA 上 Jasna 会先为你的显卡编译检测模型和修复模型（TensorRT 引擎），大约15–60 分钟，全程请关掉其他应用、别动电脑。这个过程只发生一次：编译结果缓存在model_weights目录，之后的任务直接复用。升级版本时把这个文件夹复制到新版目录里，就不用再等。

习惯命令行的人可以跳过 GUI。除了视频播放器、LTX 种子预览、遮罩建议和交互式图片处理，应用能做的事 CLI 都能做：

# 单个视频 jasna --input input.mp4 --output output.mkv # 整个文件夹 jasna --input input_folder --output output_folder

完整参数列表见jasna --help与 docs/zh/cli.md。

一次完整修复在 GPU 上走过的六步

读视频到存文件，数据几乎全程不离开显存——解码和编码都在 GPU 上做，这是它快且稳的原因。

二级修复插在"修复"与"融合"之间。LTX 走的是另一套流程：对视频过四遍（找马赛克、准备、扩散修复、保存），更慢但能补更多细节，见 docs/zh/models.md。

显存不够时的退路顺序

显存放不下时，Jasna 会先把等待中的帧挪到系统内存借用，需要时再移回，全程无需任何设置。自动退路不够用时，按这个顺序手动降：先把最大片段大小调小（如90降到60；4–6 GB 显存的卡跑 1080p 建议从30起步），再关掉二级修复或换更轻的，最后关掉占用 GPU 的浏览器和游戏。更多调优细节见 docs/zh/tuning.md。

进阶功能清单

🎬 局部区间修复：不重跑整段

是什么：只修含马赛克的区间，其余部分原样复制进输出——既快，又保住未修复部分的原始画质。

入口：点队列项上的剪刀按钮打开区间编辑器，可按帧精确选择范围；不选任何区间则等价于修整段。内置马赛克扫描能快速定位含马赛克的片段，RTX 5090 上约 2,000 FPS，扫描结果可一键批量加为待修区间，配合缩放平移逐个检查。检测模型和置信度阈值按每个视频单独记忆，不影响队列里其他视频。CLI 等价写法：

jasna --input input.mp4 --output output.mp4 --segments "10-25,01:10-01:30.5"

限制：NVIDIA 和 AMD 都支持；一次一个视频，不支持文件夹、图片或流媒体输入；输入需为恒定帧率的 H.264/HEVC/AV1。详见 docs/zh/segments.md。

✨ 二级修复：让 256x256 的重建更锐利

是什么：BasicVSR++ 每块马赛克只修成 256x256，在大马赛克、特写和 4K 上容易偏软。二级模型先把这块图放大到 512x512 或 1024x1024 再放回画面。注意：仅支持 NVIDIA。

入口：CLI 用--secondary-restoration unet-4x指定。限制：使用 LTX 时二级修复和降噪自动关闭。

VR180 与静态图片：两条独立管线

VR180：左右并排视频会被拆开，逐眼分别修复再拼回。保持自动模式即可——高度超过 1080 像素的 2:1 视频（如 3840x1920、8192x4096）会被识别为 VR，并按片商自动选择修复前的展平方式（原始 / 鱼眼 / 球心投影），未知片商默认"原始"。内置rfdetr-vr-v1检测模型最适合 VR；区间编辑器的修复预览里可逐个尝试投影方式再应用。限制：LTX 不支持左右并排 VR180。详见 docs/zh/vr180.md。

静态图片：走另一个实验性的 SD 1.5 模型，支持者专享，模型约6.9 GB、首次使用时下载，需约7 GB 显存。图片加入队列即自动识别，无需切换设置。GUI 里的"交互式处理图片"提供左右对比视图，可逐张浏览、换种子、对比原图/遮罩/结果，只保存满意的变体。

👀 边修边看：内置播放器与流媒体

是什么：不用等整个文件修完就能看效果，适合快速验证设置。

内置播放器：选择视频直接播放，画面实时修复实时上看。快捷键：空格暂停/播放，左右方向键跳转 30 秒，支持全屏。固定使用 BasicVSR++，且只有在队列和修复预览都没运行时才能打开。

流媒体输出：加--stream参数启动 HLS 串流（Windows 上即jasna.exe --stream），自动打开浏览器播放器，支持跳转；端口默认8765，--no-browser可自己打开。固定使用 BasicVSR++ 和 H.264，不支持 LTX。另有定制 Stash 分支，播放场景时边看边修。详见 docs/zh/streaming.md。

编码阶段的后处理开关

是什么：编码环节内置一组开关，省得修完再开别的工具处理一遍。

• 降噪：只清理修复区域，从low起步，--denoise low|medium|high。
• 60→30 FPS 导出：--retarget-high-fps，工作量减半，音频和速度保持正确；不能与区间或流媒体同用。
• 色彩 LUT / 锐化：--lut path.cube调色、--sharpen 0.5锐化边缘，都在写视频时应用，开销很小。
• 质量：--cq控制质量，数值越低质量越好、文件越大；--encoder-settings设码率上限等。
• 导出后操作：队列完成后可关机或跑自定义命令，如--post-export-action shutdown。

全部选项及取值范围见 docs/zh/advanced_processing.md。

官方基准：对 RTXX 5090 环境的速度与显存预期

测试条件：RTX 5090 + Linux，用 BasicVSR++ 修复一整段 3:22 视频。Jasna v0.9.1 相对 Lada 0.11.0 快 3.4–4.7 倍：

显存占用（典型 / 峰值，GB），v0.9.1 与早期 v0.4.1 对比——1080p 峰值从约 21.4 GB 降到约 5.6 GB：

全部编解码器数据、旧版本对比和测试方法见 benchmarks/2026-07-26_release_matrix.md。

常见问答与资料索引

资料索引

• 入门：docs/zh/gui.md（GUI 使用）、docs/zh/cli.md（CLI 完整参考）、docs/en/development.md（从源码运行）
• 模型与修复：docs/zh/models.md（检测 / 修复 / 二级 / SD 1.5）、docs/zh/segments.md（区间与局部修复）、docs/zh/vr180.md（VR180）
• 性能与输出：docs/zh/tuning.md（显存调优）、docs/zh/streaming.md（流媒体）、docs/zh/advanced_processing.md（降噪 / LUT / 锐化 / 导出后操作）、docs/zh/cloud.md（云 GPU）
• 许可：公开应用源码采用 AGPL-3.0，模型和捆绑依赖保留各自条款，见 LICENSING.md 与 assets/THIRD_PARTY_MODELS.md

【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna