Jasna 视频修复 GUI 实战指南：从首启卡红行到激活支持者模型，一次讲透

Jasna 视频修复 GUI 实战指南从首启卡红行到激活支持者模型一次讲透【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna第一次打开 Jasna启动窗口卡在检查中十几秒弹出一行红字主窗口迟迟不出现——多数新手都卡在这里。Jasna 是一个开源视频修复工具GUI 支持批量喂入素材、实时预览修复效果、单图精修并可激活解锁 UNet 4x、SD 1.5、LTX 等支持者模型。本文每个约束都能在源码里找到对应实现出问题你知道往哪儿查。 首启自检7 项检查逐项拆解安装位置的两个硬条件启动向导出现之前安装位置必须先过关两条都是硬性的装本地磁盘Windows 用 NTFSLinux 用 ext4 / Btrfs / XFS网络磁盘不支持安装路径必须是纯 ASCII 字符出现中文、日文或带重音的字母直接判失败。路径讲究的根源check_ascii_install_path直接对安装目录做encode(ascii)尝试编码失败即不合规逻辑在 jasna/os_utils.py。机械盘同理install_on_hard_disk会判断磁盘类型——Windows 查驱动器的寻道开销Linux 读/sys的rotational标志逻辑在 jasna/os_utils.py。装在机械盘上日志面板会写一条hard_disk_warning警告Jasna 安装在机械硬盘HDD上启动和加载模型都很慢。请把 Jasna 文件夹移到固态硬盘SSD上逻辑在 jasna/gui/app.py。这是警告不是错误但启动和加载模型都会明显变慢。⚠️ 路径装错是一票否决型问题ASCII 检查失败会直接阻塞启动之后所有操作都无从谈起。先cd确认路径再谈其他。自检项到底在查什么检查逻辑集中在 jasna/gui/system_checks.pyrun_system_checks逐项填入结果逐项含义如下检查键查什么失败后果ascii_path安装路径是否纯英文阻塞启动ffprobe能否找到 ffprobe且 FFmpeg 主版本号必须为 8check_ffprobe里major ! 8即失败阻塞启动gpu是否检测到受支持 GPU架构与计算能力阻塞启动cudaCUDA / ROCm 是否可用报告版本与计算能力阻塞启动driverGPU 驱动版本阻塞启动sysmem仅 WindowsNVIDIA 共享内存回退策略仅警告不阻塞amf仅 AMDAMD AMF 视频运行库读写视频必需check_amd_amf_runtime加载libamfrt64.so.1验证阻塞启动注意sysmem是源码里WARNING_ONLY_CHECKS {sysmem}中唯一的键逻辑在 jasna/gui/system_checks.py只有它失败时底部按钮仍显示开始使用其余任何一项失败按钮变成退出点击直接关程序。卡住之后出现的红行是怎么回事检查在后台线程跑UI 每 100ms 轮询一次如果驱动查询卡住或 torch 冷导入特别慢向导等 30 秒就放弃_CHECKS_TIMEOUT_SECONDS 30.0逻辑在 jasna/gui/wizard.py先展示已完成的项。⚠️ 兜底超时后未完成的检查项会被按失败处理而不是通过——evaluate_check_results的文档写得很明确从未运行的检查宁可读成失败也不能显示红行却放行开始使用逻辑在 jasna/gui/system_checks.py。所以看到红行别急着重装环境先确认是不是卡住了 30 秒。检查结果按版本记录只有该版本首次启动才强制走一遍流程通过状态由get_system_check_passed_version与__version__对比决定逻辑在 jasna/gui/app.py之后可随时从页眉手动重跑见文末排错部分。装好跑通之后第一批素材怎么喂进去主窗口中间的项目列表就是答案。 素材怎么喂进队列排序、翻页与单条操作三种添加方式与分页边界把素材放进列表有三条路实现在 jasna/gui/queue_panel.py点添加文件按钮选视频或图片_on_add_files点旁边的文件夹图标整个文件夹一次丢进来_on_add_folder按 jasna/media/media_files.py 的folder_media_in_processing_order递归收集图片在前、视频在后直接把文件拖到列表上enable_file_drop基于TkinterDnD拖文件夹会同样递归展开。处理顺序就是从上到下拖动每个条目的把手即可调整。列表超过 20 条时下方出现翻页箭头分页常量_PAGE_SIZE 20写在源码里逻辑在 jasna/gui/queue_panel.py。所有页都会被依次处理但拖动只能在同一页内——拖拽重排的代码只按当前页的 widget 计算新位置跨页换顺序得先翻页再拖。每个条目上的四个按钮对单个条目JobListItem见 jasna/gui/job_list_item.py剪刀打开区间编辑器只修复视频里的一段仅PENDING状态可编辑播放在内置播放器里打开该视频快速瞄一眼原片仅列表空闲时可用三点或右键打开所在文件夹、复制路径、打开修复后的输出、重新加入队列把已完成/失败/跳过的项目放回列表末尾见 jasna/gui/queue_panel.py 的_requeue_job叉号移除该项目。中途停止后写到一半的文件去哪了处理中每个条目实时刷出进度、FPS 和剩余时间。点停止按钮结束本次处理后当前条目回到等待中状态_mark_stopped把job.status重置为PENDING逻辑在 jasna/gui/processor.py已写入的半成品输出文件则原样留在磁盘上。⚠️ 半成品文件下次再跑时按什么处理取决于基本处理里的文件冲突策略。跑一半就停和覆盖同时开着时别把上次的半成品当成品——它会被下一次输出直接替换。开始按钮会处理列表中所有项目包括已完成和失败的reset_jobs_for_run把所有 job 重置为PENDING逻辑在 jasna/gui/queue_panel.py——改完设置不用重新添加文件直接再按即可。隐含限制列表非空、没有模型在下载、修复预览没占用 GPU 时开始按钮才可用can_start bool(jobs) and not self._preview_gpu_busy and not downloading逻辑在 jasna/gui/app.py。⚙️ 输出文件怎么落地命名模板、冲突策略与预设命名模板与与输入相同的联动结果放哪看队列底部工具栏的两个联动控件点与输入相同每个结果保存在原文件旁边手动输入文件夹路径或点文件夹按钮选别处会自动关闭与输入相同。命名用模板{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。关键体验改保存位置或模板的瞬间任何会覆盖其他文件的条目会立即被高亮标出——_refresh_conflicts对每个PENDING条目重算输出路径并检查output_path.exists()逻辑在 jasna/gui/queue_panel.py不用等跑完才发现重名。同名文件三种处理方式文件冲突选项在基本处理部分下拉框实现在 jasna/gui/settings_sections/basic.py默认值file_conflict auto_rename逻辑在 jasna/gui/models.py选项行为备注自动重命名auto_rename输出改名为xxx (1).mp4这类不冲突的名字unique_path默认值覆盖overwrite直接替换已有文件选中后弹出 ⚠️ 提示file_conflict_overwrite_warning跳过skip已有文件时不动状态标为SKIPPED适合增量补跑⚠️ 选覆盖前确认目标文件确实可以丢——这个选项没有撤销界面给出的唯一防线就是那枚警告图标_on_file_conflict_changed逻辑在 jasna/gui/settings_sections/basic.py。预设一键切换重启还会记住不同画质的片子参数差很远手动来回调很痛苦。设置面板上方的工具栏_build_preset_bar见 jasna/gui/settings_panel.py能把当前全部设置存成一个名字建个1080p 快速再建个4K 最佳质量之后一键来回切。底层是PresetManager逻辑在 jasna/gui/models.py两点值得知道重启后记住上次预设get_last_selected()/set_last_selected()记录你最后一次用的名字持久化在settings.json手动改过设置后面板会标记已修改{name}已修改*见 jasna/gui/locales/zh.py防止你以为还停在某个出厂预设上。出厂预设FACTORY_PRESETS {Default: ...}与用户预设分开管理删除出厂预设会被delete_preset直接拒绝。全局参数归预设管但有两类例外只属于单个视频在区间编辑器里设置的检测模型和检测阈值只保存给当前这一个视频。队列条目通过JobItem.try_set_video_options单独记录这些按视频覆盖的值逻辑在 jasna/gui/models.py且仅在状态为PENDING时生效。也就是说同一个列表里可以混放高阈值粗检和低阈值精检的视频互不干扰。想不产出文件、直接看效果时走实时预览这条路。 不产出文件直接看效果实时预览与单帧精修打开播放器三步操作和一个硬互斥点页眉里的视频播放器_open_video_player逻辑在 jasna/gui/app.py选检测模型、检测阈值需要的话再选二次修复RTX Super Res或UNet 4x默认值为secondary_restoration none逻辑在 jasna/gui/models.py点选择视频挑片子按播放。⚠️ 播放器和批量处理互斥只要有项目在处理、或修复预览在跑点视频播放器没反应页眉按钮也会置灰。源码里就是一句硬检查self._preview_gpu_busy或处理器在跑时直接return逻辑在 jasna/gui/app.py。它是硬性约束不是显示 bug。快捷键左/右方向键前后跳转 30 秒_SEEK_STEP_SECONDS 30.0逻辑在 jasna/gui/video_player.py全屏时鼠标移到底部边缘控制栏自动浮出。改了模型、阈值或二次修复后管线会重建并从当前位置重新播放。秒数反复归零说明什么状态栏显示已提前修复好的秒数后台修复线程往带时间戳的帧缓冲里写帧缓冲最多领先播放 3 秒BUFFER_SECONDS 3.0、BUFFER_FRAMES 90预滚 1.5 秒PREROLL_SECONDS 1.5后才真正开声实现见 jasna/gui/raw_player.py。缓冲满了之后写入端会等空位而不是丢帧——所以一旦修复速度跟不上领先秒数会一路掉光。所以这个秒数反复掉到零就是 GPU 在当前设置下追不上实时播放画面卡顿、音频暂停。此时换低一点的分辨率或模型档位再看别怀疑软件坏了。静态图单帧精修快一个数量级在图像修复静态图片部分点交互式处理图片_open_interactive_image_restore逻辑在 jasna/gui/app.py打开一个左右对比视图窗口实现在 jasna/gui/interactive_image_restore.py上一张 / 下一张逐张浏览换种子立刻重新渲染出图原图、遮罩、结果三种视图切换满意才点保存只留你喜欢的。为什么快渲染在后台 worker 线程按单帧进行帧已预先准备好换种子只是同一帧上的一次前向推理——不像整任务那样把解码、修复、编码全走一遍。修图这种多试几次参数的场景快一个数量级。 出问题往哪儿查日志、状态条与激活排错重跑系统检查、导出日志与底部状态条换了驱动、换了显卡、装了新 FFmpeg 之后从页眉再次运行系统检查_show_system_check逻辑在 jasna/gui/app.py即可——检查按版本记录通过状态决定某个版本要不要重新走流程。⚠️ AMD 用户系统检查还会查 AMF 视频运行库。Linux 上需要手动安装一次官方文档 docs/zh/gui.md 给出了curl下载amf_installer的安装命令装完重启 Jasna 再查一次。底部工具栏的日志按钮展开 LogPanel逻辑在 jasna/gui/log_panel.py实时滚动可按 debug / info / warning / error 过滤导出保存最后5000 行环形缓冲deque(maxlen_MAX_LOG_ENTRIES)_MAX_LOG_ENTRIES 5000超出自动丢最旧的写为.txt。反馈问题前先导出日志基本能省掉一大轮复现了吗。处理时底部状态条显示 GPU 利用率、显存、内存、CPU。数据来自read_system_statsNVIDIA 解析nvidia-smiAMD 读 sysfs轮询线程每 1.5 秒采样一次self._system_stats_stop.wait(1.5)逻辑在 jasna/gui/app.py。跑任务时瞄一眼这排数字显存吃紧就该降档。激活两条路径在线与手动支持者模型UNet 4x、SD 1.5、LTX需要激活。页眉打开激活 Jasna_open_license_dialog逻辑在 jasna/gui/app.py所有网络与验签操作都在后台线程执行_start起 daemon 线程逻辑在 jasna/gui/activation_worker.py不卡 UI。在线激活默认输入许可证码点在线激活。上传的只有许可证码和机器密钥之后 Jasna 完全离线工作手动激活断网机器或在线失败时复制机器密钥machine.machine_key(cloud_workspaceFalse)基于本机硬件生成在任意联网设备打开激活页面填入机器密钥 许可证码拿到激活密钥粘贴回 Jasna点激活start_activation写入本地 license。名额规则一个许可证码最多用于3 台电脑或云工作区界面提示license_service_slots_full即已用完 3 个注册名额见 jasna/gui/locales/zh.py。占名额更换主板Windows、重新安装 Linux、个别没有真正主板 ID 的 Windows 机换系统盘。不占名额重装 Windows、更换显卡 / 硬盘 / 内存、同一台机器重复激活。已激活后打开该窗口会联网显示已用名额如 2 / 3查不到时重开窗口重试即可修复功能不依赖这次查询。激活密钥被拒怎么排查按顺序过一遍机器密钥是不是完整复制的激活密钥有没有截断重新完整复制。密钥是不是为旧版 Jasna 生成的旧版密钥不再通用需回购买渠道换新密钥。⚠️ 你手里的密钥是不是以JW1-开头那是云端 CLI 专用身份密钥GUI 直接粘贴会被明确拒绝start_activation和start_online_activation都会检查前缀并抛出license_cloud_cli_only逻辑在 jasna/gui/activation_worker.py——请去正确的入口使用。另外记住一条激活密钥只包含你许可证码里购买的模型不会顺带解锁其他支持者模型。收尾速查症状 → 原因 → 去哪儿查症状大概率原因去哪儿查启动窗口卡住后报红行30 秒兜底检查没跑完被按失败处理页眉重跑系统检查首次启动报路径错误安装路径含非英文字符迁移到纯 ASCII 路径启动日志有hard_disk_warning装在机械盘上迁到 SSDffprobe 检查不过FFmpeg 主版本号不是 8换装 FFmpeg 8输出文件名带(1)后缀文件冲突自动重命名生效中基本处理 → 文件冲突列表高亮某条目命名模板会覆盖其他文件改模板或保存位置停止后磁盘上有半成品文件输出文件残留按文件冲突策略处理后再跑播放器秒数反复归零GPU 修复速度 播放速度降分辨率 / 换模型档位点视频播放器无反应队列或预览占用 GPU等处理结束或停止激活提示license_cloud_cli_only粘了云端 CLI 密钥JW1-开头换回本地激活密钥主线总结装对位置ASCII 路径 SSD→ 批量喂入队列分页内拖动排序→ 按预设落盘模板 冲突策略→ 单视频微调按视频覆盖检测参数→ 实时预览验证效果注意 GPU 互斥与秒数归零→ 静态图单帧精修 → 日志/状态条排错 → 激活解锁支持者模型。界面里的每个约束分页、互斥、归零提示、名额校验都能在源码里找到一一对应的实现。官方文档入口docs/zh/gui.md【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考