Jasna 视频修复 GUI 实战指南：从启动卡死到解锁支持者模型的 7 个隐藏约束

Jasna 视频修复 GUI 实战指南从启动卡死到解锁支持者模型的 7 个隐藏约束【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna第一次打开 Jasna启动窗口卡在检查中十几秒然后弹出一行红字主界面迟迟不出现——多数新手都卡在这里。Jasna 是一个开源的视频修复工具GUI 支持批量喂入素材、实时预览修复效果、对静态图做精修并可通过激活解锁 UNet 4x、SD 1.5、LTX 等支持者模型。本文按真实使用旅程展开界面里的每个约束、每个隐藏行为都能在源码里找到一一对应的实现出问题你知道往哪儿查。 首次运行的关卡进不了主界面时的硬性条件装之前先确认两条硬条件装错后面全卡路径必须纯 ASCII自检会对安装目录做 ASCII 编码尝试编码失败即判不合规check_ascii_install_path逻辑在 jasna/os_utils.py其次尽量用 SSD启动时install_on_hard_disk会判断磁盘类型装在机械盘上日志面板会写一条hard_disk_warning警告启动和加载模型都会明显变慢——这是实测行为不是错觉。各项检查集中在 jasna/gui/system_checks.py逐项结果如下检查键查什么失败后果ascii_path安装路径是否纯英文阻塞启动ffprobe能否找到 ffprobe 且 FFmpeg 主版本号为 8阻塞启动gpu受支持 GPU 且计算能力不低于MIN_GPU_COMPUTE (7, 5)阻塞启动cudaCUDA / ROCm 是否可用报告版本与计算能力阻塞启动driverGPU 驱动版本Linux 要 580Windows 要 610阻塞启动sysmem仅 WindowsNVIDIA 共享内存回退策略仅警告不阻塞amf仅 AMDAMD AMF 视频运行库读写视频必需阻塞启动注意sysmem是源码里WARNING_ONLY_CHECKS {sysmem}中唯一的键只有它失败时底部按钮仍是开始使用其余任何一项失败按钮直接变成退出。检查在后台线程跑UI 每 100ms 轮询一次驱动查询卡住或 torch 冷导入特别慢时向导等 30 秒就放弃_CHECKS_TIMEOUT_SECONDS 30.0逻辑在 jasna/gui/wizard.py先展示已完成的项。⚠️红行不一定是环境问题现象是卡住后出现红色失败行原因是兜底超时后未完成的检查项被evaluate_check_results明确地按失败处理——从未运行的检查宁可读成失败也不会在显示红行时放行开始使用。你该做的是先确认是不是卡住了别急着重试环境。检查结果按版本记录每个版本首次启动才强制走一遍流程get_system_check_passed_version对比__version__逻辑在 jasna/gui/app.py之后可随时手动重跑见后文排错部分。硬关卡过了接下来把第一批素材喂进队列。 第一次跑通从添加素材到看到首个输出素材入队有三条路实现在 jasna/gui/queue_panel.py点添加文件选视频或图片点旁边的文件夹图标整个文件夹一次丢进来图片排在视频前面直接把文件拖到列表上。处理顺序就是从上到下拖条目的把手调整顺序。但列表超过 20 条时下方才出现翻页箭头分页常量_PAGE_SIZE 20所有页都会被依次处理拖动只能在同一页内——跨页换顺序得先翻页再拖。输出落地看队列上方工具栏的两个联动控件点与输入相同每个结果存在原文件旁边手动输入文件夹路径或点文件夹按钮选别处会自动清空该选项_on_same_as_input与_set_output_folder互相联动。命名用模板{original}代表输入文件名不含扩展名默认模板DEFAULT_OUTPUT_PATTERN {original}_restored.mp4逻辑在 jasna/gui/models.py替换就一行folder_output_path里output_pattern.replace({original}, 输入文件名)逻辑在 jasna/media/media_files.py。所以my_video.mp4出片就是my_video_restored.mp4。改保存位置或模板的瞬间任何会覆盖已有文件的条目会立即被高亮标出不用等跑完才发现重名。同名文件三种处理方式在基本处理部分的文件冲突下拉框里逻辑在 jasna/gui/settings_sections/basic.py选项行为备注自动重命名auto_rename换个不冲突的名字再写默认值输出名会带(N)序号覆盖overwrite直接替换已有文件选中后弹出 ⚠️ 提示现有文件将被永久替换跳过skip已有文件时不动适合增量补跑⚠️半成品文件的坑现象是停止后磁盘上留着半个输出原因是停止按钮结束本次处理后当前条目回到等待中状态_mark_stopped逻辑在 jasna/gui/processor.py已写入的半成品原样留在磁盘上你该做的是跑一半就停和覆盖同时开着时别把上次的半成品当成品确认冲突策略后再跑。开始按钮的语义要记准它会处理列表中所有项目包括已完成和失败的——改完设置不用重新添加文件直接再按一次即可但如果上次是被你停止的它只挑状态仍为等待中的条目继续_on_start里was_stopped分支。隐含限制列表非空、没有模型在下载、修复预览没占用 GPU 时开始按钮才可用。拿到第一个输出之后想不产文件先看效果走实时预览这条路。 不落盘验证效果实时预览与单图精修点页眉里的视频播放器_open_video_player逻辑在 jasna/gui/app.py三步开起来先选检测模型、检测阈值需要的话再选二次修复RTX Super Res 或 UNet 4x点选择视频挑片子按播放。快捷键空格播放/暂停左/右方向键前后跳 30 秒_SEEK_STEP_SECONDS 30.0逻辑在 jasna/gui/video_player.py。⚠️点视频播放器没反应不是 bug现象是按钮置灰、点击无反应原因是玩家器和批量处理互斥源码里就一句硬检查——self._preview_gpu_busy或处理器在跑时直接return这是设计如此不是显示 bug。你该做的是等处理结束或先点停止。另外记住一条设计决定播放器永远走 BasicVSR不走 LTX。状态栏显示的是已提前修复好的秒数后台修复线程往带时间戳的帧缓冲里写帧缓冲最多领先播放 3 秒BUFFER_SECONDS 3.0预滚 1.5 秒PREROLL_SECONDS后才真正开声缓冲溢出时丢旧帧TimestampFrameBuffer逻辑在 jasna/gui/raw_player.py。所以这个秒数反复掉到零就是 GPU 在当前设置下追不上实时播放画面卡等、音频暂停。此时换低一点的分辨率或模型档位再看别怀疑软件坏了。修完视频再看单张静态图时别用整任务重跑的思路。交互式处理图片图像修复部分打开一个左右对比视图窗口实现在 jasna/gui/interactive_image_restore.py上一张/下一张逐张浏览换种子立刻重新渲染原图/遮罩/结果三种视图切换满意才保存。为什么快渲染在后台 worker 线程按单帧进行帧已预先准备好换种子只是同一帧上的一次前向推理——不像整任务那样把解码、修复、编码全走一遍。修图这种多试几次参数的场景快一个数量级。想换画质批量跑之前先把参数固化成预设。⚙️ 记住设置、解锁高阶能力预设与激活设置面板上方的工具栏_build_preset_bar逻辑在 jasna/gui/settings_panel.py能把当前全部设置存成一个名字建个1080p 快速再建个4K 最佳质量一键来回切。底层是PresetManagerjasna/gui/models.py三点值得知道重启后记住上次预设get_last_selected()/set_last_selected()记录你最后一次用的名字手动改过设置后面板会标记已修改_update_modified_indicator用asdict比对当前设置与所选预设防止你以为还停在某个预设上出厂预设与用户预设分开管理删除或保存出厂预设会被拒绝delete_preset/update_preset先查FACTORY_PRESETS。全局参数归预设管但有两类例外只属于单个视频在区间编辑器里设置的检测模型和检测阈值只保存给当前这一个视频。队列条目通过JobItem.try_set_video_options单独记录这些按视频覆盖的值且仅在状态为PENDING时生效逻辑在 jasna/gui/models.py。同一个列表里可以混放高阈值粗检和低阈值精检的视频互不干扰。支持者模型UNet 4x、SD 1.5、LTX需要激活。页眉打开激活 Jasna对话框在 jasna/gui/components.py所有网络与验签操作都在后台线程执行jasna/gui/activation_worker.py不卡 UI。两条路径在线激活默认输入许可证码点在线激活上传的只有许可证码和机器密钥之后 Jasna 完全离线工作手动激活断网机器或在线失败时复制机器密钥基于本机硬件生成→ 在任意联网设备打开激活页面或点打开激活页面填入机器密钥 许可证码 → 拿到激活密钥粘贴回 Jasna 完成激活。名额规则一个许可证码最多用于3 台设备界面提示license_service_slots_full即3 个注册名额全部占用。⚠️密钥被拒先查这一条现象是粘贴激活密钥后提示license_cloud_cli_only原因是你手里的密钥以JW1-开头那是云端 CLI 专用身份密钥GUI 直接粘贴会被明确拒绝逻辑在 jasna/gui/activation_worker.py。你该做的是去正确的入口使用。其余常见原因按顺序过机器密钥没复制完整激活密钥截断了license_malformed密钥是旧版 Jasna 生成的license_retired需回购买渠道换新另外记住激活密钥只包含你许可证码里购买的模型不会顺带解锁其他支持者模型。 出问题往哪儿查自检重跑、日志导出与状态条读数换了驱动、换了显卡、装了新 FFmpeg 之后从页眉再次运行系统检查_show_system_check逻辑在 jasna/gui/app.py即可——检查按版本记录通过状态决定某个版本要不要重新走流程。⚠️AMD 用户的额外依赖系统检查还会查 AMF 视频运行库现象是amf一行红字原因是 Linux 上这个运行库不随驱动自带需要手动装一次官方文档 docs/zh/gui.md 给出了安装命令你该做的是装完重启 Jasna 再查一次。底部工具栏的日志按钮展开 LogPaneljasna/gui/log_panel.py实时滚动可按 debug / info / warning / error 过滤导出把缓冲区内容写为.txt。注意缓冲是环形的_MAX_LOG_ENTRIES 5000超出自动丢最旧的行所以反馈问题前先导出日志别只盯着屏幕上滚过去的几行。处理时底部状态条显示 GPU 利用率、显存、内存、CPU。数据来自read_system_statsNVIDIA 解析nvidia-smi输出AMD 读 sysfs逻辑在 jasna/gui/system_stats.py轮询线程每 1.5 秒采样一次。跑任务时瞄一眼这排数字显存吃紧就该降档。主线总结装对位置ASCII 路径 SSD→ 批量喂入队列分页内拖动排序→ 按预设落盘命名模板 文件冲突策略→ 单视频微调按视频覆盖检测参数→ 实时预览验证效果注意 GPU 互斥与秒数归零→ 静态图单帧精修 → 预设固化参数、激活解锁支持者模型 → 日志/状态条排错。症状大概率原因去哪儿查启动窗口卡住后报红行30 秒兜底未跑完的检查按失败处理页眉重跑系统检查首次启动报路径错误安装路径含非英文字符迁移到纯 ASCII 路径启动日志有hard_disk_warning装在机械盘上迁到 SSD输出文件名变(1)后缀文件冲突自动重命名生效中基本处理 → 文件冲突列表高亮某条目命名模板会覆盖其他文件改模板或保存位置停止后磁盘上有半成品文件中断输出残留按文件冲突策略处理后再跑播放器秒数反复归零GPU 修复速度 播放速度降分辨率 / 换模型档位点视频播放器无反应队列或预览占用 GPU等处理结束或先停止激活提示license_cloud_cli_only粘了JW1-开头的云端 CLI 密钥换回本地激活密钥日志看不出问题环形缓冲只有 5000 行导出完整 .txt 再看官方文档入口docs/zh/gui.md【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考