
Emerald Veil · 功能说明
动态壁纸照常播放,泡泡进场时借用虚拟屏上选好的那张画面拍一张静止底图;主动黑屏保护开启时,泡泡不会反过来盖在黑罩上。
当前情况:现在的做法是“借画面拍快照”,不再暂停或恢复 Wallpaper Engine;源码已核对,这次没有做真实屏幕共存测试。会下雨的动态壁纸实验已停用。
项目快照核对于 2026-11-04(北京时间):运行结果来自 09:07–09:17 的只读检查,源码核对到 4a4e70f;具体测试和退役事件保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


Emerald Veil · 功能说明
动态壁纸照常播放,泡泡进场时借用虚拟屏上选好的那张画面拍一张静止底图;主动黑屏保护开启时,泡泡不会反过来盖在黑罩上。
当前情况:现在的做法是“借画面拍快照”,不再暂停或恢复 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 壁纸并记下原因,不把泡泡出现当成用上了动态材料。
外部黑罩正在保护屏幕时,被盖住的那块屏主动让位;静态图片恢复仍可独立使用。

启用泡泡后不用另外操作:进场时自动借用虚拟屏的壁纸材料拍底图,有黑罩标记的屏自动让位。会下雨的动态壁纸实验已停用,没有可运行的入口。
- 是否要显示泡泡
- 看到底图不对或黑罩冲突时描述现象


启用泡泡后不用另外操作:进场时自动借用虚拟屏的壁纸材料拍底图,有黑罩标记的屏自动让位。会下雨的动态壁纸实验已停用,没有可运行的入口。
- 是否要显示泡泡
- 看到底图不对或黑罩冲突时描述现象


这里保留实现、关键条件、精确入口、历史记录和验证结果。
源码已核对到 4a4e70f,11 月 4 日未触发共存实屏

- 底图来源先要求虚拟屏只有一个可确认的 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 日未触发共存实屏

- 底图来源先要求虚拟屏只有一个可确认的 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 日

- 雨景实验当前受版本控制的只剩 ART_DIRECTION.md,留存的认可参数为绿色鲜度 50%、雨量 75%、风 0%、薄雾 50%、空间微动 0%。Windows 实际使用选定 PNG,猫分层、补画和 HDR 都不是待办。


- 雨景实验当前受版本控制的只剩 ART_DIRECTION.md,留存的认可参数为绿色鲜度 50%、雨量 75%、风 0%、薄雾 50%、空间微动 0%。Windows 实际使用选定 PNG,猫分层、补画和 HDR 都不是待办。



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

说明泡泡怎样借用虚拟屏的 Wallpaper Engine 材料拍进场底图、怎样按屏让位给外部黑罩,以及已停用的雨景实验和系统图片的区别。
解决什么
旧做法是进场前停掉 Wallpaper Engine、等 2 秒、结束后再续播,9 月 18 日已删除。现在认不准材料或临时小窗失败只会回退到 Windows 壁纸;只有虚拟屏的 Windows 底图来源本身确认不了、或原生泡泡初始化失败,才算这一轮显示失败并进入冷却。真实的共存画面这次没有证明。


Local\EmeraldVeil.Blackout.<设备名> 只挡那一块屏,旧的 Local\EmeraldVeil.ExternalProtectionPause 在没有按屏标记时挡全部屏;泡泡只探测存在性,最后句柄关闭后恢复原规则。
说明泡泡怎样借用虚拟屏的 Wallpaper Engine 材料拍进场底图、怎样按屏让位给外部黑罩,以及已停用的雨景实验和系统图片的区别。
解决什么
旧做法是进场前停掉 Wallpaper Engine、等 2 秒、结束后再续播,9 月 18 日已删除。现在认不准材料或临时小窗失败只会回退到 Windows 壁纸;只有虚拟屏的 Windows 底图来源本身确认不了、或原生泡泡初始化失败,才算这一轮显示失败并进入冷却。真实的共存画面这次没有证明。

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


- Wallpaper Engine 材料认不准或临时小窗开不起来: 回退到虚拟屏的 Windows 壁纸、颜色和适配方式,并记下回退原因;不随意停止其他壁纸进程。
- 虚拟屏底图来源确认不了,或原生泡泡初始化失败: 这一轮显示失败,撤掉底图,按启动失败冷却规则处理;不承诺画面已恢复。
- 外部黑罩持有者崩溃: 最后句柄关闭后标记自然消失,恢复已有的空闲规则;不留下持久暂停文件。

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


- Wallpaper Engine 材料认不准或临时小窗开不起来: 回退到虚拟屏的 Windows 壁纸、颜色和适配方式,并记下回退原因;不随意停止其他壁纸进程。
- 虚拟屏底图来源确认不了,或原生泡泡初始化失败: 这一轮显示失败,撤掉底图,按启动失败冷却规则处理;不承诺画面已恢复。
- 外部黑罩持有者崩溃: 最后句柄关闭后标记自然消失,恢复已有的空闲规则;不留下持久暂停文件。

- 北京时间 11 月 4 日核对的是上面的现役源码(到 4a4e70f):离屏临时小窗、回退规则、按屏黑罩标记;旧的停播/续播控制器已于 9 月 18 日删除,不再作为依据。
- 这次没有新跑黑罩标记测试,没有持有实际生产黑罩标记,也没有启停 Wallpaper Engine 或显示泡泡;源码里定义的 68 个测试方法和 GitHub 上最近 5 次成功的自动构建,与画面验收分开看。
- 真实屏幕共存、主屏黑罩和远控画面都没有实测;多屏加 Wallpaper Engine 时底图左边可能错位,候选修法测过但没发布、没安装、没在实体屏验收。
泡泡借用动态壁纸是一条运行机制;会下雨的动态壁纸实验已停用,Windows桌面与锁屏实际采用已保存的静帧。

- 北京时间 11 月 4 日核对的是上面的现役源码(到 4a4e70f):离屏临时小窗、回退规则、按屏黑罩标记;旧的停播/续播控制器已于 9 月 18 日删除,不再作为依据。
- 这次没有新跑黑罩标记测试,没有持有实际生产黑罩标记,也没有启停 Wallpaper Engine 或显示泡泡;源码里定义的 68 个测试方法和 GitHub 上最近 5 次成功的自动构建,与画面验收分开看。
- 真实屏幕共存、主屏黑罩和远控画面都没有实测;多屏加 Wallpaper Engine 时底图左边可能错位,候选修法测过但没发布、没安装、没在实体屏验收。
泡泡借用动态壁纸是一条运行机制;会下雨的动态壁纸实验已停用,Windows桌面与锁屏实际采用已保存的静帧。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:和动态壁纸、外部黑罩共存;仓库:wlyaaaaa/emerald-veil;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








