Jasna VR180 视频修复完全指南：分眼检测、片商投影自动路由与快速上手【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是面向视频修复的开源工具，对 VR180（左右眼并排的 VR 画面）有专门处理：自动识别 VR180 格式、把画面拆成左右眼分别做视频修复，再按片商规则选择马赛克展平方式，全程默认配置即可跑通。本文带你从零理解它的工作方式，并给出 GUI 与 CLI 两种动手路径。硬修 VR180 会翻车在哪，分眼处理怎么解决先看痛点。VR180 视频里，左眼、右眼两幅画面并排挤在同一个宽幅画幅中，典型如 3840×1920（左右各 1920×1920）。如果直接把它交给普通 2D 修复模型，模型看到的是两幅画面拼接后的变形图，马赛克检测与重建都会失准，修出来的结果往往是糊的、扭曲的。Jasna 的做法是拆开来修，流程分三步：把宽画面对半切开，得到左眼、右眼两路独立信号；每只眼各自完成马赛克检测与修复，互不干扰；把两眼的修复结果拼回并排画幅输出。这一步的核心逻辑在 jasna/vr180.py 的SbsDetectionAdapter：检测框和掩码始终留在源画面坐标里，只有马赛克区域的"修复差分"会被重新贴回去，马赛克以外的像素原封不动。记住这个结论：分眼不是为了好看，而是为了让 2D 模型看到正常比例的画面。理解了这一点，后面所有配置都好懂。识别、拆眼、投影：决定成片质量的三个开关Jasna 对 VR180 的处理链路上有三个决定因素：先判断"这是不是 VR"，再执行"怎么拆眼"，最后决定"马赛克按哪种投影展平"。识别：自动模式靠什么判断一个视频是 VR默认选"自动"时，Jasna 满足以下任一条件就启用分眼处理（判断逻辑在resolve_vr_mode()，日志会打印一行VR mode: requested=auto resolved=sbs/off projection=... reason=...供你确认）：条件说明严格 2:1 且高度 > 1080如 3840×1920、8192×4096，直接判定为并排 VR文件名含已知片商标记如FSVSS、SAVR、S1VR、VRKM文件带 VR 空间元数据"并排 + 等距柱状"的立体/球面投影标记三条都不满足时，文件按普通平面视频处理，不会误伤。规则细节可查 docs/zh/vr180.md。拆眼：强制分眼与偶数宽度限制自动模式偏保守，漏认时可以用强制档位：sbs把所有文件都当 VR 拆眼处理（投影仍按片商路由），sbs-fisheye则在此基础上让所有马赛克统一走鱼眼投影。注意两条硬约束：SBS 处理要求帧宽度为偶数，奇数宽度会直接报错；显示宽高比不在 1.90–2.10 区间时，日志会给出 unusual SBS aspect 警告。投影：按片商自动选择马赛克展平方式不同片商制作马赛克的方式不同，不存在一套通吃所有视频的投影参数，所以 Jasna 内置了一张片商→投影路由表（jasna/vr180.py 的STUDIO_PROJECTION）。三种投影的含义：raw（原始）——按画面原样使用马赛克区域，未知片商时的安全默认；fisheye（鱼眼）——马赛克在鱼眼视图下才显示正常的片商适用；gnomonic（等距/球心投影）——平坦无变形的视图，最利于 2D 修复模型。路由规则如下（自动模式下生效）：来源片商投影路由表ATVR、CJVR、IPVR、KAVRraw路由表NHVR、PXVR、TMAVR鱼眼路由表VRPRD等距投影文件名含鱼眼片商标记FSVSS、SAVR、URVRSP、CRVR、PXVR鱼眼投影不满意可以在区间编辑器里手动覆盖：打开修复预览，在VR 投影菜单选 自动 / 原始 / 鱼眼 / 等距投影，菜单标签会实时显示自动模式实际解析出的值；点应用后该视频保存此选择，最终处理与预览一致。提醒一点：区间编辑器预览只显示左眼，但扫描和导出处理的是双眼，不影响最终效果。三个开关都清楚了，接下来选一条动手路线。动手做：GUI 四步走与 CLI 一行命令GUI 路线：四步修完一个 VR180像添加普通视频一样添加 VR 视频；高级设置中把VR180 模式保持自动（推荐）（设置项定义见 jasna/gui/settings_sections/advanced.py）；检测模型选内置的rfdetr-vr-v1——VR180 专用；zelefans-vr-yolo-v2需单独下载，是可选备用（模型清单见 docs/zh/models.md）；开始处理。只想修一部分？用区间编辑器指定时间段即可。CLI 路线：用 --vr-mode 控制行为纯命令行用户只需关心--vr-mode参数（完整用法见 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四个可选值：值行为auto（默认）自动识别 + 片商投影路由off当普通平面视频处理sbs强制分眼，投影仍按片商路由sbs-fisheye强制分眼，所有区域用鱼眼投影另外记住：LTX 引擎不支持 VR180 并排视频，遇到 VR 文件请搭配 BasicVSR++ 使用。两条路线都走通后，剩下的是几个新手常见疑问。容易踩的坑：显存、漏识别与变形疑虑坑：VR 修复比 2D 更吃显存？解法：左右两路分别处理，占用确实更多。显存吃紧时优先把"最大片段长度"调小（例如 180 → 60）；Jasna 还会在显存不足时自动把等待帧临时挪到内存，不用手动配置。坑：我的 VR 文件没被自动识别？解法：自动模式偏保守——2:1 规则要求严格 2:1 且高度超 1080，低分辨率或比例不精确的文件会漏掉。此时在设置里改选SBS — 分眼处理强制启用（前提：帧宽度为偶数）。坑：修完画面会整体变形吗？解法：不会。检测、跟踪、掩码、混合全程在源坐标进行，只有马赛克区域的修复差分经过投影变换（实现见 jasna/vr_projection.py），区域外像素原样保留。坑：区间编辑器里只看到一只眼？解法：那是设计如此——预览展示左眼，处理时双眼都会修，不必担心。这些坑基本覆盖了你上手 VR180 修复时会遇到的所有摩擦点。收个尾Jasna 处理 VR180 的思路浓缩成三点：自动识别（2:1 高分辨率 / 片商名 / 空间元数据三选一触发）、分眼独立修复（拆开检测修复再拼回）、片商投影路由（raw / 鱼眼 / 等距投影自动选择，可手动覆盖）。保持默认"自动"模式，配上内置的 rfdetr-vr-v1 检测模型，开箱即用。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Jasna VR180 视频修复完全指南：分眼检测、片商投影自动路由与快速上手【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是面向视频修复的开源工具，对 VR180（左右眼并排的 VR 画面）有专门处理：自动识别 VR180 格式、把画面拆成左右眼分别做视频修复，再按片商规则选择马赛克展平方式，全程默认配置即可跑通。本文带你从零理解它的工作方式，并给出 GUI 与 CLI 两种动手路径。硬修 VR180 会翻车在哪，分眼处理怎么解决先看痛点。VR180 视频里，左眼、右眼两幅画面并排挤在同一个宽幅画幅中，典型如 3840×1920（左右各 1920×1920）。如果直接把它交给普通 2D 修复模型，模型看到的是两幅画面拼接后的变形图，马赛克检测与重建都会失准，修出来的结果往往是糊的、扭曲的。Jasna 的做法是拆开来修，流程分三步：把宽画面对半切开，得到左眼、右眼两路独立信号；每只眼各自完成马赛克检测与修复，互不干扰；把两眼的修复结果拼回并排画幅输出。这一步的核心逻辑在 jasna/vr180.py 的SbsDetectionAdapter：检测框和掩码始终留在源画面坐标里，只有马赛克区域的"修复差分"会被重新贴回去，马赛克以外的像素原封不动。记住这个结论：分眼不是为了好看，而是为了让 2D 模型看到正常比例的画面。理解了这一点，后面所有配置都好懂。识别、拆眼、投影：决定成片质量的三个开关Jasna 对 VR180 的处理链路上有三个决定因素：先判断"这是不是 VR"，再执行"怎么拆眼"，最后决定"马赛克按哪种投影展平"。识别：自动模式靠什么判断一个视频是 VR默认选"自动"时，Jasna 满足以下任一条件就启用分眼处理（判断逻辑在resolve_vr_mode()，日志会打印一行VR mode: requested=auto resolved=sbs/off projection=... reason=...供你确认）：条件说明严格 2:1 且高度 > 1080如 3840×1920、8192×4096，直接判定为并排 VR文件名含已知片商标记如FSVSS、SAVR、S1VR、VRKM文件带 VR 空间元数据"并排 + 等距柱状"的立体/球面投影标记三条都不满足时，文件按普通平面视频处理，不会误伤。规则细节可查 docs/zh/vr180.md。拆眼：强制分眼与偶数宽度限制自动模式偏保守，漏认时可以用强制档位：sbs把所有文件都当 VR 拆眼处理（投影仍按片商路由），sbs-fisheye则在此基础上让所有马赛克统一走鱼眼投影。注意两条硬约束：SBS 处理要求帧宽度为偶数，奇数宽度会直接报错；显示宽高比不在 1.90–2.10 区间时，日志会给出 unusual SBS aspect 警告。投影：按片商自动选择马赛克展平方式不同片商制作马赛克的方式不同，不存在一套通吃所有视频的投影参数，所以 Jasna 内置了一张片商→投影路由表（jasna/vr180.py 的STUDIO_PROJECTION）。三种投影的含义：raw（原始）——按画面原样使用马赛克区域，未知片商时的安全默认；fisheye（鱼眼）——马赛克在鱼眼视图下才显示正常的片商适用；gnomonic（等距/球心投影）——平坦无变形的视图，最利于 2D 修复模型。路由规则如下（自动模式下生效）：来源片商投影路由表ATVR、CJVR、IPVR、KAVRraw路由表NHVR、PXVR、TMAVR鱼眼路由表VRPRD等距投影文件名含鱼眼片商标记FSVSS、SAVR、URVRSP、CRVR、PXVR鱼眼投影不满意可以在区间编辑器里手动覆盖：打开修复预览，在VR 投影菜单选 自动 / 原始 / 鱼眼 / 等距投影，菜单标签会实时显示自动模式实际解析出的值；点应用后该视频保存此选择，最终处理与预览一致。提醒一点：区间编辑器预览只显示左眼，但扫描和导出处理的是双眼，不影响最终效果。三个开关都清楚了，接下来选一条动手路线。动手做：GUI 四步走与 CLI 一行命令GUI 路线：四步修完一个 VR180像添加普通视频一样添加 VR 视频；高级设置中把VR180 模式保持自动（推荐）（设置项定义见 jasna/gui/settings_sections/advanced.py）；检测模型选内置的rfdetr-vr-v1——VR180 专用；zelefans-vr-yolo-v2需单独下载，是可选备用（模型清单见 docs/zh/models.md）；开始处理。只想修一部分？用区间编辑器指定时间段即可。CLI 路线：用 --vr-mode 控制行为纯命令行用户只需关心--vr-mode参数（完整用法见 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四个可选值：值行为auto（默认）自动识别 + 片商投影路由off当普通平面视频处理sbs强制分眼，投影仍按片商路由sbs-fisheye强制分眼，所有区域用鱼眼投影另外记住：LTX 引擎不支持 VR180 并排视频，遇到 VR 文件请搭配 BasicVSR++ 使用。两条路线都走通后，剩下的是几个新手常见疑问。容易踩的坑：显存、漏识别与变形疑虑坑：VR 修复比 2D 更吃显存？解法：左右两路分别处理，占用确实更多。显存吃紧时优先把"最大片段长度"调小（例如 180 → 60）；Jasna 还会在显存不足时自动把等待帧临时挪到内存，不用手动配置。坑：我的 VR 文件没被自动识别？解法：自动模式偏保守——2:1 规则要求严格 2:1 且高度超 1080，低分辨率或比例不精确的文件会漏掉。此时在设置里改选SBS — 分眼处理强制启用（前提：帧宽度为偶数）。坑：修完画面会整体变形吗？解法：不会。检测、跟踪、掩码、混合全程在源坐标进行，只有马赛克区域的修复差分经过投影变换（实现见 jasna/vr_projection.py），区域外像素原样保留。坑：区间编辑器里只看到一只眼？解法：那是设计如此——预览展示左眼，处理时双眼都会修，不必担心。这些坑基本覆盖了你上手 VR180 修复时会遇到的所有摩擦点。收个尾Jasna 处理 VR180 的思路浓缩成三点：自动识别（2:1 高分辨率 / 片商名 / 空间元数据三选一触发）、分眼独立修复（拆开检测修复再拼回）、片商投影路由（raw / 鱼眼 / 等距投影自动选择，可手动覆盖）。保持默认"自动"模式，配上内置的 rfdetr-vr-v1 检测模型，开箱即用。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考