原生泡泡、空闲触发与输入退出
现在
偶尔用 · 快照核对 11 月 4 日
实屏画面和快捷键 11 月 4 日没有验
截至 11 月 4 日 · 项目源码和本机只读检查

空闲时换成会动的画面,回来操作不需要多一次解锁;重复启动和旧渲染器残留有明确的控制。

当前情况:北京时间 11 月 4 日只读检查时,0.1.39.0 常驻程序唯一在跑(11 月 3 日 16:04 启动),六分钟空闲配置在位;没有合格的实体屏就待命,实际动画与远控画面仍分别验收。

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

项目源码:公开仓库

原生泡泡、空闲触发与输入退出
现在
偶尔用 · 快照核对 11 月 4 日
实屏画面和快捷键 11 月 4 日没有验
截至 11 月 4 日 · 项目源码和本机只读检查

空闲时换成会动的画面,回来操作不需要多一次解锁;重复启动和旧渲染器残留有明确的控制。

当前情况:北京时间 11 月 4 日只读检查时,0.1.39.0 常驻程序唯一在跑(11 月 3 日 16:04 启动),六分钟空闲配置在位;没有合格的实体屏就待命,实际动画与远控画面仍分别验收。

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

项目源码:公开仓库

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

远程软件或设备可能发出指针位置根本没变的消息,导致屏保永远等不到空闲,或刚出现就消失。这里判断事件而非软件名字,同时保留正常输入、可靠计时和故障退出路径。

举个实际例子

“我去倒杯水,六分钟后再显示泡泡,回来动鼠标就继续。”程序运行且启用时按这个规则等待;一条无位移消息不会打断计时。想先看一眼效果,可以点托盘的预览:最多显示 15 秒,期间一动鼠标或键盘也会提前收起。

最后我会得到什么

泡泡出现时,底下垫的是进场那一刻拍下的一张静止底图(取虚拟屏上 Wallpaper Engine 正在用的那张,没有就用该屏的 Windows 壁纸),上面飘着 Windows 原生泡泡;正常输入后先撤底图、再结束本次启动的泡泡。没有合格的实体屏时不显示。源码与配置可核对,实体像素、远控画面和自然开机需单独观察。

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

远程软件或设备可能发出指针位置根本没变的消息,导致屏保永远等不到空闲,或刚出现就消失。这里判断事件而非软件名字,同时保留正常输入、可靠计时和故障退出路径。

举个实际例子

“我去倒杯水,六分钟后再显示泡泡,回来动鼠标就继续。”程序运行且启用时按这个规则等待;一条无位移消息不会打断计时。想先看一眼效果,可以点托盘的预览:最多显示 15 秒,期间一动鼠标或键盘也会提前收起。

最后我会得到什么

泡泡出现时,底下垫的是进场那一刻拍下的一张静止底图(取虚拟屏上 Wallpaper Engine 正在用的那张,没有就用该屏的 Windows 壁纸),上面飘着 Windows 原生泡泡;正常输入后先撤底图、再结束本次启动的泡泡。没有合格的实体屏时不显示。源码与配置可核对,实体像素、远控画面和自然开机需单独观察。

结果怎么看
正常工作

本人离开六分钟且空闲判断可靠时显示泡泡,正常操作回来就收起。

发现问题

泡泡启动失败而本人仍不在时,先冷却 5 秒、再冷却 30 秒各试一次,第三次失败就放弃这一轮空闲的自动尝试;本人已回来就不重新盖住屏幕。

暂不可用

功能被正式停用、输入状态不可靠、没有合格的实体屏、目标屏被黑罩盖住或系统泡泡组件缺失时不显示,也不抢已有实例;这里没有另设“临时暂停”开关。

结果怎么看
正常工作

本人离开六分钟且空闲判断可靠时显示泡泡,正常操作回来就收起。

发现问题

泡泡启动失败而本人仍不在时,先冷却 5 秒、再冷却 30 秒各试一次,第三次失败就放弃这一轮空闲的自动尝试;本人已回来就不重新盖住屏幕。

暂不可用

功能被正式停用、输入状态不可靠、没有合格的实体屏、目标屏被黑罩盖住或系统泡泡组件缺失时不显示,也不抢已有实例;这里没有另设“临时暂停”开关。

从哪里开始

先运行 scripts/Install-EmeraldVeil.ps1 -Action Install,再运行 scripts/Set-NativeBubbles.ps1 -Action Enable;日常等六分钟空闲,也可以按 Ctrl+Win+E、双击托盘图标或点托盘“立即启动”马上显示,或用托盘预览看最多 15 秒。

需要准备什么
  • 是否启用六分钟空闲泡泡
  • 这次是立即启动(一直显示到有输入)还是只预览(最多 15 秒)
从开始到拿到结果
1启用并待机
程序观察可靠输入,并按显示器的硬件身份挑一块可用的实体屏;没有合格的屏或输入状态不可信时保持待命。
2空闲才显示
达到 360 秒、目标屏没被黑罩盖住时,先铺好进场底图,再启动系统原生泡泡。
3输入即结束
有效输入或停用收起这次画面;启动失败时按 5 秒、30 秒冷却重试,第三次失败就停到下一轮空闲。泡泡不能当安全锁屏用。
从哪里开始

先运行 scripts/Install-EmeraldVeil.ps1 -Action Install,再运行 scripts/Set-NativeBubbles.ps1 -Action Enable;日常等六分钟空闲,也可以按 Ctrl+Win+E、双击托盘图标或点托盘“立即启动”马上显示,或用托盘预览看最多 15 秒。

需要准备什么
  • 是否启用六分钟空闲泡泡
  • 这次是立即启动(一直显示到有输入)还是只预览(最多 15 秒)
从开始到拿到结果
1启用并待机
程序观察可靠输入,并按显示器的硬件身份挑一块可用的实体屏;没有合格的屏或输入状态不可信时保持待命。
2空闲才显示
达到 360 秒、目标屏没被黑罩盖住时,先铺好进场底图,再启动系统原生泡泡。
3输入即结束
有效输入或停用收起这次画面;启动失败时按 5 秒、30 秒冷却重试,第三次失败就停到下一轮空闲。泡泡不能当安全锁屏用。
技术实现与依据(一)

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

北京时间 11 月 4 日只读检查:0.1.39.0 常驻 1 个,360 秒配置在位(常驻健康是 10 月 11 日安装 Verify 的结果)

关键规则与设计选择
1
零位移WM_MOUSEMOVE(鼠标移动消息)被过滤;孤立的注入移动仍送给应用,只暂不计为空闲活动。250ms内出现第二次注入移动才确认连续活动。
2
物理移动、确认连续注入、按钮、滚轮和键盘都算活动;不记录按键内容、坐标历史或工具名单。
3
预览(--preview)最长 15 秒,期限到、出现可靠输入、输入状态不可靠或显示被禁止都会提前收起,预览结束也不会马上接成一次空闲自动显示;立即启动(--show-now、托盘双击、Ctrl+Win+E)没有 15 秒期限,一直显示到有效输入或停用。停用、输入不可靠和目标不合格都优先于手动显示。
4
按 Windows 设备身份选一块可用的实体桌面屏,优先其中的主屏,再按设备名稳定排序;虚拟屏(VDD,硬件身份 MONITOR\MTT1337)、仪表屏(MONITOR\TUR0000 及排除名单)、认不出身份、被黑罩盖住或尺寸异常的屏都不算。显示/DPI(显示缩放)变化只让目标重新检查,目标真的换了才撤掉旧画面重选;泡泡大小由原生实现决定。
当前怎样实现
  • 50ms采样配合IdleTimeline处理输入时钟;原始tick先于分类到达时先挂起一轮,下一轮仍未分类则算活动,不无限忽略未知输入。
  • 启用后以系统 %WINDIR%\System32\Bubbles.scr /s 启动,不依赖Windows自动屏保触发。会话文件租约和同会话只读进程检查避免重复启动、不抢别人的实例,已启动子进程归kill-on-close作业对象。
  • Per-Monitor V2(每显示器DPI感知)在窗口创建前生效;用所选实体屏的物理矩形定位。没有合格目标时保持启用和计时,但不启动画面,也不按猜测的屏号改投到虚拟屏;不提供多屏任意排布配置器。
  • 进场前先准备底图:虚拟屏上本会话 Wallpaper Engine 的当前材料,缺可用材料时用该虚拟屏的 Windows 壁纸、颜色和适配方式;WPF 渲染完成并 DwmFlush(等桌面合成刷新)后才启动泡泡。底图输入穿透、不激活,每100ms保持在泡泡窗口下;原生泡泡窗口以不透明度 255 的分层方式保留全部玻璃像素,分层样式只用于点击穿透等窗口约定,每250ms维护边界与样式。
技术实现与依据(一)

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

北京时间 11 月 4 日只读检查:0.1.39.0 常驻 1 个,360 秒配置在位(常驻健康是 10 月 11 日安装 Verify 的结果)

关键规则与设计选择
1
零位移WM_MOUSEMOVE(鼠标移动消息)被过滤;孤立的注入移动仍送给应用,只暂不计为空闲活动。250ms内出现第二次注入移动才确认连续活动。
2
物理移动、确认连续注入、按钮、滚轮和键盘都算活动;不记录按键内容、坐标历史或工具名单。
3
预览(--preview)最长 15 秒,期限到、出现可靠输入、输入状态不可靠或显示被禁止都会提前收起,预览结束也不会马上接成一次空闲自动显示;立即启动(--show-now、托盘双击、Ctrl+Win+E)没有 15 秒期限,一直显示到有效输入或停用。停用、输入不可靠和目标不合格都优先于手动显示。
4
按 Windows 设备身份选一块可用的实体桌面屏,优先其中的主屏,再按设备名稳定排序;虚拟屏(VDD,硬件身份 MONITOR\MTT1337)、仪表屏(MONITOR\TUR0000 及排除名单)、认不出身份、被黑罩盖住或尺寸异常的屏都不算。显示/DPI(显示缩放)变化只让目标重新检查,目标真的换了才撤掉旧画面重选;泡泡大小由原生实现决定。
当前怎样实现
  • 50ms采样配合IdleTimeline处理输入时钟;原始tick先于分类到达时先挂起一轮,下一轮仍未分类则算活动,不无限忽略未知输入。
  • 启用后以系统 %WINDIR%\System32\Bubbles.scr /s 启动,不依赖Windows自动屏保触发。会话文件租约和同会话只读进程检查避免重复启动、不抢别人的实例,已启动子进程归kill-on-close作业对象。
  • Per-Monitor V2(每显示器DPI感知)在窗口创建前生效;用所选实体屏的物理矩形定位。没有合格目标时保持启用和计时,但不启动画面,也不按猜测的屏号改投到虚拟屏;不提供多屏任意排布配置器。
  • 进场前先准备底图:虚拟屏上本会话 Wallpaper Engine 的当前材料,缺可用材料时用该虚拟屏的 Windows 壁纸、颜色和适配方式;WPF 渲染完成并 DwmFlush(等桌面合成刷新)后才启动泡泡。底图输入穿透、不激活,每100ms保持在泡泡窗口下;原生泡泡窗口以不透明度 255 的分层方式保留全部玻璃像素,分层样式只用于点击穿透等窗口约定,每250ms维护边界与样式。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
1
读取输入,形成可靠空闲或活动观察。
2
检查enabled、立即启动或预览请求、输入是否可靠,并按硬件身份选出未被黑罩盖住的实体屏;没有合格的屏就待命,不改投到VDD。
3
可靠空闲达到360秒后准备进场底图并等桌面合成完成,取得本会话租约,启动系统泡泡。
4
维护底图和原生窗口的层级与边界,持续对照实际渲染器是否存在;目标屏真的变了才撤掉旧画面重选。
5
活动或停用时先撤底图再收口泡泡;仍空闲但启动失败时按5秒、30秒冷却重试,第三次失败停到下一轮。
  • 原生窗口连续8次(每次间隔250ms,约2秒)维护失败才结束渲染器,1秒一次的状态协调检查仍在。启动失败另有冷却:第一次失败等5秒、第二次等30秒、第三次停掉这一轮空闲的自动尝试;有意义的输入、允许的手动重试或目标改变会重置,成功显示满30秒清掉旧失败。原生窗口初始化限5秒,取消时最多等6秒。输入先隐藏窗口再收口进程,50ms是采样周期而非绝对完成时限。
  • Radius DWORD 1130000000按单精度浮点解释为218.431640625(约218.43)。9 月当时的实现解释是 Windows 原生 /s 把最大半径钳到 200、名义直径 400 物理像素、4K 下约 26 颗,之后未重新核对,当前画面也没有实测;不写SphereDensity,缩放比例不用于计算泡泡大小。
  • Ctrl+Win+E复用现有低级键盘观察器,由驻留进程唯一拥有;只消费该组合,全部松键并稳定约250ms后建立输入基线。托盘双击和立即启动一直显示到有效输入或停用,只有预览限15秒。正常输入继续交给应用,不另建全局热键服务。
执行流程
技术实现与依据(二)
1
读取输入,形成可靠空闲或活动观察。
2
检查enabled、立即启动或预览请求、输入是否可靠,并按硬件身份选出未被黑罩盖住的实体屏;没有合格的屏就待命,不改投到VDD。
3
可靠空闲达到360秒后准备进场底图并等桌面合成完成,取得本会话租约,启动系统泡泡。
4
维护底图和原生窗口的层级与边界,持续对照实际渲染器是否存在;目标屏真的变了才撤掉旧画面重选。
5
活动或停用时先撤底图再收口泡泡;仍空闲但启动失败时按5秒、30秒冷却重试,第三次失败停到下一轮。
  • 原生窗口连续8次(每次间隔250ms,约2秒)维护失败才结束渲染器,1秒一次的状态协调检查仍在。启动失败另有冷却:第一次失败等5秒、第二次等30秒、第三次停掉这一轮空闲的自动尝试;有意义的输入、允许的手动重试或目标改变会重置,成功显示满30秒清掉旧失败。原生窗口初始化限5秒,取消时最多等6秒。输入先隐藏窗口再收口进程,50ms是采样周期而非绝对完成时限。
  • Radius DWORD 1130000000按单精度浮点解释为218.431640625(约218.43)。9 月当时的实现解释是 Windows 原生 /s 把最大半径钳到 200、名义直径 400 物理像素、4K 下约 26 颗,之后未重新核对,当前画面也没有实测;不写SphereDensity,缩放比例不用于计算泡泡大小。
  • Ctrl+Win+E复用现有低级键盘观察器,由驻留进程唯一拥有;只消费该组合,全部松键并稳定约250ms后建立输入基线。托盘双击和立即启动一直显示到有效输入或停用,只有预览限15秒。正常输入继续交给应用,不另建全局热键服务。
执行流程

数字截至 2026 年 11 月 6 日

名词和入口
本模块用到的名词
名词意思
GetLastInputInfo系统最近一次输入时间,结合窄事件分类计算是否可靠空闲。
Job Object(作业对象)本次启动的泡泡归属一个关闭即杀子进程的系统对象,退出不靠寻找并接管别人的实例。
进场快照泡泡启动前先把底图画好并等桌面合成完成,原生泡泡以这一帧作为自己的背景;它是静止的一张,不持续抓取画面,也不对泡泡窗口做抠色透明,原生玻璃的半透明像素全部保留。
专业定义

六分钟输入判断、进场底图快照与原生进程恢复,保留Windows自己的泡泡材质和运动。

解决什么

9 月 8 日曾发现注册表超时 600 与运行时 360 不一致、常驻程序没有运行,当时已恢复;那是历史事件,这次没有做安装或恢复。北京时间 11 月 4 日只读检查看到 0.1.39.0 常驻唯一,配置为 360 秒、非安全退出、Windows 自动屏保关闭。这些检查和源码里的测试都不能推定实屏和远端画面已通过。

名词和入口
本模块用到的名词
名词意思
GetLastInputInfo
意思:
系统最近一次输入时间,结合窄事件分类计算是否可靠空闲。
Job Object(作业对象)
意思:
本次启动的泡泡归属一个关闭即杀子进程的系统对象,退出不靠寻找并接管别人的实例。
进场快照
意思:
泡泡启动前先把底图画好并等桌面合成完成,原生泡泡以这一帧作为自己的背景;它是静止的一张,不持续抓取画面,也不对泡泡窗口做抠色透明,原生玻璃的半透明像素全部保留。
专业定义

六分钟输入判断、进场底图快照与原生进程恢复,保留Windows自己的泡泡材质和运动。

解决什么

9 月 8 日曾发现注册表超时 600 与运行时 360 不一致、常驻程序没有运行,当时已恢复;那是历史事件,这次没有做安装或恢复。北京时间 11 月 4 日只读检查看到 0.1.39.0 常驻唯一,配置为 360 秒、非安全退出、Windows 自动屏保关闭。这些检查和源码里的测试都不能推定实屏和远端画面已通过。

出问题时

解决什么

9 月 8 日修复前发现注册表超时600与运行时360不一致,且常驻程序没有运行,当天已恢复;这是历史。11 月 4 日只读核对 360 秒设置通过、常驻 1 个,没有修复或启动。不能由37项测试通过再推定实屏和远端画面也已通过。

边界
  • 使用Windows已安装的Bubbles.scr,不复制微软二进制或重画泡泡。
  • 原生边缘、碰撞与数量由Windows决定;不承诺每颗泡泡始终完整在屏幕内。
  • 不做屏幕捕获、网络或持久活动记录;泡泡也不能保证防止OLED烙印。电池模式先息屏是另一条系统策略。
失败与恢复
  • 原生泡泡缺失或已有实例: 缺失报错;别人的实例拒绝抢占也不接管。仍满足显示条件时后续可以再试,启动失败按冷却规则处理,不连续硬试。
  • 输入分类没有及时给出结果: 原始变化先挂起一轮,下一次仍未知就计为活动,保持可退出。
  • 渲染器退出或显示器变化: 显示/DPI变化先重新检查目标;目标真的变了才撤旧画面重选,没有合格目标就待命,不维持两个并存窗口。
出问题时

解决什么

9 月 8 日修复前发现注册表超时600与运行时360不一致,且常驻程序没有运行,当天已恢复;这是历史。11 月 4 日只读核对 360 秒设置通过、常驻 1 个,没有修复或启动。不能由37项测试通过再推定实屏和远端画面也已通过。

边界
  • 使用Windows已安装的Bubbles.scr,不复制微软二进制或重画泡泡。
  • 原生边缘、碰撞与数量由Windows决定;不承诺每颗泡泡始终完整在屏幕内。
  • 不做屏幕捕获、网络或持久活动记录;泡泡也不能保证防止OLED烙印。电池模式先息屏是另一条系统策略。
失败与恢复
  • 原生泡泡缺失或已有实例: 缺失报错;别人的实例拒绝抢占也不接管。仍满足显示条件时后续可以再试,启动失败按冷却规则处理,不连续硬试。
  • 输入分类没有及时给出结果: 原始变化先挂起一轮,下一次仍未知就计为活动,保持可退出。
  • 渲染器退出或显示器变化: 显示/DPI变化先重新检查目标;目标真的变了才撤旧画面重选,没有合格目标就待命,不维持两个并存窗口。
依据与来源
真实入口
src/EmeraldVeil.Core
空闲、输入分类、预览期限、启动失败冷却和状态协调。
src/EmeraldVeil.App/NativeBubblesLauncher.cs / VeilWindow.cs
真实进程、Job Object(作业对象)、原生窗口约定和进场底图。
src/EmeraldVeil.App/VeilController.cs / TrayIconHost.cs
50ms循环、立即启动、15秒预览与托盘控制。
docs/product-design.md
显示目标、尺寸、输入和验收边界。
如何验证
  • 9月8日37项测试通过,含原36项核心/源码约定与新增控制命令非零退出回归;这是当日记录。当前源码共定义68个测试方法(62个Fact、6个Theory),这次没有重新运行;GitHub 上最近5次自动构建都显示成功,最新一次在北京时间10月31日03:29(提交 4a4e70f),11 月 4 日没有触发新构建。
  • 北京时间11月4日只读 Set-NativeBubbles -Action Verify 通过:enabled、360秒(运行时也是360)、windows_fullscreen_trigger=false、secure=false、Radius=1130000000,原生玻璃和背景保留;HKCU Run 直接指向安装的程序,NativeBubblesEnabled=1。没有调用 --show-now、预览、热键或锁屏,没有等 6 分钟看实屏,也没做登录、重启和远程客户端验收。
  • 北京时间10月11日13:33只读检查:安装版本0.1.39.0,常驻健康、开关打开、快捷键可用,配置为360秒、非安全退出、Windows自动屏保关闭;没有预览、改空闲时间或注入输入。
  • 真正的窗口层级、预览和快捷键的实屏效果、崩溃后无残留和退出延迟仍需对应实机验证;左边缘错位的候选修法和泡泡提速都还没实施,不从单元测试推定。
与其他模块的关系

泡泡背景优先来自VDD当前Wallpaper Engine材料的一次快照,缺失才用VDD的Windows壁纸;静态黑猫桌面/锁屏恢复是另一条独立能力,不再以固定嵌入图解释全部背景。

依据与来源
真实入口
src/EmeraldVeil.Core
空闲、输入分类、预览期限、启动失败冷却和状态协调。
src/EmeraldVeil.App/NativeBubblesLauncher.cs / VeilWindow.cs
真实进程、Job Object(作业对象)、原生窗口约定和进场底图。
src/EmeraldVeil.App/VeilController.cs / TrayIconHost.cs
50ms循环、立即启动、15秒预览与托盘控制。
docs/product-design.md
显示目标、尺寸、输入和验收边界。
如何验证
  • 9月8日37项测试通过,含原36项核心/源码约定与新增控制命令非零退出回归;这是当日记录。当前源码共定义68个测试方法(62个Fact、6个Theory),这次没有重新运行;GitHub 上最近5次自动构建都显示成功,最新一次在北京时间10月31日03:29(提交 4a4e70f),11 月 4 日没有触发新构建。
  • 北京时间11月4日只读 Set-NativeBubbles -Action Verify 通过:enabled、360秒(运行时也是360)、windows_fullscreen_trigger=false、secure=false、Radius=1130000000,原生玻璃和背景保留;HKCU Run 直接指向安装的程序,NativeBubblesEnabled=1。没有调用 --show-now、预览、热键或锁屏,没有等 6 分钟看实屏,也没做登录、重启和远程客户端验收。
  • 北京时间10月11日13:33只读检查:安装版本0.1.39.0,常驻健康、开关打开、快捷键可用,配置为360秒、非安全退出、Windows自动屏保关闭;没有预览、改空闲时间或注入输入。
  • 真正的窗口层级、预览和快捷键的实屏效果、崩溃后无残留和退出延迟仍需对应实机验证;左边缘错位的候选修法和泡泡提速都还没实施,不从单元测试推定。
与其他模块的关系

泡泡背景优先来自VDD当前Wallpaper Engine材料的一次快照,缺失才用VDD的Windows壁纸;静态黑猫桌面/锁屏恢复是另一条独立能力,不再以固定嵌入图解释全部背景。

数字截至 2026 年 11 月 6 日

复制 AI 续作说明

项目:原生泡泡、空闲触发与输入退出;仓库:wlyaaaaa/emerald-veil;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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