和动态壁纸、外部黑罩共存
现在
偶尔用 · 快照核对 11 月 4 日
真实屏幕共存和黑罩让位还没实测
截至 11 月 4 日 · 项目源码静态核对

动态壁纸照常播放,泡泡进场时借用虚拟屏上选好的那张画面拍一张静止底图;主动黑屏保护开启时,泡泡不会反过来盖在黑罩上。

当前情况:现在的做法是“借画面拍快照”,不再暂停或恢复 Wallpaper Engine;源码已核对,这次没有做真实屏幕共存测试。会下雨的动态壁纸实验已停用。

项目快照核对于 2026-11-04(北京时间):运行结果来自 09:07–09:17 的只读检查,源码核对到 4a4e70f;具体测试和退役事件保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

和动态壁纸、外部黑罩共存
现在
偶尔用 · 快照核对 11 月 4 日
真实屏幕共存和黑罩让位还没实测
截至 11 月 4 日 · 项目源码静态核对

动态壁纸照常播放,泡泡进场时借用虚拟屏上选好的那张画面拍一张静止底图;主动黑屏保护开启时,泡泡不会反过来盖在黑罩上。

当前情况:现在的做法是“借画面拍快照”,不再暂停或恢复 Wallpaper Engine;源码已核对,这次没有做真实屏幕共存测试。会下雨的动态壁纸实验已停用。

项目快照核对于 2026-11-04(北京时间):运行结果来自 09:07–09:17 的只读检查,源码核对到 4a4e70f;具体测试和退役事件保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

这项功能怎样使用
为什么需要它

泡泡底下需要一张像样的底图,而我平时的画面是 Wallpaper Engine(动态壁纸软件)在放;如果为了取底图去停它、再恢复,容易卡在过渡画面或恢复失败。另一个主动黑罩有自己的显示目的,不能由泡泡抢回来;这些冲突需要在各自入口处理。

举个实际例子

“动态壁纸别动,我打开主屏黑罩时泡泡也别冒出来。”泡泡进场时,程序在屏幕外开一个只给自己用的临时小窗,按虚拟屏的选择载入同一份壁纸材料,拍下一帧当底图;原来的动态壁纸一直在放。哪块屏挂着黑罩,那块屏就不放泡泡。

最后我会得到什么

Wallpaper Engine 的图片、播放列表和设置都不被改动,也不会被暂停;泡泡下面是进场那一刻的静止一帧。外部黑罩开启时让位,撤掉后仍按本来的空闲规则决定是否显示。

这项功能怎样使用
为什么需要它

泡泡底下需要一张像样的底图,而我平时的画面是 Wallpaper Engine(动态壁纸软件)在放;如果为了取底图去停它、再恢复,容易卡在过渡画面或恢复失败。另一个主动黑罩有自己的显示目的,不能由泡泡抢回来;这些冲突需要在各自入口处理。

举个实际例子

“动态壁纸别动,我打开主屏黑罩时泡泡也别冒出来。”泡泡进场时,程序在屏幕外开一个只给自己用的临时小窗,按虚拟屏的选择载入同一份壁纸材料,拍下一帧当底图;原来的动态壁纸一直在放。哪块屏挂着黑罩,那块屏就不放泡泡。

最后我会得到什么

Wallpaper Engine 的图片、播放列表和设置都不被改动,也不会被暂停;泡泡下面是进场那一刻的静止一帧。外部黑罩开启时让位,撤掉后仍按本来的空闲规则决定是否显示。

结果怎么看
正常工作

能认准虚拟屏上正在渲染的那份 Wallpaper Engine 材料时,用它拍底图;没有运行 Wallpaper Engine 就直接用虚拟屏的 Windows 壁纸。

发现问题

材料认不准或临时小窗开不起来时,改用虚拟屏的 Windows 壁纸并记下原因,不把泡泡出现当成用上了动态材料。

暂不可用

外部黑罩正在保护屏幕时,被盖住的那块屏主动让位;静态图片恢复仍可独立使用。

结果怎么看
正常工作

能认准虚拟屏上正在渲染的那份 Wallpaper Engine 材料时,用它拍底图;没有运行 Wallpaper Engine 就直接用虚拟屏的 Windows 壁纸。

发现问题

材料认不准或临时小窗开不起来时,改用虚拟屏的 Windows 壁纸并记下原因,不把泡泡出现当成用上了动态材料。

暂不可用

外部黑罩正在保护屏幕时,被盖住的那块屏主动让位;静态图片恢复仍可独立使用。

从哪里开始

启用泡泡后不用另外操作:进场时自动借用虚拟屏的壁纸材料拍底图,有黑罩标记的屏自动让位。会下雨的动态壁纸实验已停用,没有可运行的入口。

需要准备什么
  • 是否要显示泡泡
  • 看到底图不对或黑罩冲突时描述现象
从开始到拿到结果
1先检查占用
看哪块屏挂着黑罩标记,被盖住的屏不放泡泡;静态壁纸恢复也不改 Wallpaper Engine。
2借材料拍底图
能确认虚拟屏上唯一的那份材料时,在屏幕外临时小窗里载入它;认不准就用虚拟屏的 Windows 壁纸,画好后再启动原生泡泡。
3结束时只收自己的
收起泡泡时只关掉本次的临时小窗和合成画面,不碰桌面上正在播放的壁纸。
从哪里开始

启用泡泡后不用另外操作:进场时自动借用虚拟屏的壁纸材料拍底图,有黑罩标记的屏自动让位。会下雨的动态壁纸实验已停用,没有可运行的入口。

需要准备什么
  • 是否要显示泡泡
  • 看到底图不对或黑罩冲突时描述现象
从开始到拿到结果
1先检查占用
看哪块屏挂着黑罩标记,被盖住的屏不放泡泡;静态壁纸恢复也不改 Wallpaper Engine。
2借材料拍底图
能确认虚拟屏上唯一的那份材料时,在屏幕外临时小窗里载入它;认不准就用虚拟屏的 Windows 壁纸,画好后再启动原生泡泡。
3结束时只收自己的
收起泡泡时只关掉本次的临时小窗和合成画面,不碰桌面上正在播放的壁纸。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

源码已核对到 4a4e70f,11 月 4 日未触发共存实屏

关键规则与设计选择
1
不全局停止、暂停、重放或重新配置 Wallpaper Engine,初始化失败也不发停播/续播命令;只读它的 config.json 里虚拟屏对应的选图和属性,不改播放列表、壁纸选择或持久配置。
2
只有本会话里确实在虚拟屏上渲染的 wallpaper64 或 wallpaper32、桌面窗口与虚拟屏边界对得上、材料配置和实际文件也匹配时,才用这份材料;任何一项不成立就回退到虚拟屏的 Windows 壁纸、颜色和适配方式。
3
外部黑罩用同会话命名句柄表示仍需保护,可以按屏挂,也兼容旧的全屏标记;持有方退出自动释放,避免一个忘记清理的文件让泡泡永久暂停。
4
会下雨的动态壁纸实验已在 9 月 8 日终止、9 月 29 日删掉实验文件,只留下方向记录和认可的雨幕参数;现役静态壁纸和泡泡都没有因为这个实验改变。
当前怎样实现
  • 底图来源先要求虚拟屏只有一个可确认的 Windows 底图来源;再看 Wallpaper Engine 的 config.json 里本人设的显示器对应关系和 MonitorN 选图及属性,三者对上才走材料路径。复制出来的临时材料音量设为 0,不影响原来的声音。
  • 走材料路径时,开一个准确命名的官方离屏临时窗口 EmeraldVeil.Background.<进程号>.<GUID>,放在坐标 (-32000,-32000),用 openWallpaper / playInWindow 载入、applyProperties 只作用于这个窗口,再用 DWM 缩略图合成进底图;每条控制命令限时 3 秒。WPF 渲染并 DwmFlush 后才启动泡泡,泡泡拿到的是这一帧。
  • 退出时只关掉本次的命名窗口和缩略图;程序启动时清理一次真正没人管的旧临时窗口,不改桌面壁纸窗口。运行中材料或引擎状态变了,就撤掉旧画面重新走一遍进场;1 秒一次的背景检查不是持续抓画面,也不是每次都重启泡泡。
  • 黑罩标记只探测存在性并马上关闭自己的探测句柄;按屏标记只排除对应屏,旧的全屏标记在没有按屏标记时排除全部目标。50ms策略轮询和界面应用前都会检查,共享的空闲计时继续走;不改 enabled、自启、360 秒或显示拓扑,也不把被盖住的实体屏改投到虚拟屏。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

源码已核对到 4a4e70f,11 月 4 日未触发共存实屏

关键规则与设计选择
1
不全局停止、暂停、重放或重新配置 Wallpaper Engine,初始化失败也不发停播/续播命令;只读它的 config.json 里虚拟屏对应的选图和属性,不改播放列表、壁纸选择或持久配置。
2
只有本会话里确实在虚拟屏上渲染的 wallpaper64 或 wallpaper32、桌面窗口与虚拟屏边界对得上、材料配置和实际文件也匹配时,才用这份材料;任何一项不成立就回退到虚拟屏的 Windows 壁纸、颜色和适配方式。
3
外部黑罩用同会话命名句柄表示仍需保护,可以按屏挂,也兼容旧的全屏标记;持有方退出自动释放,避免一个忘记清理的文件让泡泡永久暂停。
4
会下雨的动态壁纸实验已在 9 月 8 日终止、9 月 29 日删掉实验文件,只留下方向记录和认可的雨幕参数;现役静态壁纸和泡泡都没有因为这个实验改变。
当前怎样实现
  • 底图来源先要求虚拟屏只有一个可确认的 Windows 底图来源;再看 Wallpaper Engine 的 config.json 里本人设的显示器对应关系和 MonitorN 选图及属性,三者对上才走材料路径。复制出来的临时材料音量设为 0,不影响原来的声音。
  • 走材料路径时,开一个准确命名的官方离屏临时窗口 EmeraldVeil.Background.<进程号>.<GUID>,放在坐标 (-32000,-32000),用 openWallpaper / playInWindow 载入、applyProperties 只作用于这个窗口,再用 DWM 缩略图合成进底图;每条控制命令限时 3 秒。WPF 渲染并 DwmFlush 后才启动泡泡,泡泡拿到的是这一帧。
  • 退出时只关掉本次的命名窗口和缩略图;程序启动时清理一次真正没人管的旧临时窗口,不改桌面壁纸窗口。运行中材料或引擎状态变了,就撤掉旧画面重新走一遍进场;1 秒一次的背景检查不是持续抓画面,也不是每次都重启泡泡。
  • 黑罩标记只探测存在性并马上关闭自己的探测句柄;按屏标记只排除对应屏,旧的全屏标记在没有按屏标记时排除全部目标。50ms策略轮询和界面应用前都会检查,共享的空闲计时继续走;不改 enabled、自启、360 秒或显示拓扑,也不把被盖住的实体屏改投到虚拟屏。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
1
需要显示泡泡时,先检查每块目标屏的黑罩标记。
2
确认虚拟屏的底图来源;能认准本会话正在渲染的 Wallpaper Engine 材料就开离屏临时小窗载入,认不准就用虚拟屏的 Windows 壁纸。
3
把底图画好并等桌面合成完成,启动原生泡泡并等对应窗口就绪。
4
收起时只关闭本次的临时小窗和缩略图;材料或引擎状态中途变了就撤掉重来。
5
黑罩标记后来出现时被盖住的屏立即让位;最后一个标记消失后按原规则继续。
  • 雨景实验当前受版本控制的只剩 ART_DIRECTION.md,留存的认可参数为绿色鲜度 50%、雨量 75%、风 0%、薄雾 50%、空间微动 0%。Windows 实际使用选定 PNG,猫分层、补画和 HDR 都不是待办。
执行流程
技术实现与依据(二)
1
需要显示泡泡时,先检查每块目标屏的黑罩标记。
2
确认虚拟屏的底图来源;能认准本会话正在渲染的 Wallpaper Engine 材料就开离屏临时小窗载入,认不准就用虚拟屏的 Windows 壁纸。
3
把底图画好并等桌面合成完成,启动原生泡泡并等对应窗口就绪。
4
收起时只关闭本次的临时小窗和缩略图;材料或引擎状态中途变了就撤掉重来。
5
黑罩标记后来出现时被盖住的屏立即让位;最后一个标记消失后按原规则继续。
  • 雨景实验当前受版本控制的只剩 ART_DIRECTION.md,留存的认可参数为绿色鲜度 50%、雨量 75%、风 0%、薄雾 50%、空间微动 0%。Windows 实际使用选定 PNG,猫分层、补画和 HDR 都不是待办。
执行流程
名词和入口
本模块用到的名词
名词意思
DWM(桌面窗口合成器)把临时小窗里的材料用缩略图方式合成进底图,并等底图确实进入一轮桌面合成后再启动原生泡泡,减少取到暂态画面的机会。
黑罩标记黑罩存续时持有的命名句柄:按屏的 Local\EmeraldVeil.Blackout.<设备名> 只挡那一块屏,旧的 Local\EmeraldVeil.ExternalProtectionPause 在没有按屏标记时挡全部屏;泡泡只探测存在性,最后句柄关闭后恢复原规则。
动态雨幕实验(已停用)曾在浏览器里试做会下雨的壁纸和会动的黑猫;猫抠图走样被否掉,9 月 8 日终止,9 月 29 日删掉实验代码和素材,现在只剩 ART_DIRECTION.md 方向记录。
专业定义

说明泡泡怎样借用虚拟屏的 Wallpaper Engine 材料拍进场底图、怎样按屏让位给外部黑罩,以及已停用的雨景实验和系统图片的区别。

解决什么

旧做法是进场前停掉 Wallpaper Engine、等 2 秒、结束后再续播,9 月 18 日已删除。现在认不准材料或临时小窗失败只会回退到 Windows 壁纸;只有虚拟屏的 Windows 底图来源本身确认不了、或原生泡泡初始化失败,才算这一轮显示失败并进入冷却。真实的共存画面这次没有证明。

名词和入口
本模块用到的名词
名词意思
DWM(桌面窗口合成器)
意思:
把临时小窗里的材料用缩略图方式合成进底图,并等底图确实进入一轮桌面合成后再启动原生泡泡,减少取到暂态画面的机会。
黑罩标记
意思:
黑罩存续时持有的命名句柄:按屏的 Local\EmeraldVeil.Blackout.<设备名> 只挡那一块屏,旧的 Local\EmeraldVeil.ExternalProtectionPause 在没有按屏标记时挡全部屏;泡泡只探测存在性,最后句柄关闭后恢复原规则。
动态雨幕实验(已停用)
意思:
曾在浏览器里试做会下雨的壁纸和会动的黑猫;猫抠图走样被否掉,9 月 8 日终止,9 月 29 日删掉实验代码和素材,现在只剩 ART_DIRECTION.md 方向记录。
专业定义

说明泡泡怎样借用虚拟屏的 Wallpaper Engine 材料拍进场底图、怎样按屏让位给外部黑罩,以及已停用的雨景实验和系统图片的区别。

解决什么

旧做法是进场前停掉 Wallpaper Engine、等 2 秒、结束后再续播,9 月 18 日已删除。现在认不准材料或临时小窗失败只会回退到 Windows 壁纸;只有虚拟屏的 Windows 底图来源本身确认不了、或原生泡泡初始化失败,才算这一轮显示失败并进入冷却。真实的共存画面这次没有证明。

出问题时

解决什么

现役程序不停播、不续播,取底图出问题只回退到 Windows 壁纸,不会把正在放的动态壁纸弄停。真实的共存画面到 11 月 4 日还没有实屏验证。

边界
  • 不改Wallpaper Engine持久配置、选图或播放列表,不暂停它,也不提供通用壁纸引擎适配框架;当前只认 wallpaper64 / wallpaper32。
  • 不识别ToDesk、Sunshine等远程产品来决定暂停;黑罩必须通过明确的标记合作。
  • 雨景实验已停用,只有本人重新明确启动才重开;失败草稿不作为能力搬进网页。
失败与恢复
  • Wallpaper Engine 材料认不准或临时小窗开不起来: 回退到虚拟屏的 Windows 壁纸、颜色和适配方式,并记下回退原因;不随意停止其他壁纸进程。
  • 虚拟屏底图来源确认不了,或原生泡泡初始化失败: 这一轮显示失败,撤掉底图,按启动失败冷却规则处理;不承诺画面已恢复。
  • 外部黑罩持有者崩溃: 最后句柄关闭后标记自然消失,恢复已有的空闲规则;不留下持久暂停文件。
出问题时

解决什么

现役程序不停播、不续播,取底图出问题只回退到 Windows 壁纸,不会把正在放的动态壁纸弄停。真实的共存画面到 11 月 4 日还没有实屏验证。

边界
  • 不改Wallpaper Engine持久配置、选图或播放列表,不暂停它,也不提供通用壁纸引擎适配框架;当前只认 wallpaper64 / wallpaper32。
  • 不识别ToDesk、Sunshine等远程产品来决定暂停;黑罩必须通过明确的标记合作。
  • 雨景实验已停用,只有本人重新明确启动才重开;失败草稿不作为能力搬进网页。
失败与恢复
  • Wallpaper Engine 材料认不准或临时小窗开不起来: 回退到虚拟屏的 Windows 壁纸、颜色和适配方式,并记下回退原因;不随意停止其他壁纸进程。
  • 虚拟屏底图来源确认不了,或原生泡泡初始化失败: 这一轮显示失败,撤掉底图,按启动失败冷却规则处理;不承诺画面已恢复。
  • 外部黑罩持有者崩溃: 最后句柄关闭后标记自然消失,恢复已有的空闲规则;不留下持久暂停文件。
依据与来源
真实入口
src/EmeraldVeil.App/VddBackgroundSource.cs / WallpaperSelection.cs / WallpaperEngineBackground.cs
虚拟屏底图来源、Wallpaper Engine 选图读取和离屏临时小窗。
src/EmeraldVeil.App/VeilWindow.cs / VeilController.cs
底图合成、进场快照、回退和界面应用前重查。
src/EmeraldVeil.Core/ExternalProtectionPause.cs
按屏与旧全屏黑罩标记的存在性检查。
experiments/verdant-rain/ART_DIRECTION.md / assets/windows-background.json
已停用雨景实验的方向记录与现役静态选图。
如何验证
  • 北京时间 11 月 4 日核对的是上面的现役源码(到 4a4e70f):离屏临时小窗、回退规则、按屏黑罩标记;旧的停播/续播控制器已于 9 月 18 日删除,不再作为依据。
  • 这次没有新跑黑罩标记测试,没有持有实际生产黑罩标记,也没有启停 Wallpaper Engine 或显示泡泡;源码里定义的 68 个测试方法和 GitHub 上最近 5 次成功的自动构建,与画面验收分开看。
  • 真实屏幕共存、主屏黑罩和远控画面都没有实测;多屏加 Wallpaper Engine 时底图左边可能错位,候选修法测过但没发布、没安装、没在实体屏验收。
与其他模块的关系

泡泡借用动态壁纸是一条运行机制;会下雨的动态壁纸实验已停用,Windows桌面与锁屏实际采用已保存的静帧。

依据与来源
真实入口
src/EmeraldVeil.App/VddBackgroundSource.cs / WallpaperSelection.cs / WallpaperEngineBackground.cs
虚拟屏底图来源、Wallpaper Engine 选图读取和离屏临时小窗。
src/EmeraldVeil.App/VeilWindow.cs / VeilController.cs
底图合成、进场快照、回退和界面应用前重查。
src/EmeraldVeil.Core/ExternalProtectionPause.cs
按屏与旧全屏黑罩标记的存在性检查。
experiments/verdant-rain/ART_DIRECTION.md / assets/windows-background.json
已停用雨景实验的方向记录与现役静态选图。
如何验证
  • 北京时间 11 月 4 日核对的是上面的现役源码(到 4a4e70f):离屏临时小窗、回退规则、按屏黑罩标记;旧的停播/续播控制器已于 9 月 18 日删除,不再作为依据。
  • 这次没有新跑黑罩标记测试,没有持有实际生产黑罩标记,也没有启停 Wallpaper Engine 或显示泡泡;源码里定义的 68 个测试方法和 GitHub 上最近 5 次成功的自动构建,与画面验收分开看。
  • 真实屏幕共存、主屏黑罩和远控画面都没有实测;多屏加 Wallpaper Engine 时底图左边可能错位,候选修法测过但没发布、没安装、没在实体屏验收。
与其他模块的关系

泡泡借用动态壁纸是一条运行机制;会下雨的动态壁纸实验已停用,Windows桌面与锁屏实际采用已保存的静帧。

数字截至 2026 年 11 月 6 日

复制 AI 续作说明

项目:和动态壁纸、外部黑罩共存;仓库:wlyaaaaa/emerald-veil;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。