Jasna GUI 视频修复实操指南：从环境自检到批量出片的完整走查

Jasna GUI 视频修复实操指南从环境自检到批量出片的完整走查【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是一款开源的视频修复工具GUI 版把批量处理、实时预览、预设管理与模型激活装进了同一套窗口。本文按真实使用流程带你走完装完 → 自检 → 批量出片 → 复用配置 → 实时预览 → 激活支持者模型 → 排障这条完整路径每个关键数字与判断逻辑都标注了文件出处不必再反复翻官方文档。装完先过的三道坎路径、磁盘与自检向导Jasna 装在什么位置最不容易出事界面上你只能看到首次启动向导逐项打勾但有三条前提在装之前就定了生死安装目录必须落在本地磁盘Windows 侧要求 NTFSLinux 侧支持 ext4、Btrfs、XFS网络挂载路径一律不支持路径必须是纯 ASCIIjasna/os_utils.py的check_ascii_install_path会把安装目录做一次ascii编码只要目录里出现中文、日文或带重音字母编码失败即判负结果直接显示在向导里强烈建议 SSD。机械盘不是跑不了而是启动与加载模型都会明显变慢。机械盘为什么只警告、不拦截jasna/gui/app.py的_warn_if_installed_on_hard_disk会调用jasna/os_utils.py的install_on_hard_disk实测磁盘类型Windows 通过驱动查询寻道开销Linux 读取/sys下块设备的rotational标志对 Btrfs 匿名设备也做了兼容。一旦判定为 HDD日志面板只落一条hard_disk_warning警告不弹窗、不拦截——因为这是性能问题而不是功能问题。首次启动向导在逐项检查什么向导窗口的检查跑在后台线程jasna/gui/wizard.py的_start_checks_in_backgroundUI 每 100ms 轮询一次结果。如果 30 秒内线程还没跑完——超时上限即_CHECKS_TIMEOUT_SECONDS常见于驱动查询卡住或 torch 冷导入很慢——向导就停止等待、直接展示已有结果没跑完的项一律按失败计而不是通过判定逻辑见jasna/gui/system_checks.py的evaluate_check_results。底部按钮只有在必查项失败时才变成「退出」只剩警告时照样可以进入主界面。卡点它在看什么不过会怎样安装路径是否为纯 ASCII 本地磁盘路径阻塞按钮变「退出」ffprobe能否调起且 FFmpeg 主版本号必须等于 8check_ffprobe阻塞GPU是否检测到受支持的显卡、计算能力是否达标阻塞CUDA / ROCm运行时是否可用顺带报告版本与计算能力阻塞驱动GPU 驱动版本是否合规阻塞共享内存仅 Windows共享内存回退策略仅警告WARNING_ONLY_CHECKS收录不阻塞启动把视频喂进去、把成片拿回来批量修复主流程四个入口文件怎么进队列主操作区是队列面板jasna/gui/queue_panel.py日常添加入口共四个「添加文件」按钮加视频或图片_on_add_files旁边的文件夹图标整目录导入_on_add_folder直接把文件拖到队列区域上基于TkinterDnD的_on_file_drop每行条目的叉号之外右键菜单里也有对应的重放入口。处理顺序固定从上到下。条目超过 20 个时自动分页——分页常量即_PAGE_SIZE——用底部箭头翻页翻到第几页都按完整顺序执行注意拖拽换序只能在当前页内完成。每行四个小图标分别管什么jasna/gui/job_list_item.py的 JobListItem 上每行有四个操作入口剪刀图标打开区间编辑器播放图标把该视频送入视频播放器并停在暂停状态三点菜单或右键打开所在文件夹、复制路径、打开已修复的输出、把已完成/失败/跳过的条目重新放回队尾叉号整行移除。跑起来之后每行实时刷新进度百分比、FPS 与预计剩余时间update_job_status把progress、fps、eta_seconds刷到对应行。开始与停止两个大按钮的确切语义▶ 开始会处理队列里的全部条目包含之前已完成或失败的——所以中途改了配置直接再按一次即可不用重新导入文件■ 停止会结束本轮任务正在处理的条目退回等待状态jasna/gui/processor.py的_mark_stopped。写到一半的输出文件会保留在磁盘上下次遇到它时按「文件冲突」策略处理「清除已完成」只移除完成项「清空」移除全部条目。开始按钮为什么会灰着逻辑集中在jasna/gui/app.py的_update_start_button_state队列非空、没有模型正在下载、没有修复预览占用 GPU三者同时满足才点亮缺哪一条按钮旁的提示文案就指向哪一条无文件 / 模型下载中 / 预览恢复中照着提示排查即可。输出文件怎么命名撞名又怎么办输出设置区位于队列面板上方三个控件各管一件事「与输入相同」把每个结果保存在原文件旁边输出位置直接输入文件夹路径或点文件夹按钮浏览选定——选定即自动关闭「与输入相同」想恢复再点一次该开关命名模板{original}代表输入文件名不含扩展名替换发生在jasna/media/media_files.py的folder_output_path即output_pattern.replace({original}, input_path.stem)。出厂默认模板是{original}_restored.mp4jasna/gui/models.py的DEFAULT_OUTPUT_PATTERN输入my_video.mp4就得到my_video_restored.mp4。撞名不是等文件写出来才暴露输出路径或模板一变相关队列条目会立刻被高亮_refresh_conflicts重新计算后调用set_conflict。真正落到已有同名文件上时行为由「基本处理」分区的file_conflict下拉框jasna/gui/settings_sections/basic.py决定选项遇到同名已有文件时默认界面提示自动重命名auto_rename新文件改名保存两者都保留是无覆盖overwrite直接替换已有文件否选中时额外显示警告图标与提示文字跳过skip不输出该文件否无配置只用调一次预设、单视频隔离与图片精修把一套方案存成一键预设设置面板顶部工具条jasna/gui/settings_panel.py的_build_preset_bar可以把当前全部设置存成一个名字比如「1080p 快速」和「4K 最佳质量」各建一个处理不同素材前一键切换。底层是jasna/gui/models.py的 PresetManagercreate_preset/update_preset/delete_preset负责增删改get_last_selected/set_last_selected记录上一次使用的预设——「Jasna 重启后还停在你上次的预设」就是靠它旧版本保存的预设数据经过_migrate_preset_dict自动迁移无需手工转换手动改动任意设置后面板会亮起「已修改」标记_mark_modified防止你以为当前仍是某个出厂方案出厂预设与用户预设分开存放对出厂预设的删除操作会被拒绝。同一队列里为什么两个视频能用不同检测参数全局配置归预设管但有一类例外按视频单独存在区间编辑器里设置的检测模型与检测阈值只属于当前这个视频。队列项通过JobItem.try_set_video_optionsjasna/gui/models.py单独记账其余视频保持各自参数。一个队列里完全可以混放「高阈值粗检」和「低阈值精检」的素材互不干扰。图片批量处理先对比再决定保不保存静态图片走「交互式处理图片」入口分区定义在jasna/gui/settings_sections/image_restoration.py窗口实现为jasna/gui/interactive_image_restore.py打开后是左右对比视图逐张浏览_previous_image/_next_image_clicked换种子立即重看_change_seed在原图、遮罩、结果三种视图间切换_mask生成遮罩层_set_view切换模式只对满意的结果点保存_save_current。它比「每次重跑整个任务」快是因为渲染放在后台 worker 线程按单帧执行_worker_loop/_render换种子只是在同一张已准备好的帧上再做一次前向推理。 不出文件先睹为快实时预览玩家机制打开播放器只需三步点页眉的「视频播放器」jasna/gui/app.py的_open_video_player可以边修复边观看全程不产生输出文件选检测模型与检测阈值需要的话再叠加二次修复——RTX Super Res或UNet 4xjasna/gui/video_player.py的available_player_secondary_restorations给出可选集合点「选择视频」按播放。交互约定空格播放/暂停_space_pressed左/右方向键各跳 30 秒_SEEK_STEP_SECONDS 30.0全屏状态下把鼠标移到底部边缘控制栏自动浮现。修改模型、阈值或二次修复后管线会重建并从当前位置重新播放_request_pipeline_reload。注意播放器固定使用 BasicVSR不走 LTX 管线。状态栏那个「已就绪秒数」到底在报什么实时性保证在jasna/gui/raw_player.py的带时间戳帧缓冲里BUFFER_SECONDS 3.0后台修复最多领先播放 3 秒PREROLL_SECONDS 1.5预滚满 1.5 秒才真正开声。修复线程把帧写进环形缓冲播放端按时间戳弹出到期帧pop_due缓冲溢出时新帧顶掉旧帧_would_overflow_locked。所以「就绪秒数」反复掉回零对应的正是 GPU 修复速度追不上播放速度音频会停住等更多画面就绪——这是配置跟不上实时速度不是程序出错降分辨率或减轻修复配置即可。为什么视频播放器按钮会灰着互斥是硬约束队列处理或修复预览任一在跑播放器就打不开。_open_video_player入口处检查_preview_gpu_busy与processor.is_running()任一为真直接返回同时_update_video_player_button_state把页眉按钮置灰避免你点半天没反应还猜不出原因。想用支持者模型两条激活路径与名额规则UNet 4x、SD 1.5、LTX 属于支持者模型使用前需要激活。页眉「激活 Jasna」打开对话框jasna/gui/components.py所有会阻塞的操作都放在后台线程jasna/gui/activation_worker.py界面不会卡死。在线激活最快路径输入许可证码点「在线激活」start_online_activation。此过程只上传许可证码和机器密钥两项激活完成后 Jasna 离线使用不再联系服务器。离线机器用机器密钥手动走一遍复制机器密钥start_machine_key由本机硬件生成调用machine_key(cloud_workspaceFalse)在任意联网设备打开激活页面或点「打开激活页面」填入机器密钥与许可证码——也可以把这两个值直接发给出售方把拿到的激活密钥粘回 Jasna点「激活」start_activation。名额怎么算换硬件会不会浪费一个许可证码覆盖3 台电脑或云工作区同一台机器重复激活不占用新名额释放名额只能由所有者操作更换主板Windows或重装 Linux 视为新电脑占用一个名额重装 Windows、更换显卡/硬盘/内存不占名额重新激活即可激活密钥只包含你许可证码对应的模型不会多送密钥被拒先核对机器密钥再完整重抄一遍激活密钥为旧版 Jasna 生成的密钥需向出售方申请新密钥以JW1-开头的身份密钥属于云端 CLI 用途直接粘进 GUI 会抛出license_cloud_cli_only错误start_activation内的显式检查提醒你换到正确入口中文界面下激活对话框与首次启动向导页脚会出现「闲鱼」按钮XianyuButton由shows_xianyu_seller按当前语言决定点击展示卖家二维码用闲鱼 App 扫码直达卖家主页界面顶部的「闲鱼」按钮同样弹出该二维码。 出问题别慌日常维护手段与故障自查清单平时值得做的四个动作重跑系统检查除每个版本首次启动必跑之外页眉随时可以重跑jasna/gui/app.py的_show_system_check典型场景是刚更新完驱动。结果按版本记录set_system_check_passed_version决定某版本是否需要重新走检查流程。切换语言首次启动跟随系统语言页眉可切换。切换瞬间已构建控件的文字会立即刷新_on_language_changed触发_refresh_ui_text但完整生效需要重启 Jasna。内置语言包为zh、en、ja、ko、th五套位于jasna/gui/locales/。看日志底部工具条的日志按钮展开 LogPaneljasna/gui/log_panel.py实时滚动支持 debug / info / warning / error 四级过滤。导出只包含最后 5000 行——上限常量_MAX_LOG_ENTRIES 5000底层环形缓冲deque(maxlen5000)自动丢弃最旧条目jasna/gui/log_export.py的export_log_entries_txt写成.txt。反馈问题请附上这份文件。盯系统状态处理期间底部工具条滚动显示 GPU、显存、内存与 CPU 占用。数据源是jasna/gui/system_stats.py的read_system_statsNVIDIA 解析nvidia-smi的 CSV 输出AMD 走 sysfs由jasna/gui/app.py的轮询线程每 1.5 秒采样一次并 post 回 UI 线程。故障自查清单按发生频率排序启动向导某项不过依次核对纯 ASCII 路径、FFmpeg 8 本体、驱动版本与 GPU 计算能力共享内存项失败只是警告不用处理。开始按钮灰着按「队列为空 → 模型下载中 → 预览占着 GPU」的顺序排查按钮旁的提示文案会直接告诉你原因。输出文件名不符合预期先看命名模板里{original}的替换结果再看自动重命名是否被动触发过。播放器「就绪秒数」反复归零当前配置下 GPU 修不过实时速度降分辨率或减轻修复配置再试。激活密钥被拒机器密钥是否抄错、激活密钥是否完整、是否为旧版本 Jasna 所签JW1-开头的密钥不能进 GUI。日志里找不到早先的报错环形缓冲只留最后 5000 行出问题先点导出再排查。更多细节可查阅中文 GUI 文档交互与检查逻辑的源码集中在 jasna/gui/ 目录。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考