选择视频后自动探测分辨率、帧率、时长与总帧数，勾选要执行的流程，选好超分与补帧模型， 输出分辨率与目标帧率实时算给你看。

处理过程不是黑盒：阶段进度、最新产出帧、子进程的近期日志、CPU/GPU 占用都在同一个页面里滚动更新。

去重不是黑盒。进行中页会把三张帧并排显示：左侧是最近被判为重复的「判决帧」， 中间是「对比帧」，右侧是当前正在判决的「筛选帧」——一眼看出这一帧是和谁比、比出了什么。

两档用的是同一套孪生网络结构，差别在权重精度与判定阈值：性能档跑 FP16 模型、阈值 0.60； 完美档跑 FP32 模型、阈值 0.50。哪一档更适合，需要对代表性片段实际比对。

基于 AudioSR 扩散模型重建高频，把音轨升采样到 48 kHz 直出；勾选「将原音频合并进新视频」时直接嵌入视频， 不勾选则单独输出一个 48 kHz 的 wav 文件。未开启音频超分时，音频由 FFmpeg 重采样到 96 kHz 后封装。

标准 / 高级一键切换：需要斟酌的进阶功能（帧去重、音频超分、转场优化、涡轮模式）集中在高级页，日常使用保持简洁。 界面当前固定简体中文（多语言词表与切换逻辑保留，入口暂时隐藏）。

补帧会在相邻两帧之间「插」出一帧。碰上镜头硬切，插出来的就是两个镜头各混一半的鬼影帧。 开启转场优化后先用 PySceneDetect 扫出剪切点，合并前把切点处的插值帧换回上一镜头的末帧—— 帧数、帧率、时长都不变，只是不再有跨镜头混合。

成片是从帧序列重建的，原文件的标题、注释、封面不会自己跟过来。Easy4K 只在检测到源文件确实有元数据/封面时 才允许勾选；写回时用 -map_metadata + -c copy 只重封装不重编码， 封面按容器写成 mkv 附件或 mp4 attached_pic。

选择视频
 ├─ 自动探测分辨率 / 帧率 / 时长 / 总帧数
 ├─ 临时目录指纹校验 ── 不符 → 引导更换或清理
 ├─ 处理前测试：1 秒测试视频 × 当前勾选流程
 │    └─ 没跑通 → 直接取消正式处理，不浪费几个小时
 └─ 正式处理：转场检测（启用时）→ 拆帧 → 去重判决与平滑
                → 超分 → 补帧 → 音频超分
                → 合并（含 HDR / 音频 / 元数据封面）→ 帧数审查
      ├─ 帧去重：勾选补帧时超分算全部源帧、只省补帧的计算量
      ├─ 每阶段：帧数够就跳过，残留就清理后重跑
      ├─ 出错时：按实际条件降级 / 回退 / 重试，无退路则停止
      └─ 完成后：审查帧数 → 自动命名输出 + 生成 HTML 报告

FFmpeg 与 NVEncC 会往标准错误输出覆盖式进度，所以进程读取按 \r 与 \n 都切分，逐行实时回调；AI 工具没有进度输出，就轮询输出目录的帧数再叠加当前帧内的 tile 百分比。

// 按 \r 与 \n 都切分，否则 FFmpeg 的覆盖式进度会被缓冲到进程结束
if (c == '\r' || c == '\n') { onLine(sb.ToString()); sb.Clear(); }

// 拆帧 / 合并：解析行内帧号
frame=\s*(\d+)            →  已处理 1234 / 4823

// HDR：优先解析百分比，帧号比例仅在分母合理时采用
(\d+(?:\.\d+)?)\s*%       →  已处理 45%

// 超分 / 补帧：轮询输出目录帧数 + stderr 的 tile 百分比
进度 = min(已完成帧数 + 当前帧内百分比 / 100, 总帧数)

能回退的环节按实际条件逐级尝试：能用 CPU 的转 CPU，能换编码器的换编码器， 模型不被支持就换模型；没有可用退路时停止任务并把错误交给日志与失败报告。

拆帧 / 合并    启用旧版重试且旧版已部署   → 新版 FFmpeg 失败后尝试旧版
拆帧 / 合并    旧版不可用或仍失败         → CPU 处理档（关闭相关硬件处理）
音轨/封面/元数据/AudioSR 转 48k            → 按同样条件尝试旧版，再转 CPU 档
HDR            NVEncC 转换失败             → 条件允许时重试旧版，仍失败则终止，不自动改走 AI
合并           硬件编码器失败              → 回退 libx265 -crf 18
超分           捆绑版无 CPU 后端           → 自动升级为 GPU 处理
补帧           "MemoryData not exists"     → 回退 rife-v4.6
补帧           v2 / v3 老模型              → 强制 x2 并锁定倍率下拉框
GPU 致命       设备丢失 / 显存溢出          → 安全帧率：停止；否则：-j 1:1:1 重试
失败           任何阶段                    → 停止任务并生成失败报告（不静默跳过）

每个阶段开始时先数输出目录里的 PNG：够数就整段跳过；有残留但不够数，说明上次是被中断的， 先清理再从该阶段重跑，避免半截帧序列被当成有效输入。

existing = 输出目录 PNG 数量

existing >= 目标帧数      → 当前阶段已完成，直接跳过
0 < existing < 目标帧数   → 清理残留，从本阶段重新开始
existing == 0            → 正常执行

临时目录里会写一份 cache.json，记录来源视频路径、文件大小与最后修改时间。 换了视频却没清理临时目录时，启动前会提示重新选择目录或清理缓存，避免旧帧被误当成新素材。

{
  "inputVideo": "D:/video/彩条测试视频.mp4",
  "videoSize": 1089894,
  "videoModifiedTicks": 638600000000000000,
  "createdAt": "2026-09-13 13:20:41"
}

指纹不一致 → 弹窗：重新选择临时目录 / 清理缓存 / 取消