Jasna 视频马赛克修复实战指南：首跑要等多久、四步跑通、只修指定时间段

Jasna 视频马赛克修复实战指南首跑要等多久、四步跑通、只修指定时间段【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是视频马赛克修复工具逐帧定位马赛克AI 只重绘马赛克区域其余像素逐字节保留。RTX 5090 上修复一段 3 分 22 秒的 1080p 视频只要 34 秒比同类工具 Lada 快 3.6 倍解码到编码全程在 GPU 上完成。代价是首跑要为你的显卡编译模型、等待 15–60 分钟。本文按先跑起来、再搞懂、后调优的顺序展开最短启动路径 → 首跑等待的来龙去脉 → 四步工作流 → 只修指定时间段 → 环境自查表 → 显存与速度调优。最短路径跑通一条命令级预检加四步装好动手前 30 秒预检NVIDIA GTX 16 / RTX 20 系列或更新CUDA compute capability 7.5驱动 Windows 610 / Linux 580安装目录在本地磁盘且路径纯英文。AMD RX 7000/9000 可用但属实验性且二次修复与 LTX 仅限 NVIDIA。下载与你系统、GPU 匹配的官方 release 版本解压到一个路径中没有任何非英文字符的文件夹——路径含中文、日文、带重音字符会在启动检查阶段直接报错这是新手最常踩的坑启动Windows 双击jasna.exeLinux NVIDIA 运行jasna文件添加视频、点▶。第一个任务会慢得反常——正常下文专门解释# 解压完成后在 Jasna 目录下启动Windows: 双击 jasna.exe ./jasna # Linux NVIDIA ./run_jasna_amd.sh # Linux AMD需先安装一次 AMF 视频运行库首次任务的等待时间15–60 分钟编译只等一次新手最容易在这一步放弃所以单独说清楚。NVIDIA 上 Jasna 会用 TensorRT 为你的具体型号GPU 编译检测模型和修复模型大约 15–60 分钟且只做这一次。这期间编译和推理抢 GPU建议关掉其他应用、别动这台电脑。编译产物存在model_weights/目录之后的任务直接复用速度立刻回到正常水平升级 Jasna 时把旧版model_weights文件夹拷进新版可免去二次等待AMD 走 ROCm 路线不编译所以没有这段等待——代价是也没有编译带来的加速启动窗口会先跑一次系统检查FFprobe、GPU、驱动、安装路径主窗口打开前多等一会儿也是正常的如果之后要使用 LTX第一次开任务还会先下载模型标准画质约 15 GB良好/高/顶级画质每个再加约 13 GB这是一笔额外等待。核心工作流四步从导入到导出每步默认值都能直接用导入点添加文件或文件夹图标也可把视频直接拖进队列。每个视频项上三个按钮剪刀打开区间编辑器、播放打开视频播放器、三点菜单打开所在文件夹等。调检测默认模型rfdetr-v6--detection-score-threshold默认0.35—— 决定什么样的检测算数误检多就调高、漏检就调低。这套设置按视频单独保存队列里其他视频各自保留自己的参数。选修复默认 BasicVSR免费把每个马赛克片段重建成 256×256 的画面。需要更锐利可挂 UNet 4x、RTX Super Res 或 Topaz TVAI 做二次放大仅限 NVIDIA。点▶开跑想先看不落盘可用视频播放器实时边修复边看——它固定使用 BasicVSR不用 LTX。导出设输出目录、文件名模板文件冲突三选一自动重命名为默认/覆盖/跳过--cq控制编码质量数值越低质量越好、文件越大不设置时用 GPU/编解码器默认值。编码走 NVENC/AMF音频流直接复制省一道转码。这四个动作背后是 pipeline 实现 里的直线流程GPU 解码 → 逐帧检测 → 按镜头分组跟踪 → 每个片段独立修复 → 用遮罩 blend 回原帧 → GPU 编码。最后一步是其余画面原封不动的工程保证重建结果只替换马赛克区域帧上其他像素保持原值。只修复指定时间段先扫描出区间再让没马赛克的部分直接复制整片只有几段有马赛克时全片跑修复就是浪费算力。点队列项上的剪刀按钮打开区间编辑器马赛克扫描选检测模型和检查频率每帧最准或每 0.25–2 秒更快。RTX 5090 上扫描约 2,000 FPS几分钟的视频几秒扫完结果在时间线上显示为琥珀色区间点添加全部 N 个区间一键转成待修复区间--detection-score-threshold滑块决定哪些算数配合在预览中显示遮罩红框标出每处马赛克的大小最长边占画面高度百分比误检漏检一眼可见BasicVSR 区间立即出预览LTX 区间要先点渲染 LTX 种子通常几分钟可换种子对比再选定# 只修复 10-25 秒和 01:10-01:30.5 两个区间其余部分直接复制 jasna --input input.mp4 --output output.mp4 --segments 10-25,01:10-01:30.5 # 全文件夹扫描后大马赛克(占画面高度 12% 以上)用 LTX其余用 BasicVSR jasna --input videos/ --output restored/ --restoration-model-name ltx --ltx-auto-split 12代价要心里有数选了区间后输出保留源视频的编解码器--codec/--cq不生效区间前后几秒会重新编码但不修复因为视频只能在特定帧位置切开BasicVSR 区间和 LTX 区间之间要留距离太近会收到提示。扫描与自动分段的逻辑在 mosaic_scan 实现scan_sample_stride()按时间间隔抽样segments_from_scores()把超阈值的样本合并成带 padding 的规范化区间ltx_auto_segments()再把大马赛克区间分给 LTX——让最慢的模型只花在最值得的地方。环境自查与排错一张表回查全部硬件门槛前面步骤卡住时按这张表回查。门槛要求不达标会发生什么NVIDIA 显卡GTX 16 / RTX 20 系列或更新compute capability 7.5GTX 10 系列及更早不支持GPU 初始化阶段直接报错退出驱动Windows 610Linux 580版本不足时任务在 GPU 初始化阶段报错更新后可从页眉重跑系统检查AMD 显卡RX 7000/9000ROCmWindows 需 Adrenalin 26.8.1实验性无模型编译加速且 LTX 与二次修复UNet 4x/RTX Super Res/TVAI不可用磁盘与路径本地磁盘NTFS / ext4 / Btrfs / XFS / ZFS路径纯英文路径含中文、日文、重音字符会在启动检查阶段报错网络盘不支持机械盘可用但启动和加载模型很慢启动时给出警告LTX 附加门槛NVIDIA RTX至少 8 GB 显存 16 GB 系统内存无许可证时 CLI 报错停止GUI 改为只提供试用模式显存不足会把模型的一部分放进系统内存速度明显变慢排错第一步永远是底部工具条的Logs→Export保存日志最后 5000 行它比口述现象有用得多。显存与速度调优片段越大越快但 180 帧后只涨显存BasicVSR 相关的四个旋钮参数默认值作用--max-clip-size90一次一起修复多少帧越大越稳、越快也越占显存--temporal-overlap8相邻片段共享的帧数消除接缝闪烁8–20效果好必须小于片段大小的一半--enable-crossfade开启片段边界交叉淡化复用已处理好的帧无额外 GPU 开销保持开启--detection-score-threshold0.35检测阈值误检调高、漏检调低--max-detection-gap2同一位置最多填补 2 帧的检测中断0禁用--min-detection-duration默认2丢弃短于 2 帧的误检--scene-detection默认开保证片段不跨硬切镜头实测1080p、重叠 8、RTX 5090摘自调优文档--max-clip-size耗时显存3051 秒3.4 GB6040 秒3.7 GB9034 秒4.1 GB18035 秒5.0 GB36032 秒6.3 GB72033 秒8.0 GB两条反直觉结论片段越小越慢——重叠帧在每个片段里都要重算一遍片段越多重复工作越多超过 180 帧后耗时不再变好只有显存在涨4K 视频约需 1.5 倍显存。所以原则是显存放得下就用尽量大的片段。4–6 GB 显存的卡处理 1080p 从片段大小 30 起步。另一条不要为了省显存关编译。同一段 1080p、片段 180编译默认33 秒 / 5.0 GB不编译--no-compile-basicvsrpp107 秒 / 4.6 GB——慢约 3 倍却只省 0.4 GB不划算。爆显存时按顺序处理降片段大小 → 关闭或换更轻的二次修复 → 关掉抢 GPU 的应用。一句话带走Jasna 视频马赛克修复的心法只有一句修复范围等于马赛克范围其余字节保持原样——硬件达标、装到本地英文路径、首任务等 15–60 分钟编译落盘并保留model_weights之后每个视频导入 → 扫描 → 加区间 → 预览 → ▶参数卡住时先动检测阈值和片段大小。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考