Jasna VR180 视频自动修复实战指南：分眼处理、识别规则与按片商投影选择

Jasna VR180 视频自动修复实战指南：分眼处理、识别规则与按片商投影选择

【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna

处理过并排（Side-by-Side）VR180 视频的人都知道痛点：直接把 3840×1920 的宽画面丢进 2D 修复模型，模型看到的是"两眼挤在一起"的变形图，马赛克经常修不干净。Jasna 的 VR180 能力正是为此而生——它会自动识别并排 VR 画面，把左眼、右眼拆成两路分别检测与修复，再拼回原尺寸输出；同时按片商（工作室）代号自动挑选每个马赛克区域的展平投影，全程不用你手动配置。识别、投影路由、分眼适配的核心逻辑都在 jasna/vr180.py 里，投影计算在 jasna/vr_projection.py，官方中文说明见 docs/zh/vr180.md。

四步出片：默认设置 + VR 专用检测模型跑通 VR180 修复

第一次修 VR180，照着这四步走就行：

1. 像加普通视频一样把 VR 文件加入任务，不需要任何预处理；
2. 在高级设置里把VR180 模式保持为自动（推荐）（该选项位于 jasna/gui/settings_sections/advanced.py 渲染的设置面板）；
3. 检测模型选内置的rfdetr-vr-v1——VR180 专用，效果最佳；zelefans-vr-yolo-v2是另一个可选模型，需要单独下载（模型清单见 docs/zh/models.md）；
4. 开始处理。只想修一部分？用区间编辑器指定区间即可。

一个容易踩的坑：修复模型（restorer）要用BasicVSR++（默认）——LTX 修复器不支持左右并排 VR 输入，选中会直接报错提示换 BasicVSR++。

Jasna 靠什么判定"这是 VR180"：三条自动规则与手动强制开关

自动模式的判定入口是resolve_vr_mode()，满足下面任意一条即启用分眼处理；一条都不满足时按普通平面视频处理，不会误伤你的非 VR 素材。

判定是保守的：帧宽度为奇数直接判off（SBS 拆分要求偶数宽度）；2:1 规则要求"严格 2:1 且高度超 1080"，低分辨率或比例不精确的文件自动模式不会碰。跑起来后日志会打印一行VR mode: requested=auto resolved=sbs/off projection=... reason=...，一眼就能确认它为什么这么判。

自动模式漏识别了怎么办？两个手动开关兜底：

• 高级设置或 CLI 里把 VR180 模式改成SBS — 分眼处理（sbs），强制按 VR 走，投影仍按片商自动路由；
• 或者选SBS + 鱼眼（sbs-fisheye），强制分眼且所有马赛克区域统一用鱼眼投影。

注意：强制 SBS 时帧宽度必须是偶数，否则会直接报错。

分眼独立修复：左右眼拆开跑，马赛克之外一个像素都不动

识别为 SBS 后，SbsDetectionAdapter接管检测环节：把宽画面从中间切成左右两路，每只眼独立跑一遍马赛克检测，得到各自的检测框与掩码，再把右眼结果平移回源画面坐标拼起来。修复、跟踪、混合全程在源坐标进行，最终只有马赛克区域的修复差分会经过投影变换写回去，区域外像素原样保留——这就是"整体画面不会变形"的原因。

这种设计带来的实际好处：

• 修复模型每次只面对单眼视角的"正常"画面，而不是挤在一起的双眼变形图，检测与修复质量明显更好；
• 双眼互不干扰，一只眼误检不会污染另一只眼。

代价是左右两路分别处理，显存比同分辨率平面视频多占一些。显存吃紧时：优先调小"最大片段长度"（比如从 180 降到 60）；另外 Jasna 会在显存不足时自动把等待帧挪到系统内存、需要时再移回，这一步不需要任何配置。

片商决定马赛克形态：raw / 鱼眼 / 等距投影三选一的自动路由

各片商打马赛克的方式不同，同一种展平设置未必对所有片子都合适，所以不存在"万能投影"。Jasna 在修复前按片商为每个马赛克区域自动选择展平方式，共三种投影：

• raw（原始）：按画面原样使用，未知片商的安全默认值；
• fisheye（鱼眼）：适用于马赛克在鱼眼视图下显示正常的片商；
• gnomonic（等距投影）：平坦、无变形的平面视图，对 2D 修复模型最友好。

内置的片商 → 投影路由表（STUDIO_PROJECTION）：

路由优先级：文件名以片商代号开头（如atvr、vrprd007）时优先查表；代号未命中但文件名包含FSVSS / SAVR / URVRSP / CRVR / PXVR等鱼眼片商标记时走鱼眼；都不命中则回退 raw。

自动结果不理想？在区间编辑器里手动切换投影并逐帧对比

视频被识别为 VR180 后，区间编辑器（jasna/gui/segment_editor.py）的VR 投影菜单会启用，操作路径：

1. 打开修复预览；
2. 在VR 投影菜单中选自动 / 原始 / 鱼眼 / 等距投影，当前帧效果即时对比；
3. 点应用，选择随当前视频保存，最终处理与预览使用同一投影。

选"自动"时，菜单标签会实时显示实际解析出的投影（例如"VR 投影（自动：鱼眼）"），所见即所得，不用翻日志猜。

一个常见疑问：预览里只看到左眼，会不会修丢右眼？不会——预览只显示单眼画面，扫描与导出处理的是双眼，效果不受影响。

命令行修 VR180：--vr-mode 四个取值速查

习惯终端的话，核心就一个参数--vr-mode（完整 CLI 见 docs/zh/cli.md）：

jasna --input input.mp4 --output output.mp4 --vr-mode auto jasna --input input.mp4 --output output.mp4 --vr-mode sbs-fisheye

小结

Jasna 修 VR180 的完整闭环可以浓缩为三句话：自动识别（严格 2:1 高分辨率 / 片商文件名标记 / VR 空间元数据，命中其一即分眼）、双眼独立检测修复再拼合（马赛克外像素零改动）、按片商路由投影（raw / 鱼眼 / 等距三选一，区间编辑器可预览并手动覆盖）。保持"自动（推荐）"模式 + 内置rfdetr-vr-v1检测模型 + BasicVSR++ 修复器，就是一套开箱即用的 VR180 修复配置。

【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna