桌面与锁屏图片恢复
现在
偶尔用 · 快照核对 11 月 4 日
11 月 4 日检查有偏差:图对,文件位置不合规定,未修
截至 11 月 4 日 · 壁纸只读检查和项目源码

图片和恢复入口放在一起,新电脑不必重新找图、猜颜色参数或依赖原来的用户名与盘符。

当前情况:北京时间 11 月 4 日 11:13 的只读检查读完了桌面和锁屏,结果是“有偏差”:桌面两块屏用的还是这张图(内容完全相同),但文件还在旧位置,不在现在规定的持久位置;锁屏用的是另一份文件,解码后画面误差为 0,同样不算合规。这次没有修。锁屏实际裁剪、显示效果与新电脑恢复仍需对应画面确认。

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

项目源码:公开仓库

桌面与锁屏图片恢复
现在
偶尔用 · 快照核对 11 月 4 日
11 月 4 日检查有偏差:图对,文件位置不合规定,未修
截至 11 月 4 日 · 壁纸只读检查和项目源码

图片和恢复入口放在一起,新电脑不必重新找图、猜颜色参数或依赖原来的用户名与盘符。

当前情况:北京时间 11 月 4 日 11:13 的只读检查读完了桌面和锁屏,结果是“有偏差”:桌面两块屏用的还是这张图(内容完全相同),但文件还在旧位置,不在现在规定的持久位置;锁屏用的是另一份文件,解码后画面误差为 0,同样不算合规。这次没有修。锁屏实际裁剪、显示效果与新电脑恢复仍需对应画面确认。

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

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

只把图片路径指向开发或临时目录,后续搬家容易失效;桌面和锁屏又是两处独立设置。脚本保存已选图、明确分别设置与核对结果,避免看到一处正确就以为两处都好了。

举个实际例子

“把已选好的图设为这台电脑的桌面和锁屏背景,保留现在的设置方便恢复。”工具先保存原设置,处理本人选定的目标,再核对 Windows 是否接受;最后还要看实际桌面和锁屏的裁剪效果,不能只凭设置写入成功就说画面已经合适。

最后我会得到什么

分别告诉你桌面和锁屏是否已使用选定图片,哪一处仍有差异或报错。原设置记录保留,必要时可恢复;实际锁屏的裁剪与观感仍要打开画面检查。

这项功能怎样使用

用途与实际影响

为什么需要它

只把图片路径指向开发或临时目录,后续搬家容易失效;桌面和锁屏又是两处独立设置。脚本保存已选图、明确分别设置与核对结果,避免看到一处正确就以为两处都好了。

举个实际例子

“把已选好的图设为这台电脑的桌面和锁屏背景,保留现在的设置方便恢复。”工具先保存原设置,处理本人选定的目标,再核对 Windows 是否接受;最后还要看实际桌面和锁屏的裁剪效果,不能只凭设置写入成功就说画面已经合适。

最后我会得到什么

分别告诉你桌面和锁屏是否已使用选定图片,哪一处仍有差异或报错。原设置记录保留,必要时可恢复;实际锁屏的裁剪与观感仍要打开画面检查。

结果怎么看
正常工作

各屏幕和锁屏都已引用正确图片时,重复操作不会再改一次。

发现问题

Windows个性化设置或其他软件改变了图片、显示模式时,检查会指出差异;本人选择恢复后再重新设置。

暂不可用

图片缺失、内容不符或Windows接口不可用时保留错误与原设置,不生成替代图,也不锁定电脑。

结果怎么看
正常工作

各屏幕和锁屏都已引用正确图片时,重复操作不会再改一次。

发现问题

Windows个性化设置或其他软件改变了图片、显示模式时,检查会指出差异;本人选择恢复后再重新设置。

暂不可用

图片缺失、内容不符或Windows接口不可用时保留错误与原设置,不生成替代图,也不锁定电脑。

从哪里开始

先按选图清单确认图片,运行 scripts/Set-WindowsBackground.ps1 -Action Verify 查看现状;要应用时显式使用 -Action Apply。

需要准备什么
  • 想使用项目里的哪张图片
  • 只检查还是应用到桌面或锁屏
  • 需要时是否恢复原图
从开始到拿到结果
1先确认选定图片和现状
工具核对图片有没有变化,并分别查看当前桌面与锁屏;只检查时不改设置。
2明确应用才修改
先留下原设置,再把图片放在持久位置,只更新有差异的桌面或锁屏。
3回看两处画面
分别核对结果;想换回原图时按保存记录在 Windows 设置中选择。
从哪里开始

先按选图清单确认图片,运行 scripts/Set-WindowsBackground.ps1 -Action Verify 查看现状;要应用时显式使用 -Action Apply。

需要准备什么
  • 想使用项目里的哪张图片
  • 只检查还是应用到桌面或锁屏
  • 需要时是否恢复原图
从开始到拿到结果
1先确认选定图片和现状
工具核对图片有没有变化,并分别查看当前桌面与锁屏;只检查时不改设置。
2明确应用才修改
先留下原设置,再把图片放在持久位置,只更新有差异的桌面或锁屏。
3回看两处画面
分别核对结果;想换回原图时按保存记录在 Windows 设置中选择。
技术实现与依据(一)

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

11 月 4 日读回完成:status=drift、退出 1;10 月 11 日那次读回未完成(接口报错)

关键规则与设计选择
1
只恢复图片无需安装泡泡或.NET SDK,64位Windows自带PowerShell即可。
2
恢复新机器使用项目原图;原电脑的before-first-apply记录只用于撤回原电脑,不是新机器的设置来源。
3
脚本不会在后台争抢。以后主动打开Wallpaper Engine的覆盖系统壁纸/锁屏选项可能再改原生图片,需要时按需重跑。
当前怎样实现
  • 读取assets/windows-background.json核对PNG的SHA-256;PowerShell 7或32位宿主转到64位Windows PowerShell,使用系统现成WinRT投影。
  • 桌面统一通过IDesktopWallpaper设置和读取共同底图,清除每屏旧图并核对当前及Windows记忆中的离线显示器;逐屏设置后再次设共同路径,避免单屏覆盖清空共同引用。不再把冗余SystemParametersInfoW设置作为前置条件。desktop.monitors逐项报告连接状态、图片引用与matches;锁屏使用Windows.System.UserProfile.LockScreen.SetImageFileAsync。它不更改显示器连接、编号或排列。
  • 三个每用户选择器BackgroundType、RotatingLockScreenEnabled、SlideshowEnabled都明确设为DWORD 0,以采用固定图片。
  • 首次应用前保存原桌面图(可读取时)、每屏选图、原锁屏图与选择器状态;已有记录仅补入尚未采集的每屏设置,不覆盖原恢复信息。临时写入再移动前像文件,图片引用必须在持久目录且源哈希匹配。
  • 锁屏图像检查宽高比(允许相差0.01)后缩为128×72比较RGB均值,容差为3;9 月记录的实际平均误差为0,10 月 11 日没有取得完整读回;11 月 4 日解码误差为0,但图片不在持久副本位置,所以lockScreen.matches仍是false。只有确有漂移才用带哈希前缀和新GUID的文件名重设,避开缓存旧图。
技术实现与依据(一)

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

11 月 4 日读回完成:status=drift、退出 1;10 月 11 日那次读回未完成(接口报错)

关键规则与设计选择
1
只恢复图片无需安装泡泡或.NET SDK,64位Windows自带PowerShell即可。
2
恢复新机器使用项目原图;原电脑的before-first-apply记录只用于撤回原电脑,不是新机器的设置来源。
3
脚本不会在后台争抢。以后主动打开Wallpaper Engine的覆盖系统壁纸/锁屏选项可能再改原生图片,需要时按需重跑。
当前怎样实现
  • 读取assets/windows-background.json核对PNG的SHA-256;PowerShell 7或32位宿主转到64位Windows PowerShell,使用系统现成WinRT投影。
  • 桌面统一通过IDesktopWallpaper设置和读取共同底图,清除每屏旧图并核对当前及Windows记忆中的离线显示器;逐屏设置后再次设共同路径,避免单屏覆盖清空共同引用。不再把冗余SystemParametersInfoW设置作为前置条件。desktop.monitors逐项报告连接状态、图片引用与matches;锁屏使用Windows.System.UserProfile.LockScreen.SetImageFileAsync。它不更改显示器连接、编号或排列。
  • 三个每用户选择器BackgroundType、RotatingLockScreenEnabled、SlideshowEnabled都明确设为DWORD 0,以采用固定图片。
  • 首次应用前保存原桌面图(可读取时)、每屏选图、原锁屏图与选择器状态;已有记录仅补入尚未采集的每屏设置,不覆盖原恢复信息。临时写入再移动前像文件,图片引用必须在持久目录且源哈希匹配。
  • 锁屏图像检查宽高比(允许相差0.01)后缩为128×72比较RGB均值,容差为3;9 月记录的实际平均误差为0,10 月 11 日没有取得完整读回;11 月 4 日解码误差为0,但图片不在持久副本位置,所以lockScreen.matches仍是false。只有确有漂移才用带哈希前缀和新GUID的文件名重设,避开缓存旧图。
技术实现与依据(二)
执行流程
1
读取选图与清单,先验证原图哈希。
2
读取两处图片、固定模式及锁屏解码画面。
3
Apply(应用图片)且有漂移时保存原始记录,补正确模式,复制并校验新持久副本。
4
分别修改需要变化的桌面或锁屏,再完整回读;Verify只执行读取。
5
打印结果和changedSurfaces;不符合返回1,系统错误直接报告。
技术实现与依据(二)
执行流程
1
读取选图与清单,先验证原图哈希。
2
读取两处图片、固定模式及锁屏解码画面。
3
Apply(应用图片)且有漂移时保存原始记录,补正确模式,复制并校验新持久副本。
4
分别修改需要变化的桌面或锁屏,再完整回读;Verify只执行读取。
5
打印结果和changedSurfaces;不符合返回1,系统错误直接报告。
名词和入口
本模块用到的名词
名词意思
雨林黑猫 · 更绿版已选用的3840×2160电脑底图,由1672×941生成原图放大;是sRGB SDR,不宣称恢复了未知细节、HDR或10位输出。
持久图片副本Windows显示文件复制到用户图片目录的EmeraldVeil子目录;前像与原图备份仍在%LOCALAPPDATA%\EmeraldVeil\windows-background。Windows引用持久图片而非项目目录。本机是E:\Pictures\EmeraldVeil,但 11 月 4 日的桌面引用还在%LOCALAPPDATA%旧位置,没满足这条。
解码后比较Windows可能重新编码锁屏缓存,脚本比较画面而非只比缓存文件字节,避免编码变化被误判为换图。
专业定义

恢复雨林黑猫4K底图,各显示器和锁屏逐项核对,并保留原有图片记录;仓库另外逐字节存着一份手机壁纸,换手机时直接取回。

解决什么

接口设置可能只成功一部分;脚本不是桌面与锁屏的原子事务。出现系统错误应按具体失败位置核对,保留已保存的原图记录后再处理。10 月 11 日那次只读检查就停在读取各屏图片这一步,分不清是脚本问题还是当时的显示环境;11 月 4 日再查已能完整读完,结果是位置不合规定,不是接口报错。

名词和入口
本模块用到的名词
名词意思
雨林黑猫 · 更绿版
意思:
已选用的3840×2160电脑底图,由1672×941生成原图放大;是sRGB SDR,不宣称恢复了未知细节、HDR或10位输出。
持久图片副本
意思:
Windows显示文件复制到用户图片目录的EmeraldVeil子目录;前像与原图备份仍在%LOCALAPPDATA%\EmeraldVeil\windows-background。Windows引用持久图片而非项目目录。本机是E:\Pictures\EmeraldVeil,但 11 月 4 日的桌面引用还在%LOCALAPPDATA%旧位置,没满足这条。
解码后比较
意思:
Windows可能重新编码锁屏缓存,脚本比较画面而非只比缓存文件字节,避免编码变化被误判为换图。
专业定义

恢复雨林黑猫4K底图,各显示器和锁屏逐项核对,并保留原有图片记录;仓库另外逐字节存着一份手机壁纸,换手机时直接取回。

解决什么

接口设置可能只成功一部分;脚本不是桌面与锁屏的原子事务。出现系统错误应按具体失败位置核对,保留已保存的原图记录后再处理。10 月 11 日那次只读检查就停在读取各屏图片这一步,分不清是脚本问题还是当时的显示环境;11 月 4 日再查已能完整读完,结果是位置不合规定,不是接口报错。

出问题时

解决什么

接口设置可能只成功一部分;脚本不是桌面与锁屏的原子事务。出现系统错误应按具体失败位置核对,保留已保存的原图记录后再处理。

边界
  • 仅需保留脚本、选图清单、PNG三个文件即可进行静态恢复;不依赖原机路径或Wallpaper Engine。
  • 不更改Wallpaper Engine,不启停泡泡,不锁定电脑,也不增加自启、服务或任务。
  • 原状态记录不是自动Restore命令;原壁纸与锁屏通过Windows设置按记录选回。
失败与恢复
  • 图像、固定模式或持久引用发生漂移: Verify返回drift/1,不自动改图;Apply(应用图片)会按需要重设对应表面。
  • 锁屏缓存只是重新编码: 通过解码画面容差比较判断,不因为缓存字节不同直接判失败。
  • 磁盘写入或系统API失败: 报出实际错误;已成功的选择器或桌面修改可能保留,不能称整次自动回滚。原图记录仍用于核对和手动恢复。
出问题时

解决什么

接口设置可能只成功一部分;脚本不是桌面与锁屏的原子事务。出现系统错误应按具体失败位置核对,保留已保存的原图记录后再处理。

边界
  • 仅需保留脚本、选图清单、PNG三个文件即可进行静态恢复;不依赖原机路径或Wallpaper Engine。
  • 不更改Wallpaper Engine,不启停泡泡,不锁定电脑,也不增加自启、服务或任务。
  • 原状态记录不是自动Restore命令;原壁纸与锁屏通过Windows设置按记录选回。
失败与恢复
  • 图像、固定模式或持久引用发生漂移: Verify返回drift/1,不自动改图;Apply(应用图片)会按需要重设对应表面。
  • 锁屏缓存只是重新编码: 通过解码画面容差比较判断,不因为缓存字节不同直接判失败。
  • 磁盘写入或系统API失败: 报出实际错误;已成功的选择器或桌面修改可能保留,不能称整次自动回滚。原图记录仍用于核对和手动恢复。
依据与来源
真实入口
  • docs/windows-background.md恢复、换机、原图和现有应用边界。
  • scripts/Set-WindowsBackground.ps1真实设置与只读回读实现。
  • assets/windows-background.json / assets/verdant-rain-4k.png选图、参数与完整静帧。
如何验证
  • 北京时间11月4日09:11只读 pwsh -NoProfile -File scripts\Set-WindowsBackground.ps1 -Action Verify:读完,status=drift、退出1、changedSurfaces=[]。desktop.matches=false,两块已连接屏逐屏matches=false,都指向 %LOCALAPPDATA%\EmeraldVeil\windows-background\rain-fa8d1fdc7799-6a249f39ddcd4d5ba0c4f457c29b27d9.png,文件存在、SHA-256与选定图相同,只是不在持久副本位置。锁屏指向 %APPDATA%\Microsoft\Windows\Themes\WallpaperEngineLockOverride_randomQSIADA.jpg,lockScreen.matches=false、解码误差0。BackgroundType、RotatingLockScreenEnabled、SlideshowEnabled都是0。不能写成图片坏了或不是这张图,也不能推断锁屏显示错了;真实锁屏没有看。这次没有Apply,为什么还用旧位置说不清。
  • 北京时间10月11日13:32–13:33的只读Verify在读取各屏图片(MonitorPaths)时返回COM E_FAIL(Windows接口报错),没有拿到完整的桌面和锁屏结果,当时状态未确认。9 月那版页面记录的Verify为verified、desktop/lockScreen均true、锁屏平均像素差0,只代表当时。
  • 图片文件本身按源码主线 861a2d2 里的受管文件核对:电脑底图PNG 3840×2160、17,141,593字节、SHA-256 FA8D1FDC7799D537864D2784B5718E8BA15B77775D246C019179084B0F0239E7;手机壁纸备份 assets/mobile-wallpaper/emerald-elf-1440x3200.png 为1440×3200 sRGB PNG、12,114,553字节、SHA-256 F87BDB1CFF2F8885FC80EF02A0EDFF0EFF2C18E76A63AF63EDCA1E1D60C42EED,按约定不转格式、不重新编码。文件对得上不代表屏幕上正在用它,手机上现在用的是哪张也没有核对。
  • 跨机操作与真实锁屏目视需分别做,到 11 月 4 日都没有重做;不能用接口结果推定观感完全一致。
与其他模块的关系

只管理Windows原生静态图片。Wallpaper Engine可继续显示自己的动画,泡泡专属背景不从此入口加载。

依据与来源
真实入口
  • docs/windows-background.md恢复、换机、原图和现有应用边界。
  • scripts/Set-WindowsBackground.ps1真实设置与只读回读实现。
  • assets/windows-background.json / assets/verdant-rain-4k.png选图、参数与完整静帧。
如何验证
  • 北京时间11月4日09:11只读 pwsh -NoProfile -File scripts\Set-WindowsBackground.ps1 -Action Verify:读完,status=drift、退出1、changedSurfaces=[]。desktop.matches=false,两块已连接屏逐屏matches=false,都指向 %LOCALAPPDATA%\EmeraldVeil\windows-background\rain-fa8d1fdc7799-6a249f39ddcd4d5ba0c4f457c29b27d9.png,文件存在、SHA-256与选定图相同,只是不在持久副本位置。锁屏指向 %APPDATA%\Microsoft\Windows\Themes\WallpaperEngineLockOverride_randomQSIADA.jpg,lockScreen.matches=false、解码误差0。BackgroundType、RotatingLockScreenEnabled、SlideshowEnabled都是0。不能写成图片坏了或不是这张图,也不能推断锁屏显示错了;真实锁屏没有看。这次没有Apply,为什么还用旧位置说不清。
  • 北京时间10月11日13:32–13:33的只读Verify在读取各屏图片(MonitorPaths)时返回COM E_FAIL(Windows接口报错),没有拿到完整的桌面和锁屏结果,当时状态未确认。9 月那版页面记录的Verify为verified、desktop/lockScreen均true、锁屏平均像素差0,只代表当时。
  • 图片文件本身按源码主线 861a2d2 里的受管文件核对:电脑底图PNG 3840×2160、17,141,593字节、SHA-256 FA8D1FDC7799D537864D2784B5718E8BA15B77775D246C019179084B0F0239E7;手机壁纸备份 assets/mobile-wallpaper/emerald-elf-1440x3200.png 为1440×3200 sRGB PNG、12,114,553字节、SHA-256 F87BDB1CFF2F8885FC80EF02A0EDFF0EFF2C18E76A63AF63EDCA1E1D60C42EED,按约定不转格式、不重新编码。文件对得上不代表屏幕上正在用它,手机上现在用的是哪张也没有核对。
  • 跨机操作与真实锁屏目视需分别做,到 11 月 4 日都没有重做;不能用接口结果推定观感完全一致。
与其他模块的关系

只管理Windows原生静态图片。Wallpaper Engine可继续显示自己的动画,泡泡专属背景不从此入口加载。

数字截至 2026 年 11 月 6 日

复制 AI 续作说明

项目:桌面与锁屏图片恢复;仓库:wlyaaaaa/emerald-veil;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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