Jasna 视频修复 GUI 完整指南：自检、队列到激活排错

Jasna 视频修复 GUI 完整指南自检、队列到激活排错【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是一款开源的视频修复工具带图形界面批量喂入打码或低画质素材在 GPU 上逐帧修复产出可用成片。但有一道隐形门槛多数人忽略了——安装位置本身会被启动时逐条盘查路径里混进一个非英文字符就可能被拦在门外。读完本文你可以带走三样东西自检的硬性约束清单、输入/处理/输出三段主线的完整规则以及支持者模型的激活与名额玩法。启动自检门槛硬性条件清单首启向导会把环境逐项过一遍结果如下逻辑在 jasna/gui/system_checks.py 的run_system_checks检查项判定逻辑不满足后果ascii_path安装目录路径可纯 ASCII 编码阻塞启动ffprobe能调起 ffprobe且 FFmpeg 主版本为 8阻塞启动gpu检测到受支持 GPU架构与算力达标阻塞启动cudaCUDA / ROCm 可用并报告能力阻塞启动driverGPU 驱动版本达到下限阻塞启动sysmem仅 WindowsNVIDIA 共享内存回退策略仅警告不阻塞amf仅 AMDAMD AMF 视频运行库可加载阻塞启动这套设计有两个值得注意的细节。其一ASCII 判定不是文本比对而是直接把安装目录路径做一次path_str.encode(ascii)编码抛异常即不合规check_ascii_install_pathjasna/os_utils.py。其二检查跑在后台线程UI 每 100ms 轮询一次结果驱动查询卡住或冷导入过慢时向导等满_CHECKS_TIMEOUT_SECONDS 30.0秒就收手先展示已完成的部分jasna/gui/wizard.py。装到机械盘上不会拦截启动但install_on_hard_disk会读磁盘类型Windows 查寻道开销Linux 读/sys的 rotational 标志日志面板随后写一条hard_disk_warning——启动和加载模型都会明显变慢建议迁到 SSD。⚠️ 最反直觉的一条从未跑完的检查项会被按失败计而不是按通过计evaluate_check_results。所以看到红行先别换显卡先确认是不是 30 秒兜底把它误杀了。过了这道线真正的干活才开始素材、参数、落盘位置是三个互不牵连的决定。输入侧素材入队的添加方式与排序边界把素材放进项目列表有三条路jasna/gui/queue_panel.py点添加文件逐个挑选视频或图片点旁边的文件夹按钮整个目录一次入队直接把文件拖到列表上窗口基于TkinterDnD接住拖放。处理顺序就是列表从上到下。每个条目JobListItemjasna/gui/job_list_item.py带四个控件图标功能触发方式✂打开区间编辑器只修视频中的一段点按钮▶内置播放器打开该视频并暂停快瞄原片点按钮⋮打开所在文件夹、复制路径、打开已产出结果、重新加入队列点按钮或右键✕从列表移除该项目点按钮列表一超过 20 条底部出现翻页箭头分页常量_PAGE_SIZE 20就写在源码里。拖动把手可以调整顺序但只能在本页内拖跨页换位得先翻页再拖。翻页只影响显示处理时会按顺序把每一页全部跑完。⚠️ 处理途中按停止当前条目回到等待中_mark_stoppedjasna/gui/processor.py而写到一半的输出文件原样留在磁盘。下次再跑时它算不算成品取决于文件冲突策略——策略若为覆盖半成品会成为被替换对象。素材就位后问题变成拿什么参数跑。预设管理器是答案。处理侧预设保存切换与按视频参数覆盖设置面板顶部的工具栏_build_preset_barjasna/gui/settings_panel.py能把当前全部设置存成一个名字。建一个1080p 快速、再建一个4K 最佳质量之后一键来回切。底层是PresetManagerjasna/gui/models.py四个特性值得记住切换即保存状态set_last_selected()记录最后一个用的名字重启后自动回到那里get_last_selected()手动改动任何设置后面板会标记已修改防止你以为还停在某个出厂档位上出厂预设与用户预设分开管理删除出厂预设会被拒绝预设只管全局参数下面两类例外归单个视频所有。全局与按视频的分工全局参数挂预设名下对队列里所有条目生效按视频覆盖在区间编辑器里设置的检测模型与检测阈值只写入当前这一个视频JobItem.try_set_video_optionsjasna/gui/models.py且仅在条目处于等待状态时生效。同一个列表里完全可以混放高阈值粗检和低阈值精检的片子互不干扰。还有一个隐含限制点开始并不是只跑待处理项——它会处理列表中所有项目包括已完成和失败的改完设置无需重新添加直接再按一次即可。但按钮的可用条件写在源码里一条都不能少列表非空、没有模型在下载、修复预览未占用 GPUcan_start bool(jobs) and not self._preview_gpu_busy and not downloadingjasna/gui/app.py。参数侧落定还差最后一问文件落在哪、叫什么名字。输出侧命名模板与文件冲突策略选择保存位置由队列上方两个联动控件决定点与输入相同每个结果存在原片旁边手动输入或另选文件夹与输入相同会被自动关闭想回到原片旁再点一次即可。命名走模板{original}代表输入文件名不含扩展名。默认模板与替换逻辑{original}_restored.mp4 output_name output_pattern.replace({original}, 输入文件名)常量DEFAULT_OUTPUT_PATTERN定义在 jasna/gui/models.py替换发生在folder_output_pathjasna/media/media_files.py。于是my_video.mp4出片就是my_video_restored.mp4。配套的即时反馈改保存位置或模板的瞬间任何会覆盖其他文件的条目会被立即高亮不用等跑完才发现重名。同名文件三种处理下拉框在 jasna/gui/settings_sections/basic.py选项行为适用场景自动重命名auto_rename换出不冲突的新名字默认值日常批量零风险覆盖overwrite直接替换已有文件选中即弹警告明确要换新版本跳过skip文件已存在则不动中断后的增量补跑⚠️ 覆盖不可撤销界面唯一的防线是 ⚠️ 提示现有文件将被永久替换。选它之前先确认目标文件真可以丢尤其是上次停止留下的半成品。文件落地的问题解决后别忘了还有另一种用法不产出文件先看效果。免产出预览实时预览与静态图单帧精修实时预览GPU 互斥与缓冲机制页眉的视频播放器入口有一句硬检查_preview_gpu_busy为真或处理器在跑时_open_video_player直接returnjasna/gui/app.py——玩家器和批量处理互斥页眉按钮同时置灰。这是硬约束不是显示 bug。播放器背后有个追赶机制后台修复线程把带时间戳的帧写进缓冲缓冲最多领先播放BUFFER_SECONDS 3.0秒预滚PREROLL_SECONDS 1.5秒后才开声缓冲溢出时丢旧帧jasna/gui/raw_player.py。所以状态栏那个已提前修复的秒数若反复掉到零就是当前设置下 GPU 追不上实时速度——画面卡等、音频暂停降分辨率或换低一档模型再看即可。操作上有三个快捷键空格播放/暂停←/→前后跳 30 秒全屏时鼠标移到底边控制栏自动浮出。改了模型、阈值或二次修复后管线重建从当前位置重新播放。同样是先看效果但入口与算力开销是两条完全不同的路。静态图单帧精修一个数量级的速度差图像修复静态图片部分的交互式处理图片打开一个左右对比视图jasna/gui/interactive_image_restore.py上一张/下一张逐张浏览换种子立刻重渲染原图、遮罩、结果三种视图随时切换满意才点保存只留下你想要的那张。为什么快整任务重跑像把整卷胶片重新洗一遍——解码、修复、编码全程走一次单帧精修则像给同张照片重新上色帧早已备好后台 worker 线程_worker_loop只做同一帧上的一次前向推理。修图这种多试几把参数的场景省掉的就是一个数量级。效果仍不对时先别怀疑软件把目光转向环境与许可下面这三件套按序使用。诊断与解锁日志导出、状态条与激活名额规则诊断三件套重跑检查、导出日志、看状态条重跑系统检查换驱动、换卡、装新 FFmpeg 后从页眉再跑一遍。通过状态按版本记录某个版本只需强制走一次流程之后随时可手动重查。导出日志底部日志按钮展开 LogPanel可按 debug / info / warning / error 过滤环形缓冲deque(maxlen5000)只留最新 5000 行_MAX_LOG_ENTRIES 5000jasna/gui/log_panel.py导出存为.txt。反馈问题前先导出能省掉一整轮复现了吗。底部状态条跑任务时显示 GPU 利用率、显存、内存、CPU采样线程每 1.5 秒轮询一次jasna/gui/app.py 的read_system_stats循环。显存吃紧就该降档数字会先替你说出来。⚠️ AMD 用户自检会查 AMF 视频运行库读写视频都靠它。Linux 上需手动安装一次docs/zh/gui.md 有现成命令装完重启 Jasna 再查一次。激活两条路径在线、手动与名额规则支持者模型UNet 4x、SD 1.5、LTX需要激活。页眉的激活 Jasna里所有联网与验签都在后台线程执行jasna/gui/activation_worker.py界面不卡。在线激活默认填许可证码点在线激活上传的只有许可证码和机器密钥之后本机完全离线工作手动激活断网机器或在线失败时复制机器密钥→ 在任意联网设备的激活页面填入机器密钥 许可证码 → 把拿到的激活密钥粘回 Jasna 点激活。名额规则一个许可证码最多覆盖3 台电脑或云工作区界面提示license_service_slots_full即 3 个名额用满。操作是否占名额更换主板Windows占重新安装 Linux占重装 Windows不占换显卡 / 硬盘 / 内存同机重复激活不占激活密钥被拒时按顺序过一遍机器密钥是否完整复制激活密钥是否被截断重新完整复制一次。密钥是否为旧版 Jasna 生成旧版密钥不再通用回购买渠道换新。⚠️ 密钥以JW1-开头那是云端 CLI 专用的身份密钥GUI 粘贴会被明确拒绝license_cloud_cli_onlyjasna/gui/activation_worker.py请去对应入口使用。另外记一条激活密钥只含许可证码里购买到的模型不会顺带解锁其他支持者模型。上述规则收敛后都可以压进一张表。一页速查症状到处置动作症状大概率原因处置动作启动窗口卡住后出现红行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），仅供参考