蒙版内容</th>	含义</th></tr></thead>
白色 / 不透明</td>	前景</td></tr>
黑色 / 透明</td>	背景</td></tr>
灰色 / 半透明</td>	羽化或过渡区域</td></tr> </tbody></table> 建议外部 PNG 与原始壁纸保持相同尺寸和比例，以减少后续裁切和缩放带来的偏差。</p> 对于轮廓要求较高的壁纸，可以先使用 ColorOS AI 生成基础蒙版，再在内置编辑器中进行初步调整，最后使用外部图像工具完成更精细的处理。</p>

ColorOSDepthMask：为 ColorOS 景深壁纸增加可编辑蒙版

2026-09-05T00:00:00+00:00

项目地址：canxin121/ColorOSDepthMask</a> </blockquote>
ColorOS 的锁屏景深功能会识别壁纸中的人物或主体，并将前景、时钟和其他界面元素分层显示，从而形成较明显的空间层次。
这套效果在系统自动抠图准确时表现较好，但其可调整空间相对有限。当前景深结果主要依赖系统 AI，对头发、手部、衣物边缘或复杂背景的识别出现偏差时，用户通常无法直接修改系统生成的前景区域。
ColorOSDepthMask</code> 针对这一限制提供了一套补充方案。它通过 LSPosed 注入 ColorOS 壁纸编辑器，在原有景深流程中加入可编辑蒙版能力。用户既可以继续调用 ColorOS 原生 AI 生成蒙版，也可以对现有结果进行手工修整，或直接导入外部 PNG 蒙版。
自定义蒙版会按壁纸保存，并参与当前预览与最终锁屏资源生成。因此，修改后的前景不仅用于编辑页中的即时显示，也可以在重新进入同一张壁纸时继续恢复和使用。
</a> 功能概览</h2> ColorOSDepthMask 主要提供以下能力： 在 ColorOS 锁屏壁纸编辑页增加蒙版 入口；</li> 调用 ColorOS 原生 AI 自动生成景深蒙版；</li> 在真实壁纸底图上继续编辑蒙版；</li> 导入外部 PNG 蒙版；</li> 支持画笔、橡皮、笔刷大小、撤销、重做、缩放和平移；</li> 为不同壁纸分别保存蒙版；</li> 保存后立即刷新当前景深预览；</li> 手动控制景深开关；</li> 在最终应用锁屏时使用当前自定义蒙版。</li> </ul> </a> 三种蒙版来源</h2> </a> 使用 ColorOS 原生 AI 自动生成</h3> 最直接的方式是继续使用 ColorOS 自带的 AI 抠图能力。 进入锁屏壁纸编辑页后，选择蒙版 → 自动生成，模块会调用系统原生 AI 生成当前壁纸的景深前景。生成完成后可以直接进入编辑器，对识别不完整的区域继续修整。 这种方式适合主体已经能够被系统较好识别，仅需对局部边缘进行补充的壁纸。系统 AI 负责完成基础分割，后续再由用户修正细节，可以显著减少手工绘制工作量。 </a> 在真实壁纸上编辑</h3> 已有蒙版可以通过编辑 继续修改；没有现成蒙版时，也可以从空白蒙版开始绘制。 编辑器会以当前锁屏壁纸作为底图，并在其上显示半透明蒙版覆盖层。当前支持： 画笔；</li> 橡皮；</li> 笔刷大小调节；</li> 撤销 / 重做；</li> 重置本次编辑；</li> 单指绘制；</li> 双指缩放和平移。</li> </ul> 在真实壁纸上直接编辑的主要优势，是能够准确判断主体边缘与背景之间的关系。对于头发、衣物边缘和复杂轮廓，放大后逐步修整通常比单独编辑黑白蒙版更直观。 保存后，当前景深预览会自动刷新，无需退出 Wallpapers 后重新进入编辑页。 </a> 导入外部 PNG</h3> 对于习惯使用 Photoshop、Affinity Photo、GIMP 等图像工具的用户，可以直接导入外部 PNG 作为景深蒙版。 蒙版语义如下： 蒙版内容</th> 含义</th></tr></thead> 白色 / 不透明</td> 前景</td></tr> 黑色 / 透明</td> 背景</td></tr> 灰色 / 半透明</td> 羽化或过渡区域</td></tr> </tbody></table> 建议外部 PNG 与原始壁纸保持相同尺寸和比例，以减少后续裁切和缩放带来的偏差。 对于轮廓要求较高的壁纸，可以先使用 ColorOS AI 生成基础蒙版，再在内置编辑器中进行初步调整，最后使用外部图像工具完成更精细的处理。 </a> 蒙版组合方式</h2> 保存蒙版后，可以设置自定义蒙版与 ColorOS 原始景深结果之间的组合关系。 替换：完全使用自定义蒙版；</li> 并集：保留自定义蒙版和系统结果的全部前景区域；</li> 交集：仅保留两者共同识别为前景的区域；</li> 反转：交换前景与背景关系。</li> </ul> 对于已经完整制作好的自定义蒙版，通常直接使用替换 即可。并集和交集更适合在系统原始结果基础上进行局部补充或范围限制。 </a> 蒙版持久化与状态一致性</h2> 仅在编辑页中替换当前显示的 bitmap 并不能完整解决实际使用中的问题。ColorOS 的景深状态同时涉及界面开关、当前预览、内部壁纸模型和最终锁屏资源生成等多个环节。 如果这些状态没有同步，可能出现以下情况： 编辑页显示新的自定义蒙版 ↓ 点击应用 ↓ 最终锁屏仍使用之前的系统 AI 前景</code></pre> 也可能出现： 景深开关显示为开启 ↓ 当前预览实际上没有景深效果</code></pre> 因此，ColorOSDepthMask 会在保存蒙版后同步当前壁纸的景深状态，并在重新进入同一张壁纸时尝试恢复之前保存的蒙版。 保存、导入或修改组合方式后，当前预览会立即更新；最终点击“应用”时，也会确保当前自定义蒙版参与锁屏景深资源生成，避免继续复用旧的前景结果。 此前部分情况下，保存蒙版后 ColorOS 的“应用”按钮仍会保持禁用状态，需要再次拖动壁纸才会恢复。现在模块会同步触发系统自身的“已编辑”状态，因此保存后可以直接继续应用。 </a> 景深开关保持手动控制</h2> ColorOS 原生逻辑会根据 AI 识别结果和当前资源状态自动修改景深开关，包括自动开启、关闭、禁用或灰显。 对于系统完全自动生成的景深结果，这种逻辑有其合理性；但在已经存在用户自定义蒙版的情况下，是否启用景深更适合由用户自行决定。 因此，在自定义蒙版生效时，ColorOSDepthMask 会尽量保持景深开关的手动状态。用户开启时保持开启，关闭时保持关闭，不再由系统 AI 结果自动改变当前选择。 </a> 独立 App</h2> 除了 LSPosed 模块本身，ColorOSDepthMask 还包含一个独立控制 App，用于管理常用操作和诊断信息。 </a> 首页</h3> 首页只保留高频内容： 当前模块版本；</li> com.oplus.wallpapers</code> 版本；</li> Root 状态；</li> ColorOS / Android 摘要；</li> GitHub Release 更新状态；</li> 重载 Wallpapers；</li> 重载 SystemUI。</li> </ul> 安装或更新模块后，可以直接通过重载壁纸 重新启动 com.oplus.wallpapers</code>，使新的 Hook 重新加载。 </a> 诊断</h3> 诊断页用于集中查看运行环境，包括： 模块版本和签名；</li> Wallpapers 版本；</li> ColorOS / Android 信息；</li> Root 管理器和 Root shell；</li> LSPosed；</li> Kernel；</li> SELinux；</li> Verified Boot 等。</li> </ul> 每一项都可以单独复制，也可以一次复制完整诊断信息。出现系统更新或兼容性问题时，可以直接将这份信息附在 Issue 中。 </a> 项目</h3> 项目页提供以下入口： 项目仓库；</li> Releases；</li> Issues；</li> 开发者 GitHub；</li> Blog。</li> </ul> App 启动后还会检查 GitHub Releases。发现新版本时，可以直接下载 APK；下载完成后会检查包名、版本和签名，再交由 Android 系统安装器处理。 </a> 安装</h2> 目前主要针对以下环境进行开发和测试： ColorOS 16；</li> Android 16；</li> com.oplus.wallpapers</code> 16.10.x；</li> LSPosed；</li> KernelSU / KernelSU Next / Magisk / APatch 等 Root 环境。</li> </ul> 安装步骤如下： 前往 Releases</a> 下载最新版 APK；</li> 安装 APK；</li> 在 LSPosed 中启用 DepthMask；</li> 作用域只勾选 com.oplus.wallpapers</code>；</li> 打开 DepthMask App 并授予 Root；</li> 点击重载壁纸；</li> 重新打开 ColorOS 锁屏壁纸编辑器。</li> </ol> 正常情况下，锁屏编辑页底部功能栏会出现新的蒙版 入口。 Root 主要用于独立 App 重载 Wallpapers / SystemUI 和读取额外诊断信息。LSPosed 模块的作用域仍然只需要 com.oplus.wallpapers</code>，无需额外选择 SystemUI 或 Launcher。 </blockquote> </a> 基本使用流程</h2> 对于普通使用场景，可以按照以下顺序完成一张自定义景深壁纸： 选择锁屏壁纸；</li> 进入 ColorOS 锁屏壁纸编辑器；</li> 点击蒙版；</li> 点击自动生成；</li> 在编辑器中修正 AI 漏检或误检区域；</li> 保存蒙版；</li> 蒙版模式保持替换；</li> 手动开启景深；</li> 检查预览；</li> 点击应用。</li> </ol> 如果系统 AI 无法正确识别主体，也可以跳过自动生成，直接从空白蒙版开始编辑，或导入已经制作好的 PNG。 </a> 兼容性说明</h2> ColorOSDepthMask 依赖 com.oplus.wallpapers</code> 的内部类、方法和资源，而这些内容并不属于公开稳定 API。 因此，ColorOS 或 Wallpapers 大版本更新后，模块可能需要重新适配。 如果系统更新后出现以下情况： 蒙版入口消失；</li> 景深开关状态异常；</li> 保存后预览没有刷新；</li> 最终锁屏与编辑页预览不一致；</li> </ul> 可以先在 DepthMask App 中执行一次重载壁纸。如果问题仍然存在，可以进入诊断页复制完整诊断信息，并提交到 GitHub Issues</a>。 </a> 项目地址</h2> GitHub 仓库</a></li> Releases</a></li> Issues</a></li> </ul> ColorOSDepthMask 主要面向希望继续使用 ColorOS 原生锁屏景深能力，同时需要自行调整前景区域的用户。相比重新实现一套独立景深系统，它更强调与 ColorOS 现有编辑和应用流程保持一致。

canxin's blog - 景深壁纸

ColorOSDepthMask：为 ColorOS 景深壁纸增加可编辑蒙版