Jasna 上手全解：视频马赛克修复的免费安装、配置与排错-平芜编程栈

Jasna 上手全解：视频马赛克修复的免费安装、配置与排错

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

Jasna 是一款免费的视频马赛克修复工具，专门解决"想把视频里的马赛克去掉、拿回干净片源"这件事。它提供图形界面（GUI）和命令行两种形态：前者拖个文件就能跑，后者适合批量处理。

关键点在运行位置：从解码视频、找出马赛克、重建画面到最终编码，整条流水线全部跑在你的 GPU 上，不靠 CPU 硬扛。这篇文章把硬件兼容性判断、安装步骤、首跑排错、性能数据和完整文档索引一次讲完，跟着走就能从下载走到第一次出片。

装之前先看这张表，对号入座：

项目	速判结论
支持的显卡	NVIDIA GTX 16 系列 / RTX 20 系列及更新（计算能力 7.5 及以上）
明确跑不了	GTX 10 系列及更早，1050 / 1060 / 1070 / 1080 均不支持
NVIDIA 驱动	Windows 需 610 或更新；Linux 需 580 或更新
AMD 特殊路径	实验性支持，需 ROCm 兼容硬件：Radeon RX 7000 / 9000、Radeon 780M / 760M / 740M、Ryzen AI 核显；Windows 需 Adrenalin 驱动 26.8.1 或更高
路径与磁盘	安装文件夹只能含英文字母和数字，路径不能出现中文、日文或带重音的字符；只支持本地磁盘（Windows 用 NTFS，Linux 用 ext4 / Btrfs / XFS / ZFS），网络磁盘不行

两项自动化设计帮你省下配置麻烦：

另外每个设置项旁边都有 ⓘ 图标，鼠标悬停就能看到解释，不用猜。

检测—— 内置的rfdetr-v6模型逐帧扫描，找出马赛克坐标；也可以换更大的rfdetr-v6-large或 YOLO 系模型，检测阈值可按视频单独调整
修复—— GPU 模型只重建马赛克盖住的部分，生成 256×256 的小图贴回原画面，其余像素原封不动。片段（一组一起处理的连续帧）之间做时间重叠加交叉淡化（逐帧渐变过渡），减少接缝闪烁；同时检测硬切镜头（画面突然切换），在切换点结束跟踪，避免把前后两个镜头的画面混在一起
编码—— 修复后的帧经 GPU 编码器（NVIDIA 用 NVENC，AMD 用 AMF）写入 MP4 / MKV 等容器，音频直接拷贝；界面实时显示进度、FPS 和剩余时间

下载：选与操作系统、GPU 厂商匹配的发行包
解压：放到只含英文字母和数字的文件夹，路径里出现非英文字符会出问题
启动：Windows 双击jasna.exe；Linux（NVIDIA）运行jasna文件；Linux（AMD）需先装一次 AMF 视频运行库，再运行run_jasna_amd.sh
加文件：把视频或图像拖进队列，选好设置，点 ▶ 按钮开始马赛克修复

习惯命令行的话，这两条最小示例就够用：

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

全部参数见 CLI 参考。

第一次启动通常要15–60 分钟（NVIDIA）：Jasna 在为你这块具体 GPU 准备模型文件，这一步只做一次，结果缓存在model_weights文件夹，之后每次启动直接复用。升级版本时把这个文件夹整体复制过去，就不用再等。AMD 的首次准备快得多
跑任务时把其他程序关掉：浏览器这类应用会悄悄占用显存，挤占修复流水线的空间；模型准备期间最好完全别碰电脑
显存报错了就把"最大片段大小"调低，例如从90降到60，多数情况立刻见效；4–6 GB 显存的显卡跑 1080p 可以从30起步

官方基准环境：Linux + RTX 5090 + i9-13900K，用默认的 BasicVSR++ 模型修复一段长 3 分 22 秒的视频。

输入	Lada 0.11.0	Jasna v0.9.1	相对加速
720p H.264 8-bit	01:47	00:32	约 3.4 倍
1080p H.264 8-bit	02:02	00:34	约 3.6 倍
2160p H.264 8-bit	04:56	01:03	约 4.7 倍

显存同样省了不少：1080p 场景下 v0.9.1 峰值约 5.6 GB，早期版本 v0.4.1 约 21.4 GB，新版只占四分之一左右。完整对比数据见 benchmarks/2026-07-26_release_matrix.md。

Jasna 收费吗？

工具本身完全免费，视频马赛克修复不用花一分钱。unet-4x、SD 1.5、LTX 这几个附加模型需要支持者密钥，只在官方渠道出售；其他卖家都是骗子，密钥用不了，文件还可能带隐藏代码。

没有 NVIDIA 显卡能用吗？

可以，走实验性的 AMD ROCm 路径，需要 RX 7000 / 9000 等较新的卡。注意两点：二级修复暂不支持，LTX 也只在部分 Linux 显卡上可用。

输出会覆盖原文件吗？

不会。输出位置默认可设为"与输入相同"，即写到原文件旁边；文件名冲突时默认自动重命名，也可以改成覆盖或跳过。

主题	文档
GUI 使用（队列、预设、播放器、激活）	docs/zh/gui.md
检测 / 修复 / 二次模型选择	docs/zh/models.md
区间编辑器与局部修复	docs/zh/segments.md
VR180 视频处理	docs/zh/vr180.md
显存与 GPU 调优	docs/zh/tuning.md
流媒体输出（浏览器 / Stash）	docs/zh/streaming.md
命令行完整参考	docs/zh/cli.md
高级后处理	docs/zh/advanced_processing.md