状态、立即启动、停用与原设置恢复
现在
偶尔用 · 快照核对 11 月 4 日
撤回原设置只认 v4 存档,还没实跑过
截至 11 月 4 日 · 项目源码和本机只读检查

出现干扰时能先停下来,不必先成功还原所有细节;以后不需要时能分清恢复设置、卸载程序和换回原图。

当前情况:已有安装、立即启动、停用和恢复原设置的入口,常驻程序启动和退出时会留下一条中文结果;原图、屏保参数与程序卸载仍各自处理。恢复原设置现在只认当前格式(v4)的存档,这台电脑的存档就是 v4,但恢复还没实跑过。

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

项目源码:公开仓库

状态、立即启动、停用与原设置恢复
现在
偶尔用 · 快照核对 11 月 4 日
撤回原设置只认 v4 存档,还没实跑过
截至 11 月 4 日 · 项目源码和本机只读检查

出现干扰时能先停下来,不必先成功还原所有细节;以后不需要时能分清恢复设置、卸载程序和换回原图。

当前情况:已有安装、立即启动、停用和恢复原设置的入口,常驻程序启动和退出时会留下一条中文结果;原图、屏保参数与程序卸载仍各自处理。恢复原设置现在只认当前格式(v4)的存档,这台电脑的存档就是 v4,但恢复还没实跑过。

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

项目源码:公开仓库

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

暂停不是卸载,恢复原状态也不是恢复Windows默认值。把这些动作混成“一键无损回滚”会让用户不知道到底改回了什么;原始状态必须在首次修改前保存,重复操作也不能覆盖它。

举个实际例子

“今天不要自动出泡泡,但先保留恢复办法。”用正式Disable关闭功能;需要时Enable再开启。要撤回旧屏保参数用Restore,要移除程序用Remove,静态图片仍按自己的原记录处理。

最后我会得到什么

留下清楚的原状态与操作结果;常驻程序最近一次是启动成功、正常退出还是失败,也有一条中文结果可查。泡泡不主动锁屏,因此不会要求用户为退出它再输密码;这不代替Windows锁定,也不证明每个远程客户端都已经测试。

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

暂停不是卸载,恢复原状态也不是恢复Windows默认值。把这些动作混成“一键无损回滚”会让用户不知道到底改回了什么;原始状态必须在首次修改前保存,重复操作也不能覆盖它。

举个实际例子

“今天不要自动出泡泡,但先保留恢复办法。”用正式Disable关闭功能;需要时Enable再开启。要撤回旧屏保参数用Restore,要移除程序用Remove,静态图片仍按自己的原记录处理。

最后我会得到什么

留下清楚的原状态与操作结果;常驻程序最近一次是启动成功、正常退出还是失败,也有一条中文结果可查。泡泡不主动锁屏,因此不会要求用户为退出它再输密码;这不代替Windows锁定,也不证明每个远程客户端都已经测试。

结果怎么看
正常工作

安装、启用、立即启动、停用和恢复各有对应结果;真实画面与远程兼容仍另看。

发现问题

设置与预期不符时先指出差异;程序不见了可以先看最近一条常驻结果再决定怎么恢复。即使其他参数漂移,仍可先停用自动泡泡。

暂不可用

没有首次启用前的记录,或记录不是当前格式(v4),就不能猜旧设置来恢复;安装文件缺失、目标冲突或安装命令跑在会连带杀掉子进程的环境里,也会停止。

结果怎么看
正常工作

安装、启用、立即启动、停用和恢复各有对应结果;真实画面与远程兼容仍另看。

发现问题

设置与预期不符时先指出差异;程序不见了可以先看最近一条常驻结果再决定怎么恢复。即使其他参数漂移,仍可先停用自动泡泡。

暂不可用

没有首次启用前的记录,或记录不是当前格式(v4),就不能猜旧设置来恢复;安装文件缺失、目标冲突或安装命令跑在会连带杀掉子进程的环境里,也会停止。

从哪里开始

用 scripts/Install-EmeraldVeil.ps1 -Action Install/Verify/Remove 管安装,用 scripts/Set-NativeBubbles.ps1 -Action Enable/Verify/Disable/Restore 管策略;托盘可立即启动或预览。

需要准备什么
  • 这次是安装、启用、停用、恢复还是卸载
  • 如有远程显示问题,描述设备和看到的现象
从开始到拿到结果
1先看当前状态
首次启用时留下原屏保设置;以后再启用只校验,不替换已经记下的原值;记录不是当前格式(v4)就直接报错,不再自动升级旧格式。
2分别看配置、常驻结果和真实画面
文件装好、程序在跑、最近一条常驻结果和人眼看见泡泡是不同结果,远程屏幕还需实际连接验。
3按本人目的撤回
可以只停自动泡泡、还原原屏保参数或卸载程序;原桌面与锁屏图片按另一份记录恢复。
从哪里开始

用 scripts/Install-EmeraldVeil.ps1 -Action Install/Verify/Remove 管安装,用 scripts/Set-NativeBubbles.ps1 -Action Enable/Verify/Disable/Restore 管策略;托盘可立即启动或预览。

需要准备什么
  • 这次是安装、启用、停用、恢复还是卸载
  • 如有远程显示问题,描述设备和看到的现象
从开始到拿到结果
1先看当前状态
首次启用时留下原屏保设置;以后再启用只校验,不替换已经记下的原值;记录不是当前格式(v4)就直接报错,不再自动升级旧格式。
2分别看配置、常驻结果和真实画面
文件装好、程序在跑、最近一条常驻结果和人眼看见泡泡是不同结果,远程屏幕还需实际连接验。
3按本人目的撤回
可以只停自动泡泡、还原原屏保参数或卸载程序;原桌面与锁屏图片按另一份记录恢复。
技术实现与依据(一)

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

北京时间 11 月 4 日只读检查:安装 0.1.39.0(源码 0.1.40,没有重新构建),常驻 1 个,最近结果为启动成功(11 月 3 日 16:04)

关键规则与设计选择
1
托盘查看目标、空闲与错误,立即启动或双击等同Ctrl+Win+E;preview最多15秒,真正屏保直到活动或禁用。常驻程序的生命周期另写一条最新结果文件,只记启动成功、正常退出或失败。不提供单独会话暂停和托盘退出驻留,以免留下没有Owner(拥有者)的快捷键。
2
Windows可能在登录或驱动重置后重新打开自己的屏保触发。程序启用且运行时会在启动和每30秒检查并修正运行时的六分钟、非锁屏、关闭自动触发策略,避免Windows另起一套屏保;程序退出后这项维护也停止。
3
Enable首次记录runtime(运行环境)和相关注册表值的存在性、类型和值,经临时文件整体替换落盘;重复Enable只校验,从不替换已经记下的原值;已有记录不是v4就直接报错,不再升级旧格式。
4
Disable关闭泡泡和自动触发,不还原Radius或旧超时;Restore才按前像恢复,Remove另行删除已装程序与启动项。
5
远程兼容靠不主动切换到安全桌面、输入穿透、不抢焦点;实际连接与画面仍由客户端验收,不按软件名称声称全兼容。
当前怎样实现
  • Install没给-SourcePath时先用dotnet publish把当前源码发布到artifacts/publish/win-x64/EmeraldVeil.exe(发布失败就停),显式给-SourcePath才直接读那个文件;再复制到%LOCALAPPDATA%\Programs\EmeraldVeil,再设置唯一Emerald Veil Native Bubbles Run值;源码构建目标net10.0-windows。替换前拒绝在“关闭即杀子进程”的宿主作业里运行,否则常驻程序会随安装命令结束被杀;只有本次真的替换过、原来又有文件时才允许用.previous回退,替换前失败不会拿无关的旧.previous覆盖现有安装。
  • Set-NativeBubbles保存v4前像(11个注册项),Enable和Restore都只接受v4:其他格式直接报“schema 不支持”,缺失或损坏同样报错,不猜旧设置。v1到v3的自动升级和.before-v4备份已在10月20日退役。
  • Enable配置360秒、非安全退出、Windows自动触发关闭与项目enabled,并维护原生玻璃泡泡:ShowBubbles=1、MaterialGlass=1、Radius=1130000000(都是DWORD),前两项在显示前按需修正。它核对已有Run项,不负责安装该项;先安装再启用。
技术实现与依据(一)

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

北京时间 11 月 4 日只读检查:安装 0.1.39.0(源码 0.1.40,没有重新构建),常驻 1 个,最近结果为启动成功(11 月 3 日 16:04)

关键规则与设计选择
1
托盘查看目标、空闲与错误,立即启动或双击等同Ctrl+Win+E;preview最多15秒,真正屏保直到活动或禁用。常驻程序的生命周期另写一条最新结果文件,只记启动成功、正常退出或失败。不提供单独会话暂停和托盘退出驻留,以免留下没有Owner(拥有者)的快捷键。
2
Windows可能在登录或驱动重置后重新打开自己的屏保触发。程序启用且运行时会在启动和每30秒检查并修正运行时的六分钟、非锁屏、关闭自动触发策略,避免Windows另起一套屏保;程序退出后这项维护也停止。
3
Enable首次记录runtime(运行环境)和相关注册表值的存在性、类型和值,经临时文件整体替换落盘;重复Enable只校验,从不替换已经记下的原值;已有记录不是v4就直接报错,不再升级旧格式。
4
Disable关闭泡泡和自动触发,不还原Radius或旧超时;Restore才按前像恢复,Remove另行删除已装程序与启动项。
5
远程兼容靠不主动切换到安全桌面、输入穿透、不抢焦点;实际连接与画面仍由客户端验收,不按软件名称声称全兼容。
当前怎样实现
  • Install没给-SourcePath时先用dotnet publish把当前源码发布到artifacts/publish/win-x64/EmeraldVeil.exe(发布失败就停),显式给-SourcePath才直接读那个文件;再复制到%LOCALAPPDATA%\Programs\EmeraldVeil,再设置唯一Emerald Veil Native Bubbles Run值;源码构建目标net10.0-windows。替换前拒绝在“关闭即杀子进程”的宿主作业里运行,否则常驻程序会随安装命令结束被杀;只有本次真的替换过、原来又有文件时才允许用.previous回退,替换前失败不会拿无关的旧.previous覆盖现有安装。
  • Set-NativeBubbles保存v4前像(11个注册项),Enable和Restore都只接受v4:其他格式直接报“schema 不支持”,缺失或损坏同样报错,不猜旧设置。v1到v3的自动升级和.before-v4备份已在10月20日退役。
  • Enable配置360秒、非安全退出、Windows自动触发关闭与项目enabled,并维护原生玻璃泡泡:ShowBubbles=1、MaterialGlass=1、Radius=1130000000(都是DWORD),前两项在显示前按需修正。它核对已有Run项,不负责安装该项;先安装再启用。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
1
Install默认先用.NET 10 SDK从当前源码构建单文件制品,再安装程序与直接Run项。
2
Enable先保存并验证第一次原状态(只接受v4),再配置本项目泡泡策略。
  • 登录启动时若项目启用,常驻程序检查保存的REG_SZ超时360及运行active/timeout/secure,每30秒按需修正。仅当active=false时接受运行timeout(等待超时)=0,项目自己的六分钟计时不变;Verify分别输出timeout_seconds、runtime_timeout_seconds与runtime_timeout_effective,不把运行0误报成保存设置错误。
  • Disable先清除enabled并维持active=false,再停止系统路径的原生泡泡进程,收口失败也不会把开关改回开着;Restore停止泡泡后按前像回填相关状态,缺少、损坏或不认识的格式直接报错,并在操作失败时尝试恢复本次操作前状态。
  • 不安装通用键盘记录器;输入分类只保留有限内存状态,点击穿透和不激活让普通输入继续送往当前应用。
  • 常驻结果写在 %LOCALAPPDATA%\EmeraldVeil\last-result.json(格式 emerald-veil.result.v1,字段 schema/state/result/reason_zh/observed_at/process_id),启动成功、正常退出、未处理异常时各写一条,先写临时文件再整体替换,只留最新一条,写失败不影响常驻;强制结束或断电来不及写。--status不启动缺失屏保,但发现没在运行时会补写一条失败结果再返回not-running;已捕获的显示错误在--status的presentation.lastFailure里。驻留者向Windows注册Application Restart,只登记同一个程序,不新增任务、服务或第二守护。
执行流程
技术实现与依据(二)
1
Install默认先用.NET 10 SDK从当前源码构建单文件制品,再安装程序与直接Run项。
2
Enable先保存并验证第一次原状态(只接受v4),再配置本项目泡泡策略。
  • 登录启动时若项目启用,常驻程序检查保存的REG_SZ超时360及运行active/timeout/secure,每30秒按需修正。仅当active=false时接受运行timeout(等待超时)=0,项目自己的六分钟计时不变;Verify分别输出timeout_seconds、runtime_timeout_seconds与runtime_timeout_effective,不把运行0误报成保存设置错误。
  • Disable先清除enabled并维持active=false,再停止系统路径的原生泡泡进程,收口失败也不会把开关改回开着;Restore停止泡泡后按前像回填相关状态,缺少、损坏或不认识的格式直接报错,并在操作失败时尝试恢复本次操作前状态。
  • 不安装通用键盘记录器;输入分类只保留有限内存状态,点击穿透和不激活让普通输入继续送往当前应用。
  • 常驻结果写在 %LOCALAPPDATA%\EmeraldVeil\last-result.json(格式 emerald-veil.result.v1,字段 schema/state/result/reason_zh/observed_at/process_id),启动成功、正常退出、未处理异常时各写一条,先写临时文件再整体替换,只留最新一条,写失败不影响常驻;强制结束或断电来不及写。--status不启动缺失屏保,但发现没在运行时会补写一条失败结果再返回not-running;已捕获的显示错误在--status的presentation.lastFailure里。驻留者向Windows注册Application Restart,只登记同一个程序,不新增任务、服务或第二守护。
执行流程

数字截至 2026 年 11 月 6 日

技术实现与依据(三)
3
需要时分别用配置Verify、安装Verify、进程观察、最近一条常驻结果和实际画面判断,不能相互替代。
4
停用用Disable,按首次原值撤回用Restore;需要卸载再Remove,不以删除进程代替产品状态。
5
不再需要程序时Remove;旧桌面和锁屏按另一份图片记录在Windows设置中选回。
技术实现与依据(三)
3
需要时分别用配置Verify、安装Verify、进程观察、最近一条常驻结果和实际画面判断,不能相互替代。
4
停用用Disable,按首次原值撤回用Restore;需要卸载再Remove,不以删除进程代替产品状态。
5
不再需要程序时Remove;旧桌面和锁屏按另一份图片记录在Windows设置中选回。
名词和入口
本模块用到的名词
名词意思
Preimage(变更前状态)第一次Enable前保存的相关配置;记录精确存在性、类型、值和运行时,不是整机镜像。现在只用 v4 格式,Enable 和 Restore 都只接受 v4;缺失、损坏或不支持的格式直接报错,不猜旧设置。
WinExe(无控制台应用)直接登录启动一个本用户图形程序,无需PowerShell常驻包装、服务或计划任务。
当前交互桌面用户现在操作的桌面,泡泡保持在这里;不会自行进入Windows锁屏或凭据输入桌面。
专业定义

安装、配置、应急停止和恢复原设置分别处理;远程输入按相同桌面规则工作。

解决什么

安装验证不会证明自启已经执行。过去程序为何停掉无从查起,现在常驻程序会留下最近一条中文结果,但它只说明生命周期,不是画面验收,也不会主动提醒;9 月 8 日那次停止的原因仍不清楚,这次没有做安装、启用或恢复。缺少或损坏原状态记录时,仍不能猜出第一次启用前的旧配置。

名词和入口
本模块用到的名词
名词意思
Preimage(变更前状态)
意思:
第一次Enable前保存的相关配置;记录精确存在性、类型、值和运行时,不是整机镜像。现在只用 v4 格式,Enable 和 Restore 都只接受 v4;缺失、损坏或不支持的格式直接报错,不猜旧设置。
WinExe(无控制台应用)
意思:
直接登录启动一个本用户图形程序,无需PowerShell常驻包装、服务或计划任务。
当前交互桌面
意思:
用户现在操作的桌面,泡泡保持在这里;不会自行进入Windows锁屏或凭据输入桌面。
专业定义

安装、配置、应急停止和恢复原设置分别处理;远程输入按相同桌面规则工作。

解决什么

安装验证不会证明自启已经执行。过去程序为何停掉无从查起,现在常驻程序会留下最近一条中文结果,但它只说明生命周期,不是画面验收,也不会主动提醒;9 月 8 日那次停止的原因仍不清楚,这次没有做安装、启用或恢复。缺少或损坏原状态记录时,仍不能猜出第一次启用前的旧配置。

出问题时

解决什么

安装验证不会证明自启已经执行,也不能猜出程序为何退出;9 月 8 日曾恢复过常驻与360秒配置。缺少或损坏原状态记录时,仍不能猜出第一次启用前的旧配置。

边界
  • 本用户安装不需管理员;默认Install会先从源码构建泡泡程序,所以需要.NET 10 SDK(Verify和Remove不构建),静态图片恢复不需要它。
  • 源仓库不存机器前像、个人日志或微软系统组件;卸载不意味着删除所有恢复记录。
  • 原生泡泡不是安全锁屏;需要锁定电脑时仍由用户和Windows正常处理。
失败与恢复
  • 原状态缺失、损坏或schema(数据结构)不支持: Restore直接报错,无法替用户猜旧设置;Disable不依赖完整前像,可用于先关闭自动泡泡。
  • 程序制品缺失、目标冲突或安装环境会连带杀掉子进程: 安装器在替换前停下并报出具体原因,避免覆盖不属于该安装的文件;不伪造安装完成,也不用无关的旧备份回退。
  • 启用标志和Run值存在,但程序未运行: 分开报告安装、配置和运行证据,先看最近一条常驻结果里的中文原因再恢复;不能由注册表正常推定六分钟空闲功能正在工作。
出问题时

解决什么

安装验证不会证明自启已经执行,也不能猜出程序为何退出;9 月 8 日曾恢复过常驻与360秒配置。缺少或损坏原状态记录时,仍不能猜出第一次启用前的旧配置。

边界
  • 本用户安装不需管理员;默认Install会先从源码构建泡泡程序,所以需要.NET 10 SDK(Verify和Remove不构建),静态图片恢复不需要它。
  • 源仓库不存机器前像、个人日志或微软系统组件;卸载不意味着删除所有恢复记录。
  • 原生泡泡不是安全锁屏;需要锁定电脑时仍由用户和Windows正常处理。
失败与恢复
  • 原状态缺失、损坏或schema(数据结构)不支持: Restore直接报错,无法替用户猜旧设置;Disable不依赖完整前像,可用于先关闭自动泡泡。
  • 程序制品缺失、目标冲突或安装环境会连带杀掉子进程: 安装器在替换前停下并报出具体原因,避免覆盖不属于该安装的文件;不伪造安装完成,也不用无关的旧备份回退。
  • 启用标志和Run值存在,但程序未运行: 分开报告安装、配置和运行证据,先看最近一条常驻结果里的中文原因再恢复;不能由注册表正常推定六分钟空闲功能正在工作。
依据与来源
真实入口
scripts/Install-EmeraldVeil.ps1
Install / Verify / Remove、实际制品路径和替换回退条件。
scripts/Set-NativeBubbles.ps1
Enable / Verify / Disable / Restore及v4前像(只接受v4)。
src/EmeraldVeil.App/App.xaml.cs / ResidentResult.cs / NativeBubblesSettings.cs / TrayIconHost.cs
登录策略修正、常驻结果文件、托盘控制和30秒运行时维护。
docs/product-design.md
原状态、远程输入、实机验收边界。
如何验证
  • 北京时间10月11日13:33只读安装检查:版本0.1.39.0,常驻健康、开关打开、快捷键可用,唯一交互常驻;配置为360秒、非安全退出、Windows自动触发关闭。13:36:45读到的最近常驻结果是“屏保常驻程序已启动”(启动成功),记录时间为北京时间10月10日11:11:45,进程号62712。版本、注册表、进程和真实画面仍分开看,源码与安装程序是否完全一致没有证实。
  • 北京时间11月4日只读:last-result.json 为 state=success、result=resident_success、“屏保常驻程序已启动”,记录时间11月3日16:04:44;同用户常驻进程1个;原设置文件 schema=emerald-veil.native-bubbles-preimage.v4、11个registry_values,只读格式和数量,没读原值。安装程序 0.1.39.0,源码 0.1.40,没有重新构建。Restore没有实跑,存档符合v4不等于恢复一定成功。
  • 北京时间10月11日13:33只读安装检查:- 9月8日曾把注册表超时从600修正为360、重新启动常驻程序,首次前像哈希未改变;当时核对的是0.1.27,相关文件大小、哈希和编译标识只属于那次历史。
  • 这次没有执行安装、Enable、Disable、Restore、Remove、锁屏或真实远端验证;最近一条“启动成功”不能当成画面验收,也不说明以后不会退出。
与其他模块的关系

安装器负责程序和Run值,配置脚本负责屏保参数和前像,桌面/锁屏脚本负责图片;这些路径互相不能冒充。

依据与来源
真实入口
scripts/Install-EmeraldVeil.ps1
Install / Verify / Remove、实际制品路径和替换回退条件。
scripts/Set-NativeBubbles.ps1
Enable / Verify / Disable / Restore及v4前像(只接受v4)。
src/EmeraldVeil.App/App.xaml.cs / ResidentResult.cs / NativeBubblesSettings.cs / TrayIconHost.cs
登录策略修正、常驻结果文件、托盘控制和30秒运行时维护。
docs/product-design.md
原状态、远程输入、实机验收边界。
如何验证
  • 北京时间10月11日13:33只读安装检查:版本0.1.39.0,常驻健康、开关打开、快捷键可用,唯一交互常驻;配置为360秒、非安全退出、Windows自动触发关闭。13:36:45读到的最近常驻结果是“屏保常驻程序已启动”(启动成功),记录时间为北京时间10月10日11:11:45,进程号62712。版本、注册表、进程和真实画面仍分开看,源码与安装程序是否完全一致没有证实。
  • 北京时间11月4日只读:last-result.json 为 state=success、result=resident_success、“屏保常驻程序已启动”,记录时间11月3日16:04:44;同用户常驻进程1个;原设置文件 schema=emerald-veil.native-bubbles-preimage.v4、11个registry_values,只读格式和数量,没读原值。安装程序 0.1.39.0,源码 0.1.40,没有重新构建。Restore没有实跑,存档符合v4不等于恢复一定成功。
  • 北京时间10月11日13:33只读安装检查:- 9月8日曾把注册表超时从600修正为360、重新启动常驻程序,首次前像哈希未改变;当时核对的是0.1.27,相关文件大小、哈希和编译标识只属于那次历史。
  • 这次没有执行安装、Enable、Disable、Restore、Remove、锁屏或真实远端验证;最近一条“启动成功”不能当成画面验收,也不说明以后不会退出。
与其他模块的关系

安装器负责程序和Run值,配置脚本负责屏保参数和前像,桌面/锁屏脚本负责图片;这些路径互相不能冒充。

复制 AI 续作说明

项目:状态、立即启动、停用与原设置恢复;仓库:wlyaaaaa/emerald-veil;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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