Jasna 视频修复 GUI 完整实战指南：六个场景从批量修复到激活支持者模型

Jasna 视频修复 GUI 完整实战指南六个场景从批量修复到激活支持者模型【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是一款开源视频修复工具支持 BasicVSR 等模型与 LTX 等支持者模型。本指南按六个场景讲它的 GUI 用法安装自检、批量修复、单视频与静态图精修、实时预览、日志排错、激活。每节给出操作步骤、常见坑与源码位置新手照着做老手顺藤摸瓜。一、跑起来之前的准备目标把 Jasna 装到一个能自检通过的位置让首次启动不返工。安装位置的两条硬要求只装本地磁盘Windows 用 NTFSLinux 用 ext4 / Btrfs / XFS网络磁盘不支持。路径必须纯 ASCII中文、日文、带重音的字母都不行。⚠️ 路径里混进非英文字符启动自检会直接阻塞主窗口打不开只能迁移安装目录后重来。启动时还会检测磁盘类型Windows 查驱动器寻道开销Linux 读/sys的rotational标志逻辑在install_on_hard_disk。机械盘上会往日志写一条hard_disk_warning⚠️ 这条警告是实测结论装机械盘的话启动与加载模型的时间都会明显变长建议 SSD。首次启动自检查什么安装或更新后第一次启动会先弹一个启动窗口逐项显示进度主窗口随后才打开。检查在后台线程执行UI 每 100ms 轮询一次驱动查询卡住或 torch 冷导入特别慢时向导等 30 秒就放弃先展示已完成的项。逐项清单如下完整逻辑见 jasna/gui/system_checks.pyascii_path安装路径是否纯英文失败阻塞启动ffprobe能否找到 ffprobe 且 FFmpeg 主版本号为 8失败阻塞启动gpu是否检测到受支持 GPU含计算能力失败阻塞启动cudaCUDA / ROCm 是否可用报告版本与计算能力失败阻塞启动driverGPU 驱动版本失败阻塞启动sysmem仅 WindowsNVIDIA 共享内存回退策略仅警告不阻塞amf仅 AMDAMD AMF 视频运行库读写视频必需失败阻塞启动三个容易误判的地方只有阻塞级检查失败时底部按钮才变退出仅警告可以点开始使用30 秒兜底后未跑完的项按失败处理看到红行先确认是不是卡住别急着重试环境结果按版本记录每个版本首次启动强制走一遍之后可从页眉手动重跑。实现细节路径判定在 jasna/os_utils.py 的check_ascii_install_path对安装目录做 ASCII 编码尝试编码失败即不合规。二、批量修复主流程目标把一批素材丢进队列统一输出约定一键跑完。批量导入视频的三种方式素材入队三条路实现集中在 jasna/gui/queue_panel.py点添加文件逐个选视频或图片点旁边的文件夹图标整文件夹一次进来把文件直接拖到列表上基于TkinterDnD的拖放支持。执行顺序从上到下拖条目把手调序。列表超过 20 条时下方出现翻页箭头分页常量_PAGE_SIZE 20所有页依次处理但拖动只在同页内生效⚠️ 想跨页换顺序先翻页再拖直接在原页拖是移不动的。每条素材JobListItem上有四个按钮✂️ 剪刀打开区间编辑器只修一段▶️ 播放在内嵌播放器里打开并保持暂停快速瞄原片⋮ 三点或右键打开所在文件夹、复制路径、打开修复后的输出、重新加入队列把已完成 / 失败 / 跳过项放回列表末尾✕ 移除。控制按钮▶ 开始处理列表中所有项目含已完成与失败的——改完设置不用重新加文件直接再按一次按钮可用条件是列表非空、没有模型在下载、修复预览没占 GPU。■ 停止结束本次处理当前条目回到等待中_mark_stopped。清除已完成移除完成项清空移除全部。⚠️ 停止后写到一半的输出文件会留在磁盘上下次按你选的文件冲突策略处理——跑到一半就停与覆盖同时开着时别把半成品当成品。输出命名模板与保存位置命名用模板{original}代表输入文件名不含扩展名默认模板{original}_restored.mp4所以my_video.mp4出片即my_video_restored.mp4。替换逻辑在folder_output_path里就一句output_pattern.replace({original}, 输入文件名)jasna/media/media_files.py。保存位置由工具栏两个联动控件决定点与输入相同结果落在原文件旁边手动输入路径或点文件夹按钮选别处会自动关闭与输入相同想回到原片旁再点一次即可。改模板或目录的瞬间任何会覆盖其他文件的条目会当场高亮不用等跑完才发现重名。文件冲突的三种策略选项在基本处理部分策略适合场景结果文件名跳过已有结果的增量补跑保持旧文件不动覆盖新结果直接替换旧文件同名旧文件被永久替换选中后弹出 ⚠️ 提示自动重命名默认批量出片、不想覆盖任何东西追加_1之类后缀避开冲突预设一套参数一个名字设置面板上方工具栏_build_preset_bar能把当前全部设置存成名字建个1080p 快速、再建个4K 最佳质量之后一键来回切。底层PresetManagerjasna/gui/models.py有两点值得知道get_last_selected()/set_last_selected()让重启后记住上次预设手动改过设置后面板标记已修改防止你以为还停在某个出厂预设上出厂预设与用户预设分开管理删出厂预设会被拒绝。三、单视频与静态图精修目标个别视频和图片不走全局参数单独伺候。单视频检测参数只属于它自己全局参数归预设管但区间编辑器里设置的检测模型和检测阈值只保存给当前这一个视频列表里其他条目保留各自的值——同一个列表可以混放高阈值粗检和低阈值精检的片子互不干扰。输出模板冲突同样是逐条高亮不是整列表一刀切。实现细节队列条目通过JobItem.try_set_video_options单独记录这些按视频覆盖的值jasna/gui/models.py。交互式修图换种子只看一帧修单张图时别用整任务重跑的思路。在图像修复静态图片部分点交互式处理图片入口在 jasna/gui/settings_sections/image_restoration.py打开一个左右对比视图窗口实现见 jasna/gui/interactive_image_restore.py上一张 / 下一张逐张浏览换种子立刻重新渲染出图原图、遮罩、结果三种视图切换满意才点保存只留你喜欢的。⚠️ 用整任务重跑去精修单图速度会差一个数量级——对比视图里换种子才是正路。快的原因渲染在后台 worker 线程按单帧进行帧已预先准备好换种子只是同一帧上的一次前向推理不像整任务那样把解码、修复、编码全走一遍。四、边修边看实时预览目标不产出文件直接看修复效果。三步打开实时预览播放器点页眉里的视频播放器_open_video_player见 jasna/gui/app.py选检测模型、检测阈值需要的话再选二次修复RTX Super Res或UNet 4x点选择视频挑片子按播放。快捷键空格播放 / 暂停左 / 右方向键前后跳 30 秒全屏时鼠标移到底部边缘控制栏自动浮出。改了模型、阈值或二次修复后会从当前位置重新播放管线重建。⚠️ 播放器和批量处理互斥有项目在处理、或修复预览在跑时点视频播放器没反应且页眉按钮置灰——这是硬性检查不是显示 bug。已就绪秒数归零意味着什么状态栏显示已提前修复好的秒数后台修复线程往带时间戳的帧缓冲里写帧缓冲最多领先播放 3 秒BUFFER_SECONDS 3.0预滚 1.5 秒PREROLL_SECONDS 1.5后才真正开声实现见 jasna/gui/raw_player.py缓冲溢出时丢旧帧。所以这个秒数反复掉到零就是 GPU 在当前设置下追不上实时播放画面卡等音频暂停等你。此时换低一档的分辨率 / 模型再看。另有一条设计决定播放器永远用 BasicVSR不用 LTX。五、排错与日志目标出了问题时快速定位是系统层、参数层还是运行层。重跑系统检查换了驱动、换了显卡、装了新 FFmpeg 之后从页眉再次运行系统检查_show_system_check见 jasna/gui/app.py。检查按版本记录通过状态决定某个版本要不要重新走流程。⚠️ AMD 用户AMF 运行库缺失时 Linux 上要手动装一次安装命令见 docs/zh/gui.md装完重启 Jasna 再查一次否则读写视频这条检查过不了。导出日志反馈前的一分钟底部工具栏的日志按钮展开 LogPaneljasna/gui/log_panel.py实时滚动可按 debug / info / warning / error 过滤导出保存最后 5000 行环形缓冲deque(maxlen5000)超出自动丢最旧的写为.txt。反馈问题前先导出日志能省掉一大轮复现了吗。读底部状态条处理时底部显示 GPU 利用率、显存、内存、CPU。数据来自read_system_statsjasna/gui/system_stats.pyNVIDIA 解析nvidia-smiAMD 读 sysfs轮询线程每 1.5 秒采样一次。跑任务时瞄一眼这排数字显存吃紧就该降档了。六、激活与支持者模型目标解锁 UNet 4x、SD 1.5、LTX 三个支持者模型。在线与手动两条激活路径页眉打开激活 Jasna对话框在 jasna/gui/components.py所有网络与验签操作都在后台线程执行jasna/gui/activation_worker.py不卡 UI。在线激活默认输入许可证码点在线激活。上传到网络的只有许可证码和机器密钥之后 Jasna 完全离线工作。手动激活断网机器或在线失败时复制机器密钥基于本机硬件生成在任意联网设备打开激活页面或点打开激活页面填入机器密钥 许可证码也可把两者发给你获取许可证码的渠道拿到激活密钥粘贴回 Jasna点激活。名额规则什么算新电脑一个许可证码最多用于3 台电脑或云工作区已激活后打开该窗口会联网显示已用名额如 2 / 3查不到时重开窗口重试即可修复功能不依赖这次查询。占名额更换主板Windows、重新安装 Linux、个别没有真正主板 ID 的 Windows 机换系统盘。不占名额重装 Windows、更换显卡 / 硬盘 / 内存、同一台机器重复激活——重新激活即可。激活密钥被拒的四步排查按顺序过一遍机器密钥是不是完整复制的激活密钥有没有截断重新完整复制。密钥是不是为旧版 Jasna 生成的旧版密钥不再通用需要回购买渠道换新密钥。你手里的密钥是不是以JW1-开头那是云端 CLI 专用身份密钥GUI 直接粘贴会被明确拒绝license_cloud_cli_only——请去正确的入口使用。⚠️ 激活密钥只包含你许可证码里购买的模型不会顺带解锁其他支持者模型。许可证码仅能通过官方支持渠道获取中文界面下激活对话框和首次启动向导的页脚会出现闲鱼按钮点一下显示卖家的闲鱼二维码用闲鱼 App 扫码进卖家主页购买。界面顶部的闲鱼按钮同理。收尾症状速查与主线回顾现象第一排查点处理播放器秒数反复归零GPU 修复速度追不上播放降分辨率 / 换模型档位点视频播放器无反应队列或预览占用 GPU等处理结束或按停止输出文件名多了_1后缀文件冲突 自动重命名生效中基本处理 → 文件冲突列表高亮某条目命名模板会覆盖其他文件改模板或保存位置启动窗口卡住后报红行30 秒兜底检查没跑完页眉重跑系统检查首次启动报路径错误安装路径含非英文字符迁移到纯 ASCII 路径启动日志有hard_disk_warning装在机械盘上迁到 SSD激活提示license_cloud_cli_only粘了云端 CLI 密钥JW1-开头换回本地激活密钥日志看不出问题默认缓冲只有 5000 行导出完整.txt再看主线回顾Jasna 的图形界面是一条装对位置 → 批量喂入 → 按预设落盘 → 单视频微调 → 静态图精修 → 实时预览 → 日志排错 → 激活解锁的旅程。界面里的每个约束——分页拖动、玩家器互斥、归零提示、名额校验——都能在其源码里找到一一对应的实现这份指南既是操作手册也是排错地图。官方文档入口docs/zh/gui.md【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考