AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它通过 bind mount 实现非破坏性修改，能让用户自选的音乐应用获得系统级音频增强，且支持 OTA 后自动恢复，解决了 ColorOS 用户的一个实际痛点。

适合谁使用

使用 ColorOS 15 及以上版本、需要系统级音频增强的音乐应用用户
Magisk/KernelSU 用户，希望以非破坏方式修改音频策略
研究 ColorOS OEM 音频框架的开发者或模组制作者

典型使用场景

将 Salt Music 或其他音乐应用加入 ColorOS 的 OEM 多媒体和 MetaAudio 策略，提升音质
在 OTA 升级和云控策略更新后自动保持自定义音频策略补丁
在兼容设备上为非默认音乐应用启用空间音频和头部追踪功能

项目优势

同时支持 Multimedia_Daemon_List.xml 和 Meta_Audio_Policy.xml，包括在线云控策略文件
在 OTA 更新、云控策略变化或包名配置修改后自动重新生成补丁
通过 bind mount 生效，不修改系统分区，保持系统完整性

使用前须知

仅支持 ColorOS 15 及以上版本，APatch 尚未完整验证
KernelSU/APatch 用户需要手动关闭 Android 系统的「卸载模块」开关，否则模块文件不可见
若源 OEM 策略缺失或结构不兼容，相关补丁可能无法生成

README 快速开始

ColorOS Audio Policy Patcher Enhancer

Salt Music 音频增强 · Magisk / KernelSU 模块

一个面向 ColorOS 的系统无修改音频策略补丁模块。它会为 Salt Music 或你指定的其他应用注入 OEM 多媒体与 MetaAudio 音乐场景策略，并在系统 OTA、云控文件或包名配置变化后自动重新生成补丁。

English

功能

同步修补 Multimedia_Daemon_List.xml 与 Meta_Audio_Policy.xml
支持 /data/oplus/multimedia/*_Online.xml 云控策略文件
默认以 QQ 音乐策略为模板，为自定义包名复制对应音乐场景配置
通过 packages.txt 配置多个应用，一行一个包名
保留原始策略副本，并在 OTA 或云控策略变化后重新生成补丁
使用 bind mount 生效，不直接修改系统分区
提供启动日志、挂载状态与内容完整性检查

兼容性与风险提示

ColorOS 15 及以上
Magisk 20.4 及以上
KernelSU
APatch 尚未完整验证

不同机型和 ColorOS 版本的 OEM 策略结构可能不同。安装前请保留可用的恢复方式；如果源策略不存在或格式不兼容，相关补丁可能无法生成。

KernelSU / APatch 用户需要在 App Profile（超级用户配置）中找到“Android 系统”，关闭它的“卸载模块”开关，使系统框架能够读取模块挂载的文件。否则空间音频、头部追踪等功能可能不生效。

下载与安装

从 Releases 下载最新 ZIP。
在 Magisk、KernelSU 或 APatch 管理器中刷入 ZIP。
重启设备。

默认配置包含 Salt Music：

com.salt.music

自定义应用包名

安装后编辑：

/data/adb/modules/SaltMusicEnhance/packages.txt

每行填写一个包名；空行和以 # 开头的注释会被忽略。例如：

# 保存后重启生效
com.salt.music
com.netease.cloudmusic
com.kugou.android

保存后重启设备。升级模块时，已有的 packages.txt 会被保留。

工作原理

安装和开机早期阶段会按“云控文件 > /system_ext > /system/system_ext”的优先级寻找原始策略。模块保存原始副本，以 QQ 音乐 com.tencent.qqmusic（MetaAudio 必要时回退到 com.heytap.music）为模板，为 packages.txt 中的应用生成策略，再将结果 bind mount 到系统实际读取的位置。

模块动态处理以下文件：

/system_ext/etc/Multimedia_Daemon_List.xml
/system_ext/etc/Meta_Audio_Policy.xml
/data/oplus/multimedia/Multimedia_Daemon_Online_List.xml
/data/oplus/multimedia/Meta_Audio_Policy_Online.xml

日志与检查

日志路径：

/data/adb/modules/SaltMusicEnhance/saltmusic.log

简单检查：

grep 'com.salt.music' /system_ext/etc/Multimedia_Daemon_List.xml
grep 'com.salt.music' /system_ext/etc/Meta_Audio_Policy.xml
cat /data/adb/modules/SaltMusicEnhance/saltmusic.log

部分设备实际使用 /system/system_ext/etc/ 或 /data/oplus/multimedia/ 下的对应文件，请按日志中的目标路径检查。

从源码构建

在 Linux、WSL 或 Git Bash 中安装 zip 与 unzip，然后运行：

bash scripts/build.sh 3.1.1

产物位于 dist/ColorOS-Audio-Policy-Patcher-Enhancer-v3.1.1.zip。构建采用运行时文件白名单，不会把 README、GitHub 配置或“问题排查”目录打入模块。

手动发布工作流

仓库提供 Build and Release 手动工作流：

打开 GitHub 仓库的 Actions 页面。
选择 Build and Release。
点击 Run workflow。
输入版本号，例如 3.1.1，然后运行。

工作流会校验版本、更新发布包内的 module.prop、构建并测试 ZIP，最后创建 `

项目描述

为ColorOS提供最佳音乐体验 | 修补 Multimedia + MetaAudio 策略 | 编辑packages.txt自定义包名

ColorOS-Audio-Policy-Patcher-Enhancer