Jasna 视频修复 GUI 实操指南：从首次启动到批量修复出片

Jasna 视频修复 GUI 实操指南从首次启动到批量修复出片【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是一款开源视频修复工具自动定位视频里的马赛克区域并在 GPU 上修复GUI 版把批量处理、实时预览、预设管理与模型激活整合在同一套窗口里。本文按真实使用顺序走一遍视频修复批量处理的主流程首次启动把系统检查跑通、把视频丢进队列拿到第一支成片、用预设让重复配置消失、边修边看实时预览最后覆盖激活规则与日常排错。照着走一遍基本不会再遇到需要翻源码才能解释的界面行为。把机器跑起来安装位置与系统检查一次过装在哪、向导到底在查什么启动前有三条硬约束安装目录必须在本地磁盘Windows 要 NTFSLinux 支持 ext4、Btrfs、XFS、ZFS网络盘不行路径必须纯 ASCII中文、日文、带重音的字母都会挂强烈建议 SSD。依据在 jasna/os_utils.py 的check_ascii_install_path它对安装目录做一次ascii编码编码失败即判负Linux 侧则读/sys下块设备的rotational标志识别机械盘——判定为 HDD 时日志面板落一条hard_disk_warning警告不拦你启动。首次启动弹出向导检查在后台线程跑jasna/gui/wizard.py的_start_checks_in_backgroundUI 每 100ms 轮询一次30 秒没跑完_CHECKS_TIMEOUT_SECONDS 30.0就放弃等待直接展示已有结果未完成的项一律按失败计。必查项失败时底部按钮变「退出」只剩警告时照常进入主界面安装路径纯 ASCII 本地路径失败阻塞ffprobe能调起且 FFmpeg 主版本号必须等于 8jasna/gui/system_checks.py的check_ffprobe失败阻塞GPU受支持显卡且计算能力达标NVIDIA GTX 16 系及以上、计算能力 7.5 起失败阻塞CUDA/ROCm 运行时、GPU 驱动版本失败阻塞Windows 共享内存只做警告失败不阻塞不用管全绿之后直接点开始即可。修出第一支成片从队列到命名开始按钮是灰的先核对哪三件事队列面板有三个入口「添加文件」按钮、旁边的文件夹图标整目录导入、直接把文件拖到队列上TkinterDnD实现。跑起来后每行实时刷进度百分比、FPS 与预计剩余时间超过 20 条自动分页每页 20 条jasna/gui/queue_panel.py的_PAGE_SIZE拖拽换序只在当前页内有效。注意这条▶ 开始按钮置灰时按「队列为空 → 有模型在下载 → 预览占用 GPU」的顺序排查。三者同时满足才点亮逻辑在jasna/gui/app.py的_update_start_button_state按钮旁的提示文案会直接指向缺的那一条。开始按钮处理队列里的全部条目中途停止后未完成的条目留在队列里再按一次开始只续跑待处理项同一文件的_on_start。输出文件名不对劲时改哪里输出区三个控件各管一件事「与输入相同」开关、输出位置路径、命名模板。模板变量{original}是输入文件名不含扩展名替换发生在 jasna/media/media_files.py 的folder_output_path。出厂默认模板是{original}_restored.mp4jasna/gui/models.py的DEFAULT_OUTPUT_PATTERN输入my_video.mp4就得到my_video_restored.mp4。输出路径或模板一变相关队列条目立刻高亮提醒。真要落到同名文件上时行为由「基本处理」分区的file_conflict下拉框jasna/gui/settings_sections/basic.py决定auto_rename自动重命名新文件改名保存两者都保留默认overwrite覆盖直接替换已有文件选中时旁边多出警告图标skip跳过不输出该文件让重复配置消失预设与按视频覆盖同一队列里能给不同视频配不同参数吗设置面板顶部工具条可以把当前全部设置存成一个命名的预设比如「1080p 快速」和「4K 最佳质量」处理不同素材前一键切换。底层是jasna/gui/models.py的PresetManager增删改由create_preset/update_preset/delete_preset负责set_last_selected记住上次用的预设重启后还停在那一个旧版预设数据经_migrate_preset_dict自动迁移。手动改动任意设置会亮起「已修改」标记防止你误以为还是出厂方案出厂预设 Default 受FACTORY_PRESETS保护删不掉。有一类例外按视频单独存区间编辑器里设置的检测模型与检测阈值只属于当前视频由JobItem.try_set_video_options同文件单独记账。一个队列里混放「高阈值粗检」和「低阈值精检」的素材互不干扰。图片批处理是怎么跑的静态图片走「交互式处理图片」入口jasna/gui/interactive_image_restore.py左右对比视图里逐张浏览、换种子立即重看、在「原图 / 遮罩 / 结果」三种视图间切换只对满意的结果点保存。它比「重跑整个任务」快是因为渲染放在后台 worker 线程按单帧执行_worker_loop/_render换种子只是在同一张已准备好的帧上再做一次前向推理。边修边看实时预览播放器的工作方式「已就绪秒数」为什么反复归零页眉打开「视频播放器」操作三步选检测模型与阈值NVIDIA 可叠加二次修复、「选择视频」、按播放。空格播放/暂停左右方向键各跳 30 秒jasna/gui/video_player.py的_SEEK_STEP_SECONDS 30.0改模型、阈值或二次修复后管线重建并从当前位置续播。播放器固定走 BasicVSR不经 LTX 管线。状态栏持续显示「已提前修复好的秒数」。这个数字反复掉回零这不是 bug是当前配置下 GPU 修不过实时速度音频会停住等帧。机制在jasna/gui/raw_player.py的带时间戳帧缓冲BUFFER_SECONDS 3.0后台修复最多领先播放 3 秒PREROLL_SECONDS 1.5预滚满 1.5 秒才开声缓冲溢出时新帧顶掉旧帧。互斥是硬约束队列处理或修复预览任一在跑播放器就打不开页眉按钮同时置灰避免你点半天猜不出原因。开工前先扫一眼关键默认值速查这些默认数字值得先知道界面上看到什么具体数值定义位置FFmpeg 主版本要求8jasna/gui/system_checks.pycheck_ffprobe队列分页每页 20 条jasna/gui/queue_panel.py_PAGE_SIZE输出命名模板{original}_restored.mp4jasna/gui/models.pyDEFAULT_OUTPUT_PATTERN文件冲突默认策略auto_rename自动重命名jasna/gui/settings_sections/basic.py播放器预缓冲3.0 秒jasna/gui/raw_player.pyBUFFER_SECONDS播放器预滚开声1.5 秒jasna/gui/raw_player.pyPREROLL_SECONDS方向键跳转步长30 秒jasna/gui/video_player.py_SEEK_STEP_SECONDS日志环形缓冲5000 行jasna/gui/log_panel.py_MAX_LOG_ENTRIES向导检查等待上限30 秒jasna/gui/wizard.py_CHECKS_TIMEOUT_SECONDS系统状态采样周期1.5 秒jasna/gui/app.py轮询线程处理期间底部工具条滚动显示 GPU、显存、内存与 CPU 占用数据来自jasna/gui/system_stats.py的read_system_statsNVIDIA 解析nvidia-smi输出AMD 走 sysfs。出问题先看这里激活、日志与日常维护激活密钥被拒先查什么UNet 4x、SD 1.5、LTX 属于支持者模型使用前需激活页眉「激活 Jasna」打开对话框。两条路径在线激活只上传许可证码与机器密钥两项激活完成后离线使用离线激活是先复制机器密钥在任意联网设备填好机器密钥与许可证码把拿到的激活密钥粘回点「激活」。名额与边界规则一个许可证码覆盖3 台电脑或云工作区同一台机器重复激活不占新名额更换主板Windows或重装 Linux 视为新电脑占名额重装 Windows、换显卡/硬盘/内存不占重新激活即可激活密钥只含你许可证码对应的模型不会多送以JW1-开头的身份密钥属于云端 CLI 用途直接粘进 GUI 会报license_cloud_cli_onlyjasna/gui/activation_worker.py内显式检查中文界面下向导页脚与激活对话框会出现「闲鱼」按钮XianyuButton点击弹出卖家二维码早先的报错日志去哪了底部工具条的日志按钮展开 LogPanel实时滚动支持 debug / info / warning / error 四级过滤导出写成.txt但只包含最后 5000 行deque(maxlen5000)环形缓冲自动丢旧。反馈问题前先导出再排查。系统检查除每个版本首启必跑外页眉随时可重跑典型场景刚更新完驱动结果按版本记录set_system_check_passed_version机制决定当前版本是否要重新走检查。语言在页眉切换已构建控件的文字立即刷新完整生效需重启jasna/gui/locales/内置 zh、en、ja、ko、th 五套语言包。完整 GUI 说明见 docs/en/gui.mdGUI 全部源码在 jasna/gui/。 故障自查清单启动向导某项不过依次核对纯 ASCII 路径、FFmpeg 8 本体、驱动版本、GPU 计算能力共享内存项失败只是警告不用处理。开始按钮灰着按「队列为空 → 模型下载中 → 预览占用 GPU」顺序排查按钮旁文案即答案。输出文件名不符合预期先查模板里{original}的替换结果再看自动重命名是否被动触发过。播放器「就绪秒数」反复归零GPU 修不过实时速度降分辨率或减轻修复配置再试。激活密钥被拒核对机器密钥是否抄错、激活密钥是否完整、是否为旧版 Jasna 所签JW1-开头密钥不能进 GUI。日志里找不到早先报错环形缓冲只留最后 5000 行先点导出再排查。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考