新整合包的快速说明

[hooke007]

ver.20250809

Caution

内部兼容性： 不再考虑预设参数、脚本、着色器等对 VO_gpu/libmpv 的适配问题。
硬件兼容性： 仅支持win10+64位的操作系统与微架构v3的处理器（起点约2015年 Intel-Haswell & AMD-Excavator）。
读写权限要求： 因为个别组件的需要与启用了本地便携缓存设置，请确保你的安置目录有用户级的读写权限（不确定那就 非C盘 或者 %appdata% 二选一）。
部分功能缺失： 基于 shinchiro 工具链构建，但移除了音视频编码器，因此无法正常使用任何依赖mpv内部视频转码功能的脚本。

1. 主要特点

虽然还是叫 mpv-lazy ，但是完全从另一个角度出发重新做了整合方案。

• 组件精简
  不同于旧版的往里塞很多东西然后让用户做减法，现在只提供基础的组件但足以满足大多数的需求，由用户做加法。
• 更加开箱即用
  尽可能使用户不用修改 portable_config 内的内容。
  选择了能满足更高阶交互需求的新预设界面，让这个命令行程序的体验更接近一般GUI化的软件（不用再背一堆快捷指令了）。
• 参数简化&注释移除
  如果你不够熟悉mpv的参数，打开 mpv.conf 时大概率会因没有注释而懵逼。现在仓库的主分支已被我修改为了参考模式，用网页的排版就能获得清晰的视图（很多人没有代码高亮的编辑器，写满注释的配置文件反倒显得很杂乱）。

2. 注册

installer/mpv-install.bat 和 installer/mpv-uninstall.bat 分别为mpv注册程序与反注册。
注册完成后即可在文件关联中指定为默认播放器，此后请不要修改mpv.exe的所属路径。

installer/umpv-install.bat 和 installer/umpv-uninstall.bat 分别为单实例代理模式的注册程序与反注册。
注册完成后即可在文件关联中指定为默认播放器，此后请不要修改umpv.exe的所属路径。
umpv的注册可以和mpv的注册共存。

[hooke007]

3. 上下文菜单

启用了win原生菜单支持，它支持一些高级特性（预设按键为Ctrl+鼠标右键）
可编辑 input_contextmenu_plus.conf 文件以修改渲染内容。

3.1. 屏显版菜单&界面按钮

触发菜单的某条目前，按住 shift 即可让菜单在点击后不关闭。

上下文菜单的条目由 portable_config/input_uosc.conf 文件构建，可自行编辑以修改菜单条目。

界面按钮可自行增减

3.2. 预设按钮的功能说明

（左侧）
上下文菜单、数据统计、播放暂停、字幕轨列表、音频轨列表、
视频轨列表（默认隐藏，仅在多轨视频时出现）、流品质偏好（默认隐藏，仅在播放网络流时出现）

（中隔）
速度滑块、

（右侧）
乱序播放、列表循环、单文件循环、
上一个（如果播放列表存在多个条目则使用播放列表的上一个，否则使用当前文件路径下的上一个文件）、
播放列表/文件列表（如果播放列表存在多个条目则显示播放列表，否则显示当前文件路径下的其它文件）、
========================================= 否则显示当前文件路径下的其它文件！！！
========================================= 否则显示当前文件路径下的其它文件！！！
下一个（类比“上一个”的说明）、
全屏

更多参见 《uosc.lua 多功能控制界面》

4. 预设的快捷键

鼠标右键 呼出上下文菜单（或界面左下的按钮）；
上下文菜单的部分条目右侧显示的键位即对应的快捷键按钮；
剩余的未映射到菜单的快捷键参见 portable_config/input_uosc.conf 文件内的后部分

5. 退出记住设置

下次启动mpv即恢复上次退出前的状态。现由两部分共同完善此功能。

• portable_config/mpv.conf 内的 watch-later-options 负责记录每个文件的属性变动，预设值表示 “上次播放的时间点、视频轨、音轨、字幕轨号”。
  你可通过 FAQ_保存运行时修改过的选项 获取所有可用值
• portable_config/script-opts.conf 内的 script-opts-append = save_global_props-props 负责记录程序运行时的属性变动，预设值表示 “音量、静音状态”。
  你可通过 Manual_property-list 获取所有可用值（大部分选项名亦是属性名，因此不在此列表中）
  你可通过 快捷键 Ctrl+r 或 菜单条目 “工具-清除已记录的属性值” 或 手动删除 portable_config/saved-props.json 文件来重置保存状态。

6. 预设设置的修改

文件夹 portable_config 内的所有扩展名为 conf 的文件即为面向一般用户的“选项设置”文件。
mpv.conf 为主设置文件，负责播放器的核心设置。
profiles.conf 负责提供自定义的profile。
script-opts.conf 负责脚本的设置。
input_uosc.conf 负责快捷键的设置。

原始的 input.conf 被映射为 input_uosc.conf ，该文件为当前修改mpv快捷键所使用的实际文件（你可以在主设置文件 mpv.conf 中修改这个设定）。

包内的参数已极度精简且不再提供注释。
现在通过访问仓库主(main)分支的对应文件查询。

当然，如果你愿意浪费时间看仓库提供的系列文档，那自然是最好的。

[hooke007]

7. 新版FAQ

Q: 解压错误？
A: 验证完整性/哈希；使用的7z解压核心版本应不低于23.00

Q: 如何在旧版硬件平台上使用mpv-lazy？
A: 自行下载 shinchiro版常规mpv主程序 （无v3后缀）替换。（当然，部分参数会失效）

Q: 如何在win7系统上使用vs滤镜？
A: 官方已移除对旧系统的支持，需将主程序降级（不高于此节点的git版本或release0.36.0）；另需要基于python3.8自行部署工具链，自行参考相关文档。

更多参见 《维基_常见问题解答》

7.1. 查错与报错

当你启用某项功能（特别是滤镜）却感觉无效的时候，首先尝试查看【控制台】 （当前预设快捷键为 `启用 ESC关闭）。如果无法根据提示信息自行解决，报告此类问题的时候也一并附上图。

8. 版本选择与增强包

• 版本

  1. 标准版。详情参见下一小节的说明。
  2. noBin 版本不含自编译的mpv及yt-dlp，适合自行更新mpv的用户

• 增强包（这只是补丁包！！！需要解压覆盖在版本上使用！！！）

  1. vsNV 更多的vs与CUDA专用滤镜补丁包（查看 K7sfunc 说明书）

8.1. 标准包的预装组件

• 核心
  mpv （本体）
  yt-dlp （网络播放依赖）

• 脚本
  contextmenu_plus （原生菜单构建辅助）
  input_plus （快捷指令扩展）
  save_global_props （保存退出前修改过的属性）
  thumbfast （缩略图预览）
  uosc （界面功能替换）

• 字体
  LXGWWenKaiMono-Regular.ttf （文本字幕预设字体）
  MaterialIconsRound-Regular.otf （uosc脚本依赖）
  uosc_textures.ttf （uosc脚本依赖）

• 扩展
  installer （注册与测试）
  Python&VapourSynth （vs滤镜前置）
  K7sfunc （模块化vs滤镜前置）
  MVTools&RIFE （vs滤镜插件及脚本：通用的CPU与GPU补帧）

• 着色器
  关于更详细的介绍和增强包内其它着色器的说明，参见 《用户着色器》

  Adaptive_sharpen_lite_RT	锐化
  AMD_FSR_EASU_chroma_RT	色度还原
  AMD_FSR_EASU_rgb_RT	上采样
  AMD_FSR_RCAS_rgb_RT	锐化
  Ani4Kv2_ArtCNN_C4F32_i2	上采样
  Anime4K_AIO_optQ	修复（强度++）+上采样（放大2/4倍、质量++）
  Anime4K_Denoise_Bilateral_Mode	降噪
  Anime4K_Restore_CNN_M	修复
  Anime4K_Restore_CNN_L	修复（强度+）
  Anime4K_Restore_GAN_UL_R2	修复（强度+++）
  Anime4K_Upscale_CNN_x2_M	上采样（放大2倍）
  Anime4K_Upscale_GAN_x2_M	上采样（放大2倍）
  AniSD_ArtCNN_C4F32_i4	上采样
  CfL_Prediction_RT	色度还原
  CuNNy_4x16_DS	上采样
  FSRCNNX_x2_8_0_4_1	上采样（放大2倍）
  FSRCNNX_x2_16_0_4_1	上采样（放大2倍、质量+）
  hdeband	去色带
  knlm_lite_RT	降噪
  nnedi3_nns128_win8x4	上采样（放大2倍）
  nnedi3_nns128_win8x6	上采样（放大2倍、锐度+）
  QCOM_SGEDS_ms_RT	对 --scale 进行锐化增强