Jasna 命令行实战教程从修复单个视频到整文件夹挂机批量处理【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 的命令行CLI与图形界面功能完全等价Windows 上两者是同一个jasna.exeLinux 上则是jasna脚本。本文不按参数类别罗列而是按你的目标来组织先让单个视频修好再把整文件夹批量处理跑起来最后配置流媒体边修边看、修完自动关机等无人值守玩法文末附按场景重新分组的参数清单。所有选项都可以用jasna --help实时查看。先让一个视频修好最省事的起点是单文件修复只需要输入和输出两个参数jasna --input input.mp4 --output output.mkv这条命令默认走basicvsrpp修复模型、rfdetr-v6检测模型和 HEVC 编码绝大多数视频不加任何额外参数就能得到合理结果。如果输入是静态图片Jasna 会自动改走sd-15-jav图像修复模型不需要你手动切换jasna --input photo.png --output restored.png⚠️ 首次运行明显偏慢Jasna 要为你的显卡构建 TensorRT 引擎等专用文件NVIDIA 显卡通常需要 15–60 分钟。产物缓存在model_weights/目录之后每次运行都会直接复用请耐心等待完成不要中途关闭。小结第一次运行就干等进度条跑完这一次后面的任务都会快很多。 一条命令修完整个文件夹当你有一批视频要处理时把--input指向目录即可此时--output表示输出目录jasna --input input_folder --output output_folder处理顺序固定为图片在前、视频在后。输出文件名默认是输入文件名主干加_out即{original}_out模板想换一套命名用--output-pattern指定例如--output-pattern {original}_restored。开始处理前Jasna 会先算好每个文件的输出路径。如果两个输入会落到同一个输出文件典型情况是a.mp4和A.MP4只区分大小写程序会直接报错退出并明确提示是哪两个输入冲突不会覆盖任何内容。小结批量前先确认输出目录是空的或专门为此新建的命名拿不准就沿用默认模板最不容易出事。⚡ 三个调节旋钮显存、画质与范围默认参数跑不动或跑得不满意时按下面三个方向各调一个参数即可不必研究全部选项。显存不够先拧这个参数--max-clip-size决定一次协同修复的帧数是显存占用的第一调节项。默认 90 帧出现显存不足时先把它调小再跑jasna --input input.mp4 --output output.mkv --max-clip-size 60量级参考RTX 5090 实测中 90 帧片段约占 4.1 GB 显存360 帧约 6.3 GB更完整的显存数据见 docs/zh/tuning.md。原则就是取显卡装得下的最大值——越大画面越稳、吞吐越高。想要更好画质就调 --cq--cq是质量目标数值越低画面越好、文件越大。NVIDIA 显卡的默认值为 H.264 25、HEVC 28、AV1 35。想再榨一点画质可以顺带微调几个高级编码参数jasna --input in.mp4 --output out.mkv --cq 22 --encoder-settings rc-lookahead32,bf4只修视频里的某几段如果马赛克只出现在少数镜头没必要整片重跑。--segments只修复指定区间其余部分直接复制时间写法支持秒数或HH:MM:SS.sjasna --input input.mp4 --output output.mp4 --segments 10-25,01:10-01:30.5注意一个连带效果启用区间修复后输出编解码器会被锁定为输入视频自带的编解码器--codec不再生效。区间写法细节见 docs/zh/segments.md。小结使用顺序记成一句话——默认跑显存爆就调--max-clip-size画质不满就调--cq只坏一段就调--segments。 省心模式边修边看修完自动收尾修的同时就看加--stream进入 HLS 流媒体模式每修完一小段就通过 HTTP 推送出去浏览器或 VLC 可以直接播放全程不生成文件。流媒体固定使用 H.264 编码端口默认8765分段默认 4 秒--no-browser可以禁止启动时自动打开浏览器jasna --stream修完自动关机或执行命令整批任务跑完后可以完全交给系统--post-export-action取shutdown时所有导出结束后立即关机取command时执行--post-export-command里写的 shell 命令。另外--post-export-video-command在每一个视频单独导出成功后触发支持{input}、{output}、{output_dir}、{output_stem}、{output_suffix}占位符方便做转存、通知等自动化jasna --input folder_in --output folder_out --post-export-action shutdown小结整夜挂机建议配--no-progress把输出收敛成纯日志方便第二天排查哪条任务出了问题。附录参数清单按使用场景重新分组以下四张表把修复 / 检测 / 二级修复 / 编码 / 流媒体 / 导出后操作这些原始类别按场景重新归并完整定义见 jasna/main.py。跑动控制与基础开关参数默认值说明--input—要处理的视频、图片或文件夹路径--output—输出文件输入是文件夹时这里填输出文件夹--output-pattern{original}_out文件夹批量的命名模板{original}为输入文件名主干--devicecuda:0选择 GPUAMDROCm同样写cuda:N--batch-size4检测阶段的批处理大小--fp16/--no-fp16开启半精度计算省显存、通常更快肉眼画质无差别--log-levelerror日志级别debug/info/warning/error--no-progress关闭隐藏进度条采集日志时更干净--version—打印版本后退出画质、显存与检测修复 / 检测 / 二级修复合并参数默认值说明--restoration-model-namebasicvsrpp视频修复模型basicvsrpp快ltx为扩散模型、细节更好但慢很多NVIDIA 专用--restoration-model-pathmodel_weights/内模型指定权重文件ltx对应的是一个文件夹--compile-basicvsrpp开启为 GPU 预编译引擎速度约提升 3 倍NVIDIA 专用--max-clip-size90一次协同修复的帧数越大越稳但越吃显存装得下就取大值--temporal-overlap8相邻片段共享的帧数用于掩盖接缝闪烁8–20 常用--enable-crossfade开启片段边界交叉淡化复用已算出的帧不额外耗 GPU--denoisenone对修复区域的空域降噪强度low/medium/high--denoise-stepafter_primary降噪时机二级修复之前或合成回视频之前--secondary-restorationnone二级修复把修复区域放大到 512/1024 px 再合成可选unet-4x/tvai/rtx-super-res仅 NVIDIA--rtx-scale4RTX Super Res 放大倍数取2或4--rtx-qualityhigh质量档位low到ultra--rtx-denoise/--rtx-deblurmedium/none二级修复的降噪 / 去模糊强度--tvai-modeliris-2Topaz 模型名例如iris-2、prob-4--tvai-scale4输出尺寸为 256×scale1表示不放大--tvai-workers2并行的 Topaz 工作进程数--detection-modelrfdetr-v6马赛克检测模型rfdetr-v6与rfdetr-vr-v1VR180随附rfdetr-v6-large、zelefans-vr-yolo-v2可下载--detection-model-path自动权重路径默认为model_weights/模型名--detection-score-threshold自动置信度阈值rfdetr-v6 建议 0.35漏检调低、误检调高--max-detection-gap2马赛克在原位置重现时最多补 N 帧的检测空档--min-detection-duration2持续不足 N 帧的检测直接丢弃过滤误检--no-scene-detection关闭关闭镜头硬切检测默认会在镜头切换处结束跟踪片段输出、编码与区间参数默认值说明--codechevchevc均衡、h264兼容性最好、av1文件最小需 RTX 40 系及以上--cq按 GPU 与编解码器质量目标越低画质越好文件越大NVIDIA 默认 H.264 25 / HEVC 28 / AV1 35--encoder-settings—高级编码参数JSON 或逗号分隔如rc-lookahead32,bf4--lut—.cube色彩 LUT编码前在 GPU 上应用--sharpen0编码前锐化量0为关、1最强--retarget-high-fps关闭60→30 FPS隔帧处理音频时序保持不变--fmp4关闭碎片化 MP4生成中即可播放中断后也不损坏--segments—只修复指定区间如10-25,01:10-01:30.5其余原样复制编码器锁定为输入的--vr-modeautoVR180 并排视频的投影处理方式auto会按片商保守自动检测流媒体与导出后自动化参数默认值说明--stream关闭HLS 边修边播不产生文件编码固定 H.264--stream-port8765流媒体 HTTP 端口--stream-segment-duration4.0每个流媒体分段的时长秒--no-browser关闭启动流媒体时不自动打开浏览器--post-export-actionnone全部导出完成后的动作shutdown立即关机command执行下一条命令--post-export-command—配合command模式执行的 shell 命令--post-export-video-command—每个视频导出成功后执行支持{input}、{output}、{output_dir}、{output_stem}、{output_suffix}占位符避坑清单开跑前对一遍显卡门槛NVIDIA GTX 16 / RTX 20 系列或更新计算能力 ≥ 7.5AMD 显卡为实验性支持ROCm--device写法相同。⚠️ 安装路径只能包含英文字母和数字带中文或空格时 CLI 会直接报错退出这是最常见的跑不起来原因。⚠️unet-4x、tvai、rtx-super-res三种二级修复都只支持 NVIDIAAMD 显卡只能走主修复流程。av1编码要求 RTX 40 系及以上不追求最小文件时HEVC 是最稳的默认选择。处理 VR180 并排视频时加--vr-mode auto工具会按片商自动选择每只眼的修复投影无需手动判断。看到两个输入映射到同一输出的报错按提示改掉--output-pattern模板即可程序不会强行覆盖。小结开跑前把路径、显卡、jasna --help三件事各确认一遍之后遇到拿不准的选项帮助输出里永远有一份最新的列表。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考