
Emerald Veil · 功能说明
出现干扰时能先停下来,不必先成功还原所有细节;以后不需要时能分清恢复设置、卸载程序和换回原图。
当前情况:已有安装、立即启动、停用和恢复原设置的入口,常驻程序启动和退出时会留下一条中文结果;原图、屏保参数与程序卸载仍各自处理。恢复原设置现在只认当前格式(v4)的存档,这台电脑的存档就是 v4,但恢复还没实跑过。
项目快照核对于 2026-11-04(北京时间):运行结果来自 09:07–09:17 的只读检查,源码核对到 4a4e70f;具体测试和事件保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


Emerald Veil · 功能说明
出现干扰时能先停下来,不必先成功还原所有细节;以后不需要时能分清恢复设置、卸载程序和换回原图。
当前情况:已有安装、立即启动、停用和恢复原设置的入口,常驻程序启动和退出时会留下一条中文结果;原图、屏保参数与程序卸载仍各自处理。恢复原设置现在只认当前格式(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 管策略;托盘可立即启动或预览。
- 这次是安装、启用、停用、恢复还是卸载
- 如有远程显示问题,描述设备和看到的现象


用 scripts/Install-EmeraldVeil.ps1 -Action Install/Verify/Remove 管安装,用 scripts/Set-NativeBubbles.ps1 -Action Enable/Verify/Disable/Restore 管策略;托盘可立即启动或预览。
- 这次是安装、启用、停用、恢复还是卸载
- 如有远程显示问题,描述设备和看到的现象


这里保留实现、关键条件、精确入口、历史记录和验证结果。
北京时间 11 月 4 日只读检查:安装 0.1.39.0(源码 0.1.40,没有重新构建),常驻 1 个,最近结果为启动成功(11 月 3 日 16:04)

- 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)

- 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 日

- 登录启动时若项目启用,常驻程序检查保存的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,只登记同一个程序,不新增任务、服务或第二守护。


- 登录启动时若项目启用,常驻程序检查保存的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 日




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

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



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

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


- 原状态缺失、损坏或schema(数据结构)不支持: Restore直接报错,无法替用户猜旧设置;Disable不依赖完整前像,可用于先关闭自动泡泡。
- 程序制品缺失、目标冲突或安装环境会连带杀掉子进程: 安装器在替换前停下并报出具体原因,避免覆盖不属于该安装的文件;不伪造安装完成,也不用无关的旧备份回退。
- 启用标志和Run值存在,但程序未运行: 分开报告安装、配置和运行证据,先看最近一条常驻结果里的中文原因再恢复;不能由注册表正常推定六分钟空闲功能正在工作。

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


- 原状态缺失、损坏或schema(数据结构)不支持: Restore直接报错,无法替用户猜旧设置;Disable不依赖完整前像,可用于先关闭自动泡泡。
- 程序制品缺失、目标冲突或安装环境会连带杀掉子进程: 安装器在替换前停下并报出具体原因,避免覆盖不属于该安装的文件;不伪造安装完成,也不用无关的旧备份回退。
- 启用标志和Run值存在,但程序未运行: 分开报告安装、配置和运行证据,先看最近一条常驻结果里的中文原因再恢复;不能由注册表正常推定六分钟空闲功能正在工作。

- 北京时间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值,配置脚本负责屏保参数和前像,桌面/锁屏脚本负责图片;这些路径互相不能冒充。

- 北京时间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。








