★ FEATURED ARTICLE Jasna GUI 视频修复实战指南从自检到激活的完整操作与避坑路线【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是一款开源的视频修复工具GUI 版支持批量素材入队、实时修复预览、静态图片精修并通过激活解锁 UNet 4x、SD 1.5、LTX 等支持者模型。这篇文章沿真实使用路线展开先把安装位置装对让自检通过再把素材喂进队列、定好输出命名用播放器验证效果静态图逐帧精修出问题时按清单排查最后激活支持者模型。每个约束都能在源码里定位到实现出问题你知道往哪儿查。 安装位置与自检Jasna 启动前要过的两道硬门槛纯 ASCII 路径与本地磁盘两道闸门启动向导之前安装位置有两条硬性要求装错自检直接判失败路径必须纯 ASCII不允许中文、日文或带重音的字母。自检对安装目录做 ASCII 编码尝试编码失败即判不合规check_ascii_install_path逻辑在 jasna/os_utils.py。只装本地磁盘装在了机械盘上时启动时install_on_hard_disk会判断磁盘类型Windows 查驱动器寻道开销Linux 读/sys的rotational标志日志面板写一条hard_disk_warning警告——启动和加载模型都会明显变慢建议迁到 SSD。七项自检逐条过查什么、失败会怎样检查逻辑集中在 jasna/gui/system_checks.py逐项结果检查键查什么失败后果ascii_path安装路径是否纯 ASCII阻塞启动ffprobe能否找到 ffprobe 且 FFmpeg 主版本号恰好为 8阻塞启动gpu是否有受支持 GPUNVIDIA 需计算能力 7.5AMD 架构须匹配构建阻塞启动cudaCUDA / ROCm 是否可用报告版本与计算能力阻塞启动driverGPU 驱动版本Linux 需 580Windows 需 610阻塞启动sysmem仅 WindowsNVIDIA 共享内存回退策略读 DRS 配置仅警告不阻塞amf仅 AMDAMD AMF 视频运行库读写视频必需阻塞启动注意sysmem是源码WARNING_ONLY_CHECKS中唯一的键只有它失败时底部按钮仍可点开始使用其余任何一项失败按钮就变成退出。30 秒兜底超时没跑完的项按失败算检查在后台线程里跑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之后可随时手动重跑见后文排错部分。装好跑通之后素材怎么进队列 素材队列管理三种添加方式、20 条分页与页内拖拽添加文件、添加文件夹、拖文件三条入队路把素材放进列表有三条路实现在 jasna/gui/queue_panel.py点添加文件选视频或图片点旁边的文件夹图标整个文件夹一次丢进来递归扫描图片排前、视频排后直接把文件拖到列表上基于 tkinterdnd2。处理顺序就是从上到下拖动每个条目的把手调整但拖动只能在同一页内——列表超过 20 条时下方出现翻页箭头分页常量_PAGE_SIZE 20跨页换顺序得先翻页再拖正在处理中的条目禁止拖动。队列条目的四个按钮各管什么对单个条目JobListItem见 jasna/gui/job_list_item.py✂️ 剪刀打开区间编辑器只修复视频里的一段图片条目无此按钮▶️ 播放在内置播放器里打开该视频快速瞄一眼原片⋮ 三点或右键打开所在文件夹、复制路径、打开修复后的输出、重新加入队列把已完成/失败/跳过的项目放回列表末尾✕ 叉号移除该项目。开始按钮会处理列表中所有项目包括已完成和失败的——改完设置后不用重新添加文件直接再按 ▶ 即可。隐含限制列表非空、没有模型在下载、修复预览没占用 GPU 时开始按钮才可用。停止之后写到一半的输出文件去向处理中每个条目实时刷出进度、FPS 和剩余时间。停止按钮结束本次处理后当前条目回到等待中状态_mark_stopped逻辑在 jasna/gui/processor.py已写入的半成品输出文件原样留在磁盘上。下次再跑时它按什么处理取决于基本处理里的文件冲突策略——跑一半就停和覆盖同时开着时注意别把上次的半成品当成品。队列排好下一步是定输出落盘的命名与冲突规则。 输出文件落地命名模板、与输入相同联动与冲突三选一{original}模板与保存位置联动队列上方工具栏有两个联动控件点与输入相同每个结果保存在原文件旁边手动输入文件夹路径或点文件夹按钮选别处会自动关闭与输入相同想回到原片旁再点一次即可。命名用模板{original}代表输入文件名不含扩展名默认模板是{original}_restored.mp4DEFAULT_OUTPUT_PATTERN定义在 jasna/gui/models.py所以my_video.mp4出片就是my_video_restored.mp4。替换逻辑很直白folder_output_path里就是output_pattern.replace({original}, 输入文件名)逻辑在 jasna/media/media_files.py。关键体验改保存位置或模板的瞬间任何会覆盖其他文件的条目会立即被高亮标出不用等跑完才发现重名。文件冲突三种策略怎么选文件冲突下拉框在基本处理部分实现在 jasna/gui/settings_sections/basic.py选项行为备注自动重命名auto_rename给新输出换个不冲突的名字依次追加 (1)、(2) 编号默认值覆盖overwrite直接替换已有文件选中后弹出 ⚠️ 提示现有文件将被永久替换跳过skip已有文件时不动条目记为已跳过适合增量补跑⚠️ 选覆盖前确认目标文件确实可以丢——这个选项没有撤销界面给出的唯一防线就是那枚警告图标。预设记住上次状态与已修改标记不同画质的片子参数差很远手动来回调很痛苦。设置面板上方的工具栏见 jasna/gui/settings_panel.py能把当前全部设置存成一个名字建个1080p 快速再建个4K 最佳质量之后一键来回切。底层是PresetManagerjasna/gui/models.pyget_last_selected()/set_last_selected()记录你最后一次用的预设重启后自动恢复手动改过设置后面板会标记已修改防止你以为还停在某个出厂预设上出厂预设与用户预设分开管理删出厂预设会被拒绝。全局参数归预设管但有一类例外只属于单个视频在区间编辑器里设置的检测模型和检测阈值只保存给当前这一个视频。队列条目通过JobItem.try_set_video_options单独记录这些按视频覆盖的值且仅在状态为PENDING时生效。同一个列表里可以混放高阈值粗检和低阈值精检的视频互不干扰。不想产出文件、直接看效果时走实时预览这条路。️ 实时预览玩家器打开步骤与批量处理互斥的原因打开玩家器的三步操作与硬互斥点页眉里的视频播放器_open_video_player见 jasna/gui/app.py选检测模型、检测阈值需要的话再选二次修复RTX Super Res或UNet 4xTopaz 在玩家器中不可用点选择视频挑片子按播放。⚠️ 玩家器和批量处理互斥只要有项目在处理、或修复预览在跑点视频播放器没反应页眉按钮也会置灰。源码里就一句硬检查self._preview_gpu_busy或处理器在跑时直接return。它是硬性约束不是显示 bug。快捷键空格播放/暂停左/右方向键前后跳转 30 秒_SEEK_STEP_SECONDS 30.0全屏时鼠标移到底部边缘控制栏自动浮出。改了模型、阈值或二次修复后会从当前位置重新播放管线重建。另外记住一条设计决定播放器永远用 BasicVSR不走 LTX。3 秒预缓冲秒数反复归零意味着什么状态栏显示已提前修复好的秒数后台修复线程往带时间戳的帧缓冲里写帧缓冲最多领先播放 3 秒BUFFER_SECONDS 3.0上限BUFFER_FRAMES 90预滚 1.5 秒PREROLL_SECONDS后才真正开声缓冲写满时后台修复暂停等待实现见 jasna/gui/raw_player.py。所以这个秒数反复掉到零就是 GPU 在当前设置下追不上实时播放画面卡等、音频暂停。⚠️ 别怀疑软件坏了——此时换低一点的分辨率或模型档位再看秒数反复归零就是界面给出的当前设置跑不动实时的最直接信号。预览验证完参数静态图就该逐张精修了。 静态图精修单帧渲染为什么比整任务快一个数量级左右对比视图三种视图与换种子在图像修复静态图片部分点交互式处理图片打开一个左右对比视图窗口实现在 jasna/gui/interactive_image_restore.py上一张 / 下一张逐张浏览换种子立刻重新渲染出图三种视图切换原图、遮罩、结果满意才点保存只留你喜欢的。同帧前向推理替代整条管线为什么快渲染在后台 worker 线程按单帧进行帧已预先准备好换种子只是同一帧上的一次前向推理——不像整任务那样把解码、修复、编码全走一遍。修图这种多试几次参数的场景快一个数量级。效果满意准备量产或者中途出了问题就按这份清单排查。️ 排错清单从系统检查到日志导出按顺序过第一步重跑系统检查按版本记录换了驱动、换了显卡、装了新 FFmpeg 之后从页眉再次运行系统检查_show_system_check即可——检查按版本记录通过状态决定某个版本要不要重新走流程。⚠️ AMD 用户系统检查还会查 AMF 视频运行库。Windows 上它随驱动自带Linux 上需要手动安装一次官方文档 docs/zh/gui.md 给出了安装命令装完重启 Jasna 再查一次。第二步展开日志面板并导出底部工具栏的日志按钮展开 LogPaneljasna/gui/log_panel.py实时滚动可按 debug / info / warning / error 过滤导出保存最后5000 行环形缓冲deque(maxlen5000)超出自动丢最旧的写为.txt。反馈问题前先导出日志基本能省掉一大轮复现了吗。第三步瞄一眼底部状态条处理时底部状态条显示 GPU 利用率、显存、内存、CPU。数据来自read_system_statsNVIDIA 解析nvidia-smiAMD 读 sysfs轮询线程每 1.5 秒采样一次。跑任务时瞄一眼这排数字显存吃紧就该降档。问题排完最后一步是解锁支持者模型。 激活支持者模型在线与手动两条路径及 3 台设备名额在线激活与手动激活怎么操作支持者模型UNet 4x、SD 1.5、LTX需要激活。页眉打开激活 Jasna对话框在 jasna/gui/components.py所有网络与验签操作都在后台线程执行jasna/gui/activation_worker.py不卡 UI。在线激活默认输入许可证码点在线激活。上传的只有许可证码和机器密钥之后 Jasna 完全离线工作手动激活断网机器或在线失败时复制机器密钥基于本机硬件生成在任意联网设备打开激活页面或点打开激活页面填入机器密钥 许可证码拿到激活密钥粘贴回 Jasna点激活。3 台设备名额哪些操作占名额一个许可证码最多用于3 台电脑或云工作区界面提示license_service_slots_full即3 个名额全部占用。占名额更换主板Windows、重新安装 Linux、个别没有真正主板 ID 的 Windows 机换系统盘。不占名额重装 Windows、更换显卡 / 硬盘 / 内存、同一台机器重复激活——重新激活即可。已激活后打开该窗口会联网显示已用名额如 2 / 3查不到时重开窗口重试即可修复功能不依赖这次查询。密钥被拒JW1-前缀与旧版密钥按顺序过一遍机器密钥是不是完整复制的激活密钥有没有截断密钥是不是为旧版 Jasna 生成的——旧版密钥不再通用需回购买渠道换新密钥。⚠️ 你手里的密钥是不是以JW1-开头那是云端 CLI 专用身份密钥GUI 直接粘贴会被明确拒绝license_cloud_cli_only见 jasna/gui/activation_worker.py)——请去正确的入口使用。另外记住一条激活密钥只包含你许可证码里购买的模型不会顺带解锁其他支持者模型。从安装位置到激活名额这条路线可以收束成一句话装对位置让自检一次通过队列决定处理顺序模板与冲突策略决定成片落点预览和静态图窗口让效果在出文件前可见日志、状态条与重跑自检是出问题时的三件工具激活把支持者模型接进来。界面里的每个约束——分页、互斥、归零提示、名额校验——都能在源码里找到一一对应的实现。官方文档入口docs/zh/gui.md。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
