Kruk2/jasna
Kruk2/jasna has 4,600 GitHub stars and 379 forks. GitHot measured +50 stars in 24 hours, +408 in 7 days, and +1,096 in 15 days. Last checked 2026-11-07 02:57 UTC. Last push 2026-11-01.
视频修复工具
实测星标增长
- 24小时
- +50
- 7天
- +408
- 15天
- +1,096
- 1个月
- 正在收集历史
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
README.zh.md
原文支持者模型的正版许可证码只能通过 Buy Me a Coffee、Unifans 或 闲鱼 获取。
Jasna
Jasna 修复视频和图片中的马赛克。Jasna 免费，提供简单的应用和命令行，在你的 GPU 上运行。
目录
从这里开始
- Jasna 能做什么
- 要求
- 快速开始
- 帮助和社区
- 支持本项目（支持者模型）
高级
Jasna 能做什么
- 找出视频中的马赛克并修复。画面的其他部分不会被改动。
- 两个修复模型：快速的 BasicVSR++（免费），以及慢但细节更多的 LTX（支持者专享）。
- 在区间编辑器中只修复你选择的部分，并可预览。
- 可用于 VR180 视频和静态图片（支持者专享的 SD 1.5 模型）。
- 在视频播放器中实时观看修复后的视频，不用生成文件。
要求
- NVIDIA GTX 16 系列 / RTX 20 系列或更新，并使用较新的驱动 （Windows 610 或更新，Linux 580 或更新）。GTX 10 系列及更旧的显卡无法使用。
- 或 AMD Radeon RX 7000/9000（实验性）。RX 6000 及更早的显卡不能用。
- 本地磁盘上的一个文件夹，路径中不能有中文、日文、带重音的字母或其他非英文字符。
更多细节
- NVIDIA：你的 GPU 在 NVIDIA 的 GPU 表格 中需要计算能力 7.5 或更高。
- AMD：见下表。支持 UNet 4x 二次修复。
- 磁盘格式：Windows 用 NTFS；Linux 用 ext4、Btrfs、XFS 或 ZFS。不支持网络磁盘。请使用 固态硬盘（SSD）；在机械硬盘（HDD）上 Jasna 启动和加载模型都很慢。
- LTX 需要 NVIDIA RTX 或 AMD Radeon RX 7000/9000 显卡，至少 8 GB 显存和 16 GB 内存。见 LTX 需要什么。
| AMD 显卡 | Jasna | LTX |
|---|---|---|
| Radeon RX 9060/9070、Radeon AI PRO R9700 | 支持 | 支持（Windows 为测试版） |
| Radeon RX 7600–7900、Radeon PRO W7000 | 支持 | 支持（Windows 为测试版） |
| Radeon 740M/760M/780M/880M/890M、Ryzen AI Max（8050S/8060S） | 支持（未测试） | 支持（未测试） |
| Radeon RX 6000 及更早、Radeon 820M/840M/860M | 不支持 | 不支持 |
快速开始
- 下载适合你的系统和 GPU 的发行包。
- 解压到一个文件夹，路径中不能有中文、日文、带重音的字母或其他非英文字符。
- 启动应用：
Windows：双击
jasna.exe。AMD 用户请先安装 适用于 ROCm 10.1 的 AMD 驱动 （26.10.41.05，下载 .exe）， 然后重启电脑。无需安装 ROCm。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。
- 添加视频，选择设置，点击界面底部的 ▶ 按钮。
第一个任务会很慢。 在 NVIDIA 上，Jasna 会先为你的 GPU 准备模型。这大约需要
15–60 分钟，只会发生一次。在此期间请关闭其他应用，也不要使用电脑。更新 Jasna 时，
把 model_weights 文件夹复制到新版本中，这样就不用再等一次。更新后，LTX 仍可能要求重新下载模型。
在 AMD 上，只有首次使用 UNet 4x 时需要这样准备。
每个设置都有提示：把鼠标移到 ⓘ 图标上即可查看。GPU 显存不足？降低
最大片段大小，例如从 90 降到 60。见调整显存和 GPU 占用。
帮助和社区
- 应用指南：队列、预设、输出文件名、视频播放器和激活。
- SLS Discord：示例、帮助和设置。 Jasna 有一个新频道； 以前的帖子保留在旧频道（已归档）。 请友善交流，别太离谱。
- 遇到问题？点击应用底部的日志，再点击导出保存日志文件。求助时请附上它。
支持本项目
Jasna 是免费的。你的支持用于训练新模型，主要是租用 GPU。支持者会获得支持者模型的 许可证码：
| 支持 | 模型 |
|---|---|
| 累计 15 美元或以上 | UNet 4x：让修复区域更清晰。 SD 1.5：用于静态图片的实验性模型。 |
| 25 美元 | UNet 4x 和 SD 1.5，再加上 LTX：比 BasicVSR++ 慢很多，但细节更多。包含这个 LTX 模型以后的更新。 |
**截至 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)，见下文
在闲鱼购买
国内用户可以直接在闲鱼购买，得到的许可证码和其他渠道一样。闲鱼使用单独的人民币本地价格，以商品页面为准。
- 用闲鱼 App 扫描下面的二维码，会打开卖家的闲鱼主页，在主页上购买。
- 下单后，卖家会发给你许可证码。
- 按照下面的如何激活在 Jasna 中激活。
只有这个闲鱼卖家是官方的。闲鱼上其他卖 Jasna 的人都不是官方卖家。
其他出售 Jasna、许可证码或修改版文件的人都是骗子：他们的密钥无法使用，他们的文件 可能在你的电脑上运行隐藏代码。请只从 GitHub 下载 Jasna。
如何激活
- 在上面的任一页面支持。你会收到一个许可证码。
- 在 Jasna 中打开激活 Jasna，输入许可证码，点击激活。
一个许可证码可同时在 3 台设备上使用。再次打开激活 Jasna即可查看正在使用的设备数。
- 有 TPM 2.0 安全芯片的电脑（大多数 Windows 11 电脑）：在线激活一次后，Jasna 可以离线使用。这台电脑占用 3 个名额中的 1 个。Windows 可能会请求一次权限。 更换主板或重置安全芯片算新电脑。
- 其他电脑、租用的 GPU 和 Docker：使用支持者模型时需要联网。只有 Jasna 运行时才占用设备名额。见云 GPU。
- 有安全芯片的 Linux：如需离线使用，请运行
sudo usermod -aG tss $USER， 重启电脑后再激活一次。
从 Jasna 0.11 升级？第一次使用支持者模型时激活会自动沿用，同一台电脑上的 Jasna 0.11 仍可继续使用。
Jasna 0.10 的邮箱和密钥已不能使用，请向购买的地方申请新的许可证码。
高级
Jasna 如何工作
从读取视频到保存，几乎所有步骤都在 GPU 上运行。
- 解码：在 GPU 上解码视频（NVIDIA 上用 NVDEC，AMD 上用 AMF）。
- 检测：在每一帧中查找马赛克（默认模型
rfdetr-v6）。 - 跟踪：跟踪每个马赛克，把它的帧分成片段（最多最大片段大小帧）。 片段在镜头切换处结束，所以不会混合两个不同的镜头。
- 修复：用 BasicVSR++ 把每个片段修复成 256x256 的画面。片段之间有一点重叠， 所以片段之间不会有明显的跳变。
- 可选的二次修复（UNet 4x、RTX Super Res 或 Topaz TVAI）让修复后的画面 更大、更清晰。
- 融合：把修复后的画面放回原始帧。只有马赛克区域会改变。
- 编码：用 GPU 编码器编码（NVIDIA 上用 NVENC，AMD 上用 AMF）。音频直接复制（只有输出格式 不支持该音频时才会重新编码）。
在 NVIDIA 上，第一个任务会为你的 GPU 准备第 2 步和第 4 步的模型（如果使用 UNet 4x，也包括它）；
在 AMD 上只准备 UNet 4x。结果保存在 model_weights 中，之后会重复使用。你可以把它复制到
新版本的 Jasna 中。
LTX 的工作方式不同。它会把视频处理 4 遍：查找马赛克、准备、用扩散模型修复、保存。它更慢，但能加入更多真实细节。 画质可选：基础（比标准快约 1.3 倍）、标准（默认）、良好（慢约 1.5 倍）、高画质（慢约 2.5 倍）、顶级（慢约 5 倍）。见 选择模型。
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）。越低越好。
| 输入 | Lada 0.11.0 | Jasna v0.9.1 |
|---|---|---|
| 720p H.264 | 01:47 | 00:32（快 3.4 倍） |
| 1080p H.264 | 02:02 | 00:34（快 3.6 倍） |
| 2160p H.264 | 04:56 | 01:03（快 4.7 倍） |
GPU 显存、旧版本和测试方法
GPU 显存占用（典型/峰值，单位 GB）。— 表示未测量。Lada 占用的 GPU 显存比 Jasna 少。
| 输入 | Lada | v0.4.1 | v0.5.0 | v0.9.0 | v0.9.1 |
|---|---|---|---|---|---|
| 720p H.264 8-bit | 1.8/3.1 | 17.6/19.9 | 8.6/9.0 | 8.6/9.1 | 4.2/4.6 |
| 1080p H.264 8-bit | 2.0/3.3 | 18.9/21.4 | 9.5/10.2 | 9.3/10.1 | 4.8/5.6 |
| 2160p H.264 8-bit | 2.6/4.1 | 26.0/30.5 | 12.9/15.0 | 11.4/15.4 | 7.2/10.9 |
| 8K VR HEVC 60 fps（15 秒） | — | — | — | 17.1/18.3 | — |
旧版本的时间（720p / 1080p / 2160p：v0.4.1 为 01:35 / 01:46 / 03:23；v0.5.0 为 00:45 / 00:47 / 01:22；v0.9.0 为 00:34 / 00:39 / 01:15；8K VR：00:34）、测试设置、 内存占用以及所有编码，见完整基准测试报告。 较早的完整长视频：旧版报告。
许可证
Jasna 的公开应用程序源代码采用 AGPL-3.0。模型和捆绑依赖项保留各自的许可条款。 请参阅许可与源代码范围、 模型声明和 发行版源代码对应表。
致谢
- Lada（Codeberg）：Jasna 受 Lada 启发，
部分地方也基于 Lada。Jasna 使用的
mosaic_restoration_1.2模型由 Lada 作者 ladaapp 训练。 - ZeLeFans：感谢提供 VR 检测模型，以及对马赛克形状和 VR 投影的详细分析。