ViPER4Android 安装指南（三星 One UI 6.1 · KernelSU / Magisk）
适用环境：三星 One UI 6.1（UN1CA 生态）· Root 管理器 KernelSU / Magisk
一、刷入挂载模块 Hybrid-Mount（前置条件）
- 将附件
Hybrid-Mount-4.0.0-1666.zip传输到手机存储中。 - 打开 KernelSU（或 Magisk），切换到「模块（Modules）」页面。
- 点击「从本地安装」，选择并刷入
Hybrid-Mount-4.0.0-1666.zip。 - 刷入完成后，立即重启手机。
作用：解决三星只读文件系统或挂载点限制，使系统底层能够正确挂载并注入音频驱动。
⚠️ 关键避坑点：重启后，即使管理器内提示该模块有新版本，也绝对不要点击更新（do not update）。更新到更高版本可能会导致兼容性失效或冲突。全程保持 Hybrid-Mount 为 4.0.0 版本。
二、准备 V4A 三件套
在三星 One UI 6.1 生态中，ViPER4Android 依赖的 3 个模块组合如下（请确认发布者压缩包或网盘里附带的对应文件）：
| 模块 | 作用 |
|---|---|
| ViPER4Android RE / Repackaged 核心模块 | 提供 V4A 主程序与底层处理驱动 |
| Audio Modification Library（AML） | 音频修改库，将 V4A 驱动无缝注入到三星系统的 audio_effects.xml 中，避免与原厂 SoundAlive / 杜比全景声冲突 |
| Audio Compatibility Patch（ACP）或 V4A Fix 补丁模块 | 音频兼容性补丁，用于移除三星特定的音频策略限制或处理驱动失效 |
三、模块刷入顺序与重启
- 打开 KernelSU / Magisk 的「模块」页面。
- 依次刷入这 3 个模块（刷完一个后不要马上点重启，直接返回继续刷下一个）：
- 先刷入 ViPER4Android 核心模块；
- 接着刷入 Audio Modification Library（AML）；
- 最后刷入配套的 Fix / ACP 补丁模块。
- 3 个模块全部提示安装成功后，点击页面右下角的「重启设备」。
四、首次开机配置与验证
- 开机后，打开桌面生成的 ViPER4Android 图标。
- 首次启动若弹出 Root 权限申请，点击「允许」/ 永久授权。
- 播放一段本地音乐或流媒体音频。
- 点击 V4A 右上角菜单进入「驱动程序状态（Driver Status）」，确认以下四项：
- Neon Enabled: Yes
- Enabled: Yes
- Status: Normal
- Processing: Yes（显示 Yes 即代表驱动已成功接管系统音频流）
五、避坑要点速览
- Hybrid-Mount 锁定 4.0.0，看到更新提示也不要点。
- 三件套按顺序刷完再统一重启一次，不要刷一个重启一次。
- 验证以驱动状态页四项全 Yes/Normal 为准。