

DevConfig Backup · 功能说明
真正出事时,包旁边的回执与清单就能帮助检查,不必再找丢失电脑里的 state。先预览恢复计划,再解到空目录或明确替换并留回滚点,随后按 PCConfig 重建机器路径和任务;状态窗口能看过程,但关闭窗口不算取消实际备份。
当前情况:四个自动任务都启用;11 月 6 日 13:51 读到配置存 G、配置上云、微信存 G、微信上云最近一次都完成、都退出 0(配置存 G 那次有 1 个被占用的锁文件没收进去;11 月 4 日微信上云最终核对失败已是历史)。配置包在独立目录还原并逐文件核对已有 9 月 18 日验收;恢复的是清单实际收录的文件,包里登记了警告的文件不会自动从旧包补回。完整新机、软件登录、带警告的微信副本恢复和微信实际使用仍未验收。
项目快照核对于 2026-11-06 13:51(北京时间);具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

DevConfig Backup · 功能说明
真正出事时,包旁边的回执与清单就能帮助检查,不必再找丢失电脑里的 state。先预览恢复计划,再解到空目录或明确替换并留回滚点,随后按 PCConfig 重建机器路径和任务;状态窗口能看过程,但关闭窗口不算取消实际备份。
当前情况:四个自动任务都启用;11 月 6 日 13:51 读到配置存 G、配置上云、微信存 G、微信上云最近一次都完成、都退出 0(配置存 G 那次有 1 个被占用的锁文件没收进去;11 月 4 日微信上云最终核对失败已是历史)。配置包在独立目录还原并逐文件核对已有 9 月 18 日验收;恢复的是清单实际收录的文件,包里登记了警告的文件不会自动从旧包补回。完整新机、软件登录、带警告的微信副本恢复和微信实际使用仍未验收。
项目快照核对于 2026-11-06 13:51(北京时间);具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


用途与实际影响
新装机最容易乱的是恢复顺序,以及旧配置仍指向原机器的位置。新用户名、Documents 目录或盘符不同本身不是故障,直接照搬旧绝对路径才会让软件读错位置;微信覆盖非空目标还可能冲掉新数据。
比如我换到一台干净电脑:AI 先按清单补软件,并和 PCConfig 核对新机实际用户、Documents 与应用目录,再把兼容配置映射过去并检查是否加载。只有我选择沿用原布局才恢复 E 盘指向;微信仍先预检、保留目标,实际登录后验收,旧任务逐项重建。
得到一份先检查、再选择、最后逐应用试用的换机恢复计划。包能解开只证明清单里的文件在:比如 10 月 10 日这一代有 1 个文件只记了警告,它不在承诺范围里,要的话得自己去旧包找。也不代表新机登录、微信历史和自动任务都已恢复。

用途与实际影响
新装机最容易乱的是恢复顺序,以及旧配置仍指向原机器的位置。新用户名、Documents 目录或盘符不同本身不是故障,直接照搬旧绝对路径才会让软件读错位置;微信覆盖非空目标还可能冲掉新数据。
比如我换到一台干净电脑:AI 先按清单补软件,并和 PCConfig 核对新机实际用户、Documents 与应用目录,再把兼容配置映射过去并检查是否加载。只有我选择沿用原布局才恢复 E 盘指向;微信仍先预检、保留目标,实际登录后验收,旧任务逐项重建。
得到一份先检查、再选择、最后逐应用试用的换机恢复计划。包能解开只证明清单里的文件在:比如 10 月 10 日这一代有 1 个文件只记了警告,它不在承诺范围里,要的话得自己去旧包找。也不代表新机登录、微信历史和自动任务都已恢复。

选中配置包先按同代回执和清单核对,再恢复到独立目录;应用与自动任务实际可用另行确认。
旧路径指向不存在的用户或目录时按新电脑实际位置调整;微信目标有文件先保留可回退副本;包里有警告文件时先看清范围,再决定是否另选旧一代。
清单缺失、文件损坏、来源与目标重叠或微信仍在运行时停止写入,不暗中换包、拼包或覆盖。

选中配置包先按同代回执和清单核对,再恢复到独立目录;应用与自动任务实际可用另行确认。
旧路径指向不存在的用户或目录时按新电脑实际位置调整;微信目标有文件先保留可回退副本;包里有警告文件时先看清范围,再决定是否另选旧一代。
清单缺失、文件损坏、来源与目标重叠或微信仍在运行时停止写入,不暗中换包、拼包或覆盖。

在已接入的 AI 对话中说“先预检这份 DevConfig 包恢复到新电脑”;微信恢复须另外指明原件和目标。
- 完整日期包及附属清单
- 新机用户名和应用目录
- 目标已有文件及想恢复的范围


在已接入的 AI 对话中说“先预检这份 DevConfig 包恢复到新电脑”;微信恢复须另外指明原件和目标。
- 完整日期包及附属清单
- 新机用户名和应用目录
- 目标已有文件及想恢复的范围


这里保留实现、关键条件、精确入口、历史记录和验证结果。
配置包隔离解包全树哈希已由 9 月 18 日来源验收;默认预检与任务恢复边界已实现,恢复器不自动补警告文件;完整新机和微信应用仍未验收

- Restore-DevConfig 默认 Plan,读取 package-receipt.v2、payload-manifest.v1,自己计算包的 SHA-256,并核对内部路径和 manifest(清单);它不单独读随包的 .sha256 文件,那份留给人用外部工具核对。Execute 先解到独立 incoming 并对所选文件全树核对,才保留旧目标并切换;结果不自动列出警告文件,也不从旧包合并。Restore-WeChat 另有客户端与原生目录约束,DriveOnly 仍需真实联网恢复验收。
- 路径检查拒绝盘符根目录、source/target 相同或互为父子目录,以及任一路径或父级上的 reparse point(重解析点)。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
配置包隔离解包全树哈希已由 9 月 18 日来源验收;默认预检与任务恢复边界已实现,恢复器不自动补警告文件;完整新机和微信应用仍未验收

- Restore-DevConfig 默认 Plan,读取 package-receipt.v2、payload-manifest.v1,自己计算包的 SHA-256,并核对内部路径和 manifest(清单);它不单独读随包的 .sha256 文件,那份留给人用外部工具核对。Execute 先解到独立 incoming 并对所选文件全树核对,才保留旧目标并切换;结果不自动列出警告文件,也不从旧包合并。Restore-WeChat 另有客户端与原生目录约束,DriveOnly 仍需真实联网恢复验收。
- 路径检查拒绝盘符根目录、source/target 相同或互为父子目录,以及任一路径或父级上的 reparse point(重解析点)。

- Setup-ScheduledTasks.ps1 与 ScheduledTask-Registration.Common.ps1 支持只收敛选定的已登记任务(-TaskName),保留既有时序和设置;微信 Hot 使用当前交互用户 Highest,其余 Limited。临时小时监控仍由独立安装器管理,这次没有重装任何任务。
- 现场任务(11 月 6 日 13:51 回读,北京时间):DevConfigBackup-Local 每天 12:05 加登录后 20 分钟,最近 11 月 6 日 12:05:01 开始,12:16 结束、退出 0;DevConfigBackup-Drive-Daily 每天 13:00 有网才启动,最近 11 月 6 日 13:00:01 退出 0;WeChatBackup-Hot-Daily 每天 09:30,最近 11 月 6 日 09:30:01 退出 0;WeChatBackup-Drive-Weekly 名字是旧的,实际每天 11:00 有网才启动,最近 11 月 6 日 11:00:01 启动,12:11 完成、退出 0(11 月 4 日那次 12:11:44 最终核对失败、退出 1,是历史);WeChatDrive-Monitor-Hourly 仍停用,它显示的下次时间不会真的执行。
- 四个任务的设置里 RestartCount 仍是 3(配置本地间隔 10 分钟、配置云端 15 分钟、微信 G 盘 15 分钟、微信云端 30 分钟),但现行约定不把它当业务失败的补跑承诺,业务失败由下一次定时运行自然重跑(docs/recovery.md)。
- 配置的两个隐藏任务在同一把输出锁上排队:Local/Hot 最多等 3,600 秒,Drive 最多等 7,200 秒,拿到锁才重新采集或重读当前包,等满报 backup_resource_wait_timeout;手动入口默认等 0 秒,忙就退出。
- 源码默认钟点现在和现场一致:Setup-ScheduledTasks.ps1 不传参数时按北京 12:05、13:00、09:30、11:00 换算成本机钟点(2a01969,11 月 5 日 02:17);显式传参数仍表示本机钟点。11 月 6 日 05:15 只读回读四项 StartBoundary,也对应这四个北京钟点。这次没有重新注册任务,所以用新安装器重装还没验过;重装后要逐项回读。
- 注册器先拒绝别人的同名任务,保存精确 XML、动作与启停前像;任何更新或回读失败按原定义恢复,用户原来暂停的任务不能被重新启用。
- Hidden VBS 启动脚本(Backup-DevConfig-Hidden.vbs 等)隐藏黑框并完整保留并透传退出码。
- 恢复测试分别验证包哈希/清单、危险路径、替换前像、逐文件内容与应用验收状态;源码回归、9 月 18 日隔离恢复和网页只读状态三个证据层互不替代。


- Setup-ScheduledTasks.ps1 与 ScheduledTask-Registration.Common.ps1 支持只收敛选定的已登记任务(-TaskName),保留既有时序和设置;微信 Hot 使用当前交互用户 Highest,其余 Limited。临时小时监控仍由独立安装器管理,这次没有重装任何任务。
- 现场任务(11 月 6 日 13:51 回读,北京时间):DevConfigBackup-Local 每天 12:05 加登录后 20 分钟,最近 11 月 6 日 12:05:01 开始,12:16 结束、退出 0;DevConfigBackup-Drive-Daily 每天 13:00 有网才启动,最近 11 月 6 日 13:00:01 退出 0;WeChatBackup-Hot-Daily 每天 09:30,最近 11 月 6 日 09:30:01 退出 0;WeChatBackup-Drive-Weekly 名字是旧的,实际每天 11:00 有网才启动,最近 11 月 6 日 11:00:01 启动,12:11 完成、退出 0(11 月 4 日那次 12:11:44 最终核对失败、退出 1,是历史);WeChatDrive-Monitor-Hourly 仍停用,它显示的下次时间不会真的执行。
- 四个任务的设置里 RestartCount 仍是 3(配置本地间隔 10 分钟、配置云端 15 分钟、微信 G 盘 15 分钟、微信云端 30 分钟),但现行约定不把它当业务失败的补跑承诺,业务失败由下一次定时运行自然重跑(docs/recovery.md)。
- 配置的两个隐藏任务在同一把输出锁上排队:Local/Hot 最多等 3,600 秒,Drive 最多等 7,200 秒,拿到锁才重新采集或重读当前包,等满报 backup_resource_wait_timeout;手动入口默认等 0 秒,忙就退出。
- 源码默认钟点现在和现场一致:Setup-ScheduledTasks.ps1 不传参数时按北京 12:05、13:00、09:30、11:00 换算成本机钟点(2a01969,11 月 5 日 02:17);显式传参数仍表示本机钟点。11 月 6 日 05:15 只读回读四项 StartBoundary,也对应这四个北京钟点。这次没有重新注册任务,所以用新安装器重装还没验过;重装后要逐项回读。
- 注册器先拒绝别人的同名任务,保存精确 XML、动作与启停前像;任何更新或回读失败按原定义恢复,用户原来暂停的任务不能被重新启用。
- Hidden VBS 启动脚本(Backup-DevConfig-Hidden.vbs 等)隐藏黑框并完整保留并透传退出码。
- 恢复测试分别验证包哈希/清单、危险路径、替换前像、逐文件内容与应用验收状态;源码回归、9 月 18 日隔离恢复和网页只读状态三个证据层互不替代。





| 名词 | 意思 |
|---|---|
| Idempotent Task Registration(幂等任务注册) | 无论运行多少次,只更新或确保计划任务处于正确配置,不产生重复实例或脏状态。 |
| Human Acceptance Gate(人工在场验收门) | 对于专有通讯软件,文件拷贝完成不等于数据可用,必须由真人登录官方应用最终确认。 |
| Pre-restore Rollback(恢复前回滚隔离) | 在写入前把已有目标移到 .pre-restore-*;若复制失败,部分结果再移到 .failed-restore-*,随后尽力把原目录恢复。 |

配置包先核验再隔离解包,微信先预检再明确回填;已有目标和任务定义都留恢复前像,应用登录另验。



配置包先核验再隔离解包,微信先预检再明确回填;已有目标和任务定义都留恢复前像,应用登录另验。

解决什么
防止重装新系统后盲目覆盖导致已有数据丢失,防止因 Documents 路径或用户名不一致导致软件配置失效。


- 恢复目标目录已存在非空 xwechat_files 且未传 -ReplaceExisting: 脚本立即拒绝写入并 fail-closed(失败关闭),防止意外覆盖现有聊天记录。

解决什么
防止重装新系统后盲目覆盖导致已有数据丢失,防止因 Documents 路径或用户名不一致导致软件配置失效。


- 恢复目标目录已存在非空 xwechat_files 且未传 -ReplaceExisting: 脚本立即拒绝写入并 fail-closed(失败关闭),防止意外覆盖现有聊天记录。

- 源与目标重叠、互为父子目录、指向盘根或路径链包含重解析点: 预检直接拒绝;不会靠猜测选择 USB、Drive 或另一个目录。
- 已把旧目标移到 .pre-restore-* 后复制失败: 部分结果移到 .failed-restore-*,再恢复原目录;若回滚自身也失败,同时报告原始错误和回滚错误。
- 微信备份目录里保留着带警告的旧文件: 本地恢复会对整个来源目录算哈希并和清单比对,目前没有按警告范围过滤,可能被拒绝;这个场景没有实际跑过,先看覆盖范围、保留的旧一代和来源证据再决定,不把“完成但有警告”当成已验的全量恢复。
- 旧配置引用的用户名或 Documents 路径在目标机器上不可用: 当前恢复任务通过 PCConfig 确认实际路径并处理已知引用,回读应用加载情况;不要求改成旧盘符,未能确定的精确目标才交本人决定。
- 目标同名任务不是本项目的隐藏启动器: 注册器拒绝覆盖;不会为了让测试变绿接管别人的任务。
- 四个任务更新到一半失败或最终回读不一致: 注册器用执行前抓取的精确 XML 恢复原任务;新建任务也只有在仍匹配本次定义时才撤销。
- PowerShell 7 不在 Program Files 固定路径: 隐藏 VBS 在启动前选择 Windows PowerShell 5.1;这是真实启动分支,不是任务运行失败后的二次重试。

- 源与目标重叠、互为父子目录、指向盘根或路径链包含重解析点: 预检直接拒绝;不会靠猜测选择 USB、Drive 或另一个目录。
- 已把旧目标移到 .pre-restore-* 后复制失败: 部分结果移到 .failed-restore-*,再恢复原目录;若回滚自身也失败,同时报告原始错误和回滚错误。
- 微信备份目录里保留着带警告的旧文件: 本地恢复会对整个来源目录算哈希并和清单比对,目前没有按警告范围过滤,可能被拒绝;这个场景没有实际跑过,先看覆盖范围、保留的旧一代和来源证据再决定,不把“完成但有警告”当成已验的全量恢复。
- 旧配置引用的用户名或 Documents 路径在目标机器上不可用: 当前恢复任务通过 PCConfig 确认实际路径并处理已知引用,回读应用加载情况;不要求改成旧盘符,未能确定的精确目标才交本人决定。
- 目标同名任务不是本项目的隐藏启动器: 注册器拒绝覆盖;不会为了让测试变绿接管别人的任务。
- 四个任务更新到一半失败或最终回读不一致: 注册器用执行前抓取的精确 XML 恢复原任务;新建任务也只有在仍匹配本次定义时才撤销。
- PowerShell 7 不在 Program Files 固定路径: 隐藏 VBS 在启动前选择 Windows PowerShell 5.1;这是真实启动分支,不是任务运行失败后的二次重试。

- docs/recovery.md: 正式恢复说明:配置恢复、微信原应用恢复、单文件警告与旧副本、任务/网络/H 盘
- Restore-WeChat.ps1: 微信灾难恢复总线,提供只读预检与回滚保护
- WeChat-Recovery.Common.ps1: 路径规范化、盘根/重叠/重解析点拒绝、客户端进程检查、复制与失败回滚
- Setup-ScheduledTasks.ps1: Windows 任务计划程序常规任务幂等注册器
- ScheduledTask-Registration.Common.ps1: 任务计划 XML 解析与安全注册通用逻辑
- tests/Assert-WeChatNativeRecovery.ps1: 预检、回滚与人工验收状态断言自动化测试
- tests/Assert-ScheduledTaskRegistrationSafety.ps1: 任务注册事务性与执行器路径安全测试
- Restore-DevConfig.ps1: 可携带恢复集只读核验、独立目标解包、所选文件全树比对与原目标保留

- docs/recovery.md: 正式恢复说明:配置恢复、微信原应用恢复、单文件警告与旧副本、任务/网络/H 盘
- Restore-WeChat.ps1: 微信灾难恢复总线,提供只读预检与回滚保护
- WeChat-Recovery.Common.ps1: 路径规范化、盘根/重叠/重解析点拒绝、客户端进程检查、复制与失败回滚
- Setup-ScheduledTasks.ps1: Windows 任务计划程序常规任务幂等注册器
- ScheduledTask-Registration.Common.ps1: 任务计划 XML 解析与安全注册通用逻辑
- tests/Assert-WeChatNativeRecovery.ps1: 预检、回滚与人工验收状态断言自动化测试
- tests/Assert-ScheduledTaskRegistrationSafety.ps1: 任务注册事务性与执行器路径安全测试
- Restore-DevConfig.ps1: 可携带恢复集只读核验、独立目标解包、所选文件全树比对与原目标保留

- 9 月 18 日来源验收已执行配置包隔离恢复,8,640 文件、8,531,705,353 字节的全树 SHA-256 一致;当时 15 个检查脚本在 PowerShell 7 和 5.1 下共 30 组全部通过。没有据此声称微信官方客户端已恢复。
- 现在源码里有 29 个 Assert 检查脚本和 1 个 Python 测试文件,覆盖任务所有权、精确前像、失败回滚和恢复合同;这次运行 0 个测试、0 次恢复,不重新注册或启停任何生产任务,只在 11 月 4 日 12:39 只读回读了任务的设置和时间。
- 这次没有在干净 Windows 上导入注册表、Wi-Fi 或整套任务,没有恢复过带警告的微信副本,也没有测量恢复耗时。
把备份材料变成一套可以逐层检查的恢复顺序;它负责工具脚本,机器路径、任务恢复次序和 H 盘冷备仍由 PCConfig 决定。

- 9 月 18 日来源验收已执行配置包隔离恢复,8,640 文件、8,531,705,353 字节的全树 SHA-256 一致;当时 15 个检查脚本在 PowerShell 7 和 5.1 下共 30 组全部通过。没有据此声称微信官方客户端已恢复。
- 现在源码里有 29 个 Assert 检查脚本和 1 个 Python 测试文件,覆盖任务所有权、精确前像、失败回滚和恢复合同;这次运行 0 个测试、0 次恢复,不重新注册或启停任何生产任务,只在 11 月 4 日 12:39 只读回读了任务的设置和时间。
- 这次没有在干净 Windows 上导入注册表、Wi-Fi 或整套任务,没有恢复过带警告的微信副本,也没有测量恢复耗时。
把备份材料变成一套可以逐层检查的恢复顺序;它负责工具脚本,机器路径、任务恢复次序和 H 盘冷备仍由 PCConfig 决定。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:选择性换机恢复、微信回滚点与事务化任务重建;仓库:wlyaaaaa/devconfig-backup;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








