支持者模型的正版许可证码只能通过 Buy Me a Coffee、Unifans 或 闲鱼 获取。

English | 日本語 | 中文

Jasna 修复视频和图片中的马赛克。Jasna 免费，提供简单的应用和命令行，在你的 GPU 上运行。

从这里开始

• Jasna 能做什么
• 要求
• 快速开始
• 帮助和社区
• 支持本项目（支持者模型）

高级

• Jasna 如何工作
• 命令行
• 所有指南
• 基准测试
• 许可证
• 致谢

• 找出视频中的马赛克并修复。画面的其他部分不会被改动。
• 两个修复模型：快速的 BasicVSR++（免费），以及慢但细节更多的 LTX（支持者专享，支持 NVIDIA 或兼容的 AMD 显卡；Windows AMD LTX 为测试版）。
• 在区间编辑器中只修复你选择的部分，并可预览。
• 可用于 VR180 视频和静态图片（支持者专享的 SD 1.5 模型）。
• 在视频播放器中实时观看修复后的视频，不用生成文件。

• NVIDIA GTX 16 系列 / RTX 20 系列或更新，并使用较新的驱动 （Windows 610 或更新，Linux 580 或更新）。GTX 10 系列及更旧的显卡无法使用。
• 或 AMD Radeon RX 7000/9000（实验性）。
• 本地磁盘上的一个文件夹，路径中不能有中文、日文、带重音的字母或其他非英文字符。

1. 下载适合你的系统和 GPU 的发行包。
2. 解压到一个文件夹，路径中不能有中文、日文、带重音的字母或其他非英文字符。
3. 启动应用：

   • Windows：双击 jasna.exe。

   • Linux NVIDIA：运行 jasna 文件。

   • Linux AMD：先安装一次 AMD 的 AMF 视频运行库。我们测试过 AMF 26.20：

     curl -fLO https://repo.radeon.com/amf/26.20/amf_installer_26.20.zip
     unzip amf_installer_26.20.zip
     sudo bash amf_installer_26.20.sh

     按提示同意 AMD 的许可协议，然后运行 run_jasna_amd.sh。 如果使用 Distrobox，请在运行 Jasna 的同一个容器内安装 AMF。

4. 添加视频，选择设置，点击界面底部的 ▶ 按钮。

第一个任务会很慢。 在 NVIDIA 上，Jasna 会先为你的 GPU 准备模型。这大约需要 15–60 分钟，只会发生一次。在此期间请关闭其他应用，也不要使用电脑。更新 Jasna 时， 把 model_weights 文件夹复制到新版本中，这样就不用再等一次。

0.12 的 LTX 更新： 从 0.11.3 复制的模型需要重新下载，NVIDIA 也一样。 请按 ▶ 并同意更新模型。原来的许可证代码和共用 VAE 文件仍然可用。 手动下载模型时，Jasna 0.12 请使用 0.12.0 分支，0.11.3 或更早版本请使用 main。

每个设置都有提示：把鼠标移到 ⓘ 图标上即可查看。GPU 显存不足？降低 最大片段大小，例如从 90 降到 60。见调整显存和 GPU 占用。

• 应用指南：队列、预设、输出文件名、视频播放器和激活。
• SLS Discord：示例、帮助和设置。 Jasna 有一个新频道； 以前的帖子保留在旧频道（已归档）。 请友善交流，别太离谱。
• 遇到问题？点击应用底部的日志，再点击导出保存日志文件。求助时请附上它。

Jasna 是免费的。你的支持用于训练新模型，主要是租用 GPU。支持者会获得支持者模型的 许可证码：

**截至 2026 年 10 月 14 日（含当天）**累计支持 15 美元或以上的支持者可免费获得 LTX。

选择 LTX 之前：

• 看看这些 LTX 示例：1、2、3、4、5、6、7、8。 想看更多示例，可以浏览 SLS Discord 的新频道和 旧频道（已归档）。
• 在你的电脑上用**试用模式（速度测试）**运行 LTX。它是免费的，可以看出你的 GPU 能否运行 LTX、 需要多长时间。视频不会被修复。见 LTX 需要什么。

更多示例： UNet 4x、 SD 1.5、 更多 SD 1.5。

许可证码只能从这里获得：

• Buy Me a Coffee（也可以用加密货币）
• Unifans
• 中国用户：闲鱼 (Xianyu)，见下文

国内用户可以直接在闲鱼购买，得到的许可证码和其他渠道一样。闲鱼使用单独的人民币本地价格，以商品页面为准。

1. 用闲鱼 App 扫描下面的二维码，会打开卖家的闲鱼主页，在主页上购买。
2. 下单后，卖家会发给你许可证码。
3. 按照下面的如何激活在 Jasna 中激活。

只有这个闲鱼卖家是官方的。闲鱼上其他卖 Jasna 的人都不是官方卖家。

其他出售 Jasna、许可证码或修改版文件的人都是骗子：他们的密钥无法使用，他们的文件 可能在你的电脑上运行隐藏代码。请只从 GitHub 下载 Jasna。

1. 在上面的任一页面支持。你会收到一个许可证码。
2. 在 Jasna 中打开激活 Jasna，输入许可证码，点击在线激活。
3. 这台电脑没有网络，或激活失败？选择手动，见 激活支持者模型。

一个许可证码可用于 3 台电脑或云工作区。激活后，Jasna 可以离线使用。租用的 GPU： 见云 GPU。

激活后，打开激活 Jasna会联网查询并显示已用设备名额。

什么算新电脑：Windows 上是更换主板；Linux 上是重新安装 Linux。每种情况都会占用 3 个名额中的 1 个。重装 Windows 或更换显卡、硬盘、内存不会占用新名额：用同一个 许可证码重新激活即可。少数 Windows 电脑的主板没有真正的 ID，在这些电脑上更换 系统盘也算新电脑。

Jasna 0.10 的邮箱和密钥已不能使用，请向购买的地方申请新的许可证码。

从读取视频到保存，几乎所有步骤都在 GPU 上运行。

1. 解码：在 GPU 上解码视频（NVIDIA 上用 NVDEC，AMD 上用 AMF）。
2. 检测：在每一帧中查找马赛克（默认模型 rfdetr-v6）。
3. 跟踪：跟踪每个马赛克，把它的帧分成片段（最多最大片段大小帧）。 片段在镜头切换处结束，所以不会混合两个不同的镜头。
4. 修复：用 BasicVSR++ 把每个片段修复成 256x256 的画面。片段之间有一点重叠， 所以片段之间不会有明显的跳变。
5. 可选的二次修复（UNet 4x、RTX Super Res 或 Topaz TVAI）让修复后的画面 更大、更清晰。
6. 融合：把修复后的画面放回原始帧。只有马赛克区域会改变。
7. 编码：用 GPU 编码器编码（NVIDIA 上用 NVENC，AMD 上用 AMF）。音频直接复制（只有输出格式 不支持该音频时才会重新编码）。

第一个任务很慢，因为第 2 步和第 4 步的模型（如果使用 UNet 4x，也包括它）要为你的 GPU 做准备（仅限 NVIDIA）。结果保存在 model_weights 中，之后会重复使用。你可以把它复制到 新版本的 Jasna 中。

LTX 的工作方式不同。它会把视频处理 4 遍：查找马赛克、准备、用扩散模型修复、保存。它更慢，但能加入更多真实细节。 画质可选：标准（默认，最快）、良好（慢约 1.5 倍）、高画质（慢约 2.5 倍）、顶级（慢约 5 倍）。见 选择模型。

LTX 任务支持暂停与继续，包括区间任务和自动分配任务。见暂停与继续。

更新后，Jasna 可能会要求重新下载所选的 LTX 模型。原来的许可证代码仍然可用。

命令行可以做应用能做的大部分事情（视频播放器、LTX 种子预览、遮罩建议和交互式图片处理除外）。

# 一个视频
jasna --input input.mp4 --output output.mkv

# 一张图片
jasna --input photo.png --output restored.png

# 整个文件夹
jasna --input input_folder --output output_folder

jasna --help 会列出所有选项。见 CLI 参考。

• 使用 GUI：队列、预设、输出文件名、视频播放器、激活。
• 选择模型：检测模型、BasicVSR++ 还是 LTX、二次修复、 用于图片的 SD 1.5。
• 只修复视频的一部分：区间编辑器、马赛克扫描、 仅大马赛克用 LTX。
• VR180 视频：如何处理左右并排 VR。
• 调整显存和 GPU 占用：片段大小、时间重叠、显存不足时 怎么办。
• 高级处理：降噪、60→30 FPS、色彩 LUT、 锐化、编码器质量、队列完成后的操作。
• 流媒体：在浏览器或 Stash 中观看。
• 云 GPU：在租用的 GPU（RunPod、Vast）上运行 Jasna。
• CLI 参考：所有命令行选项。
• 从源代码运行（英文）：面向开发者。从源代码运行时可以使用免费的 BasicVSR++；激活和支持者模型需要官方发行版。

用 BasicVSR++ 修复一整段 3:22 视频所需的时间，RTX 5090（Linux）。越低越好。

Jasna 的公开应用程序源代码采用 AGPL-3.0。模型和捆绑依赖项保留各自的许可条款。 请参阅许可与源代码范围、 模型声明和 发行版源代码对应表。

• Lada（Codeberg）：Jasna 受 Lada 启发， 部分地方也基于 Lada。Jasna 使用的 mosaic_restoration_1.2 模型由 Lada 作者 ladaapp 训练。
• ZeLeFans：感谢提供 VR 检测模型，以及对马赛克形状和 VR 投影的详细分析。