Jasna 完整指南：免费自动检测并修复视频马赛克，从环境自查到首次出片

Jasna 完整指南：免费自动检测并修复视频马赛克，从环境自查到首次出片

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

Jasna 是一款免费的视频马赛克修复工具，图形界面和命令行两种形态都有，检测、修复、编码整条链路都跑在你自己的显卡上。它的任务很单一：自动找出画面里的马赛克区域，把被遮住的原始画面重建出来。如果你有一张较新的 N 卡（或受支持的 A 卡），想在本地批量处理视频，这篇指南覆盖环境检查、安装、原理和调优的全部必要信息。

先花一分钟自查硬件 🖥️

项目	要求
NVIDIA 显卡	GTX 16 系列及以后、RTX 20 系列及以后，计算能力 7.5 起步；GTX 10 系列（1050 / 1060 / 1070 / 1080）明确不可用
NVIDIA 驱动	Windows 上 610 或更新；Linux 上 580 或更新
AMD 显卡	实验性路径，依赖 ROCm 生态，需 RX 7000 / 9000、Radeon 780M / 760M / 740M、Ryzen AI 核显这类硬件
AMD 驱动	Windows 需 Adrenalin 26.8.1 或更高版本
安装路径	所在文件夹只能出现英文字母和数字

对照不上表怎么办：N 卡太老（10 系及以下）没有绕过办法，只能换硬件或租用云 GPU；A 卡能跑但属实验性支持，且后文提到的二级修复用不了。

有两处自动化设计值得知道：显存不够时，排队等待的帧会自动临时搬到系统内存里，腾出来再搬回去，全程无需手动干预；每个版本首次启动会自动检查 GPU、驱动、内存和安装路径，升级驱动后也可以随时手动重跑一次。

怎么装好并跑通第一条命令

最短路径四步：

1. 下载与你系统、显卡厂商匹配的发行包
2. 解压到一个只含英文字母和数字的文件夹
3. Windows 双击 jasna.exe；Linux + NVIDIA 运行 jasna 文件；Linux + AMD 运行 run_jasna_amd.sh
4. 把视频或图片拖进窗口，选好设置，开始处理

GUI 里每个设置旁都有 ⓘ 图标，悬停就能看到解释。习惯命令行的人，最短可用形态就是一行（整文件夹批处理把 --input / --output 指向两个目录即可）：

jasna --input input.mp4 --output output.mkv

全部参数在 docs/zh/cli.md 里。

一次处理里实际发生了什么

按下开始后，流水线分三段接力。第一段是检测：默认用速度更快的 rfdetr-v6 模型逐帧定位马赛克坐标，也可以换成更大的 RF-DETR 变体，或 Lada、ZeLeFans 提供的 YOLO 模型。第二段是修复：GPU 修复模型逐帧重建被遮住的区域；由于视频被切成多个片段处理，相邻片段之间靠 temporal overlap（让相邻片段重叠过渡）和 crossfade（逐帧渐变衔接）抹平拼接处的闪烁，同时硬切镜头（scene cut）会被自动识别，切换点直接结束正在跟踪的片段，防止切换前后的两个镜头混在一处。第三段是编码：修复后的画面写回 MP4 / MKV 等标准容器，进度、FPS 和预计剩余时间在界面上实时更新。

视频修复之外还能做什么

能力	说明	限制 / 备注
静态图像修复	用 SD 1.5 修复模型处理照片，附交互式模式：左右对比、换种子、原图 / 蒙版 / 结果三方对照，只保存满意的版本	实验性功能；模型需支持者密钥解锁
VR180 处理	并排格式 VR180 视频逐眼处理，按片商自动选修复方式，区间编辑器内可预览效果	详见 docs/zh/vr180.md
二级修复	主修复之后叠加 unet-4x、RTX Super Resolution 或 Topaz Video AI 再锐化一层，适合大面积马赛克、特写和 4K	仅 NVIDIA；AMD 暂不支持；选择依据见 docs/zh/models.md
区间编辑器	按帧指定只修复某段，内置马赛克扫描快速定位目标区间，预览支持缩放 / 平移；检测模型和置信度按视频单独记忆	NVIDIA / AMD 均支持；详见 docs/zh/segments.md
内置播放器与流媒体	免生成输出文件即可全屏看修复画面、自由跳转；也可串流到内置浏览器播放器或受支持的 Stash 分支	详见 docs/zh/streaming.md
高级后处理	降噪、60→30 FPS 导出、色彩 LUT、锐化、按编解码器自定义 CQ 质量、自定义编码器设置、队列级或逐视频的导出后操作	详见 docs/zh/advanced_processing.md

速度和显存：数据说话 ⚡

测试环境为 Linux + RTX 5090 + i9-13900K，素材是一段 3 分 22 秒的视频，与 Lada 0.11.0 对比：

输入	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 GiB，早期版本在 21 GiB 上下，差距约四倍。完整测量数据见 benchmarks/2026-07-26_release_matrix.md。

动手之前，先把这几个问题想清楚 🚨

第一次跑为什么这么慢？ Jasna 需要为你的具体显卡编译专用文件，NVIDIA 上大约 15–60 分钟，只做这一次。产物写入 model_weights 目录，之后的启动直接命中缓存；升级版本时把这个目录拷进新版即可免等。AMD 上这一步快得多。

显存不够、运行卡顿怎么办？ 两个动作：先把浏览器这类吃显存的应用关掉，给流水线让出空间；仍然不够，就把"最大片段大小"从 180 调到 60，更多手段见 docs/zh/tuning.md。

A 卡到底能不能用？ 走实验性的 ROCm 路径可以，门槛是 RX 7000 / 9000 这类较新硬件，代价是二级修复暂不可用。

工具收费吗，密钥是干什么的？ 基础功能完全免费。支持者密钥用于解锁 unet-4x 二级放大和 SD 1.5 图像修复两个额外模型，只能从官方渠道购买——其他卖家的密钥是骗子，其文件还可能携带隐藏代码。

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

延伸阅读

主题	文档
GUI 使用指南	docs/zh/gui.md
模型选择（检测 / 二级修复 / SD 1.5）	docs/zh/models.md
区间编辑器与局部修复	docs/zh/segments.md
VR180 视频处理	docs/zh/vr180.md
显存与 GPU 调优	docs/zh/tuning.md
流媒体输出	docs/zh/streaming.md
命令行完整参考	docs/zh/cli.md
从源码运行（开发者）	docs/en/development.md

Jasna 的公开应用源码采用 AGPL-3.0 许可，许可证细节与第三方模型说明见 LICENSING.md 和 assets/THIRD_PARTY_MODELS.md。

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