微信先形成验真副本,再让热备、云端跟随实际原件集合
现在
常用 · 回执核对 11 月 6 日 13:51
11 月 6 日 14:26 读:四项最近都完成;11 月 4 日微信上云失败已补上
微信 G、云端同一代(11 月 6 日 10:17),H 早一代;客户端恢复没验过
截至 11 月 6 日 · 项目仓库和备份回执

不必每次把几十 GB 重新压成一个大包;没变化的文件会跳过,单次云传输也有上限。代价是文件级副本仍需官方客户端做最终可用性验收。

当前情况:11 月 6 日 13:51 读,四个自动任务最近一次都完成、都退出 0;11 月 4 日微信上云最终核对失败已是历史,11 月 5 日那轮成功了。G 盘:11 月 6 日 10:17 的热备已完成,157,950 个文件、约 48.21 GB,每个文件都按清单核对过,没有文件警告。云端:成功回执 11 月 6 日 11:10:55,是同一代;任务每天 11:00 检查,内容变了才传。外接 H 盘:还是 11 月 5 日 10:32 那一代,比 G、云端早一代,要等下一轮冷备;11 月 6 日 01:23—02:51 那轮冷备里,微信这一项完成,全部核对 157,832 个文件、修复 0 个;整轮“部分完成”挡住的是个人资料那一项,不是微信。这项回执没写自己的结束时刻,这次也没有再重算 H 的文件。云上实际内容这次没联网重读,官方客户端恢复未验,也不能证明微信应用层面一致。

项目快照核对于 2026-11-06 13:51(北京时间),只读状态入口、回执和 PCConfig 冷备总回执,没有修复、重跑、联网或重新散列原文件;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

微信先形成验真副本,再让热备、云端跟随实际原件集合
现在
常用 · 回执核对 11 月 6 日 13:51
11 月 6 日 14:26 读:四项最近都完成;11 月 4 日微信上云失败已补上
微信 G、云端同一代(11 月 6 日 10:17),H 早一代;客户端恢复没验过
截至 11 月 6 日 · 项目仓库和备份回执

不必每次把几十 GB 重新压成一个大包;没变化的文件会跳过,单次云传输也有上限。代价是文件级副本仍需官方客户端做最终可用性验收。

当前情况:11 月 6 日 13:51 读,四个自动任务最近一次都完成、都退出 0;11 月 4 日微信上云最终核对失败已是历史,11 月 5 日那轮成功了。G 盘:11 月 6 日 10:17 的热备已完成,157,950 个文件、约 48.21 GB,每个文件都按清单核对过,没有文件警告。云端:成功回执 11 月 6 日 11:10:55,是同一代;任务每天 11:00 检查,内容变了才传。外接 H 盘:还是 11 月 5 日 10:32 那一代,比 G、云端早一代,要等下一轮冷备;11 月 6 日 01:23—02:51 那轮冷备里,微信这一项完成,全部核对 157,832 个文件、修复 0 个;整轮“部分完成”挡住的是个人资料那一项,不是微信。这项回执没写自己的结束时刻,这次也没有再重算 H 的文件。云上实际内容这次没联网重读,官方客户端恢复未验,也不能证明微信应用层面一致。

项目快照核对于 2026-11-06 13:51(北京时间),只读状态入口、回执和 PCConfig 冷备总回执,没有修复、重跑、联网或重新散列原文件;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

微信图片视频很大,不必每次整包重压;直接一边读正在变化的微信目录、一边上传又可能混进不同时间的文件。先在 G 盘建立一份可逐文件核对的副本,云端只从这份已核对的副本复制。

举个实际例子

我问“哪些微信文件已经在 G,旧文件会不会自己又回来”:工具回报已验的当前代与前一代,只有源根可访问且完整枚举时才传播精确删除;整个盘不见了则保留旧副本,不按空库清理。某个文件被杀毒软件拦下或扫描后消失时,会单独列出来,并保住它的旧副本。

最后我会得到什么

最近一次完成的 G 盘记录(11 月 6 日 10:17)说明已保存微信数据库、图片和音视频约 48.21 GB。要是某次热备没收尾(比如 10 月 19 日那次),工具会如实说当前副本“说不准”,不拿前一次的旧成功顶替。这一份已经上云:成功回执 11 月 6 日 11:10:55;H 盘还是 11 月 5 日 10:32 那一代,要等下一轮冷备。这次没有再逐个重算 H 文件,云端实际内容也没有联网确认。文件齐全不等于微信客户端一定能读回聊天。

这项功能怎样使用

用途与实际影响

为什么需要它

微信图片视频很大,不必每次整包重压;直接一边读正在变化的微信目录、一边上传又可能混进不同时间的文件。先在 G 盘建立一份可逐文件核对的副本,云端只从这份已核对的副本复制。

举个实际例子

我问“哪些微信文件已经在 G,旧文件会不会自己又回来”:工具回报已验的当前代与前一代,只有源根可访问且完整枚举时才传播精确删除;整个盘不见了则保留旧副本,不按空库清理。某个文件被杀毒软件拦下或扫描后消失时,会单独列出来,并保住它的旧副本。

最后我会得到什么

最近一次完成的 G 盘记录(11 月 6 日 10:17)说明已保存微信数据库、图片和音视频约 48.21 GB。要是某次热备没收尾(比如 10 月 19 日那次),工具会如实说当前副本“说不准”,不拿前一次的旧成功顶替。这一份已经上云:成功回执 11 月 6 日 11:10:55;H 盘还是 11 月 5 日 10:32 那一代,要等下一轮冷备。这次没有再逐个重算 H 文件,云端实际内容也没有联网确认。文件齐全不等于微信客户端一定能读回聊天。

结果怎么看
正常时

文件完整核对后才设为当前备份,留一份前一版本;云端每天检查一次,从这份已验材料复制,内容没变而且云上成功不到 7 天就跳过,不重复传。

发现问题时

只有登记过的单文件例外,比如被杀毒软件拦下或扫描后消失,才把这几个文件记成警告、保留旧副本,其余文件继续核对,必要时多留一代;普通占用、空间不足、内容对不上等其他读取问题,仍然算这次失败。云端单次流量达到上限时报告未传完,等后续任务或明确补齐。

入口不可用或证据不足时

来源磁盘读不全或目标不可达时不按空目录传播删除,也不把这次复制说成完整成功;G 盘副本缺失、过旧或损坏时,云端拒绝上传,不改读正在使用的微信原件。

结果怎么看
正常时

文件完整核对后才设为当前备份,留一份前一版本;云端每天检查一次,从这份已验材料复制,内容没变而且云上成功不到 7 天就跳过,不重复传。

发现问题时

只有登记过的单文件例外,比如被杀毒软件拦下或扫描后消失,才把这几个文件记成警告、保留旧副本,其余文件继续核对,必要时多留一代;普通占用、空间不足、内容对不上等其他读取问题,仍然算这次失败。云端单次流量达到上限时报告未传完,等后续任务或明确补齐。

入口不可用或证据不足时

来源磁盘读不全或目标不可达时不按空目录传播删除,也不把这次复制说成完整成功;G 盘副本缺失、过旧或损坏时,云端拒绝上传,不改读正在使用的微信原件。

从哪里开始

在已接入的 AI 对话中明确提出微信原生数据备份或查询 Hot 状态;实际动作由项目已安装的微信备份任务执行。

需要准备什么
  • 当前微信原件目录是否可读
  • G 盘最近一次已核对副本的日期
  • G 或 Drive 目标状态
从开始到拿到结果
1先核对微信原件是否读得全
系统按现有清单检查应用目录和图片视频是否可读;常规任务始终备完整数据,不再只备数据库。
2先形成独立可核对副本
从受约束的同一时间点复制文件,并逐个核对内容;整份成功(或只差登记了警告的个别文件)后才把它设为当前备份。
3按源集合同步与报告
源可完整读取时传播实际删除,整根离线则保留旧副本;云端流量上限或上传未完时不报告完整成功。
从哪里开始

在已接入的 AI 对话中明确提出微信原生数据备份或查询 Hot 状态;实际动作由项目已安装的微信备份任务执行。

需要准备什么
  • 当前微信原件目录是否可读
  • G 盘最近一次已核对副本的日期
  • G 或 Drive 目标状态
从开始到拿到结果
1先核对微信原件是否读得全
系统按现有清单检查应用目录和图片视频是否可读;常规任务始终备完整数据,不再只备数据库。
2先形成独立可核对副本
从受约束的同一时间点复制文件,并逐个核对内容;整份成功(或只差登记了警告的个别文件)后才把它设为当前备份。
3按源集合同步与报告
源可完整读取时传播实际删除,整根离线则保留旧副本;云端流量上限或上传未完时不报告完整成功。
技术实现与依据(一)

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

当前 G 回执是 11 月 6 日 10:17:03 完成,157,950 文件、48.21 GB,producer_verified_manifest_bound、VSS 时点、无文件警告;同一代 11 月 6 日 11:00:02—12:11:19 上云完成,成功回执 11:10:55,rclone_checksum_check、upload_source.gate=passed、用的是 G 已验代,没有联网重读;11 月 4 日 11:00:02—12:11:44 那次最终核对失败(wechat_drive_final_verification_failed、任务退出 1)留作历史。13:51 回读 PCConfig 11 月 6 日 01:23:22—02:51:48 整轮回执:整体 partial(挡住的是 personal_data),wechat 项 complete,sha256_full_tree 核验 157,832 文件、48,191,819,862 字节、修复 0,清单 SHA-256=583a04456b8d827820853d7a16131faaf1b8788622889bbca14ec8de52964053,是 11 月 5 日 10:32 那一代,和 G 当前回执、云端成功回执的 6ba215ac8ead08d7b8010c1d0b38952634740d8b38c8ba1505b591c6054b8eb9 不同,H 要等下一轮冷备;这项没写自己的结束时刻,本次也未再重算 G/H 全部文件。客户端恢复 not_tested、应用一致性 not_proven(11 月 6 日 13:51 回读)

关键规则与设计选择
1
11 月 6 日 G 盘这一代约 48.21 GB,仍采用文件级候选,不为每次增量重新压缩整个媒体库。
2
G 盘先建立独立候选再校验切换,旧成功代保留;可复用的硬链接只来自已验备份,不能把活动原件硬链接进去。个别文件有警告时保留它的旧文件或登记的旧一代,可恢复的前代可以多于一份。
3
Drive 只消费 G 盘当前已核对的一代:回执不超过 48 小时、目标匹配、整树哈希和 VSS 时点都已确认,上传全程锁住 G 盘副本;缺失、过旧、损坏或不是 VSS 时点就拒绝,不读活动原件补传。复制、核对后在相同过滤范围删除旧对象并严格复验,警告文件的云端旧副本不删。每天先检查:同一范围、同一 Hot 根、同一清单、同一远端目的地,且已有云端成功不足 7 天,就记 skipped_current、不刷新成功时间;新一代清单改变或旧成功过期,才按当前流程上传。任务名 WeChatBackup-Drive-Weekly 是兼容旧名,10 月 20 日起(5dab503)实际每天运行。
4
默认 -MaxTransfer 8G 只限制一次 rclone 进程;WeChatBackup-Drive-Weekly 任务设置里 RestartCount 仍是 3、间隔 30 分钟、最长运行 4 小时,但不当作业务失败的补跑承诺,正常补跑是下一次每天 11:00 的定时运行;每次运行重新获得自己的单次额度,所以累计流量和云空间仍要另看。rclone 自己的内部重试和任务级重试不是一回事。
5
WAL、SHM 和 journal 继续随数据库保留。默认隐藏 Hot 带 UseVss,只有快照真实创建并按它取数才写 vss_crash_consistent;手动不带该参数明确写 live_source,二者都不宣称应用一致性。
6
Hot 成功后原子写入并回读有界 JSON 回执;PCConfig 只在回执目标匹配且不超过 36 小时时接受微信热备前置条件。
7
云端补传监控(WeChatDrive-Monitor-Hourly)已停用,最后一次运行是北京时间 7 月 11 日 01:53;正常运行依赖每天 09:30 的 G 盘任务和每天 11:00 的云端任务。
当前怎样实现
  • Backup-WeChat.ps1 常规任务用 -Target Hot(G 盘)和 Drive(云端);“E 盘再存一份”(-Target Local)和“云端只传数据库”(-DbOnly)已停用,源码里只留兼容实现,-DriveFull 可覆盖 DbOnly 回到完整范围。
技术实现与依据(一)

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

当前 G 回执是 11 月 6 日 10:17:03 完成,157,950 文件、48.21 GB,producer_verified_manifest_bound、VSS 时点、无文件警告;同一代 11 月 6 日 11:00:02—12:11:19 上云完成,成功回执 11:10:55,rclone_checksum_check、upload_source.gate=passed、用的是 G 已验代,没有联网重读;11 月 4 日 11:00:02—12:11:44 那次最终核对失败(wechat_drive_final_verification_failed、任务退出 1)留作历史。13:51 回读 PCConfig 11 月 6 日 01:23:22—02:51:48 整轮回执:整体 partial(挡住的是 personal_data),wechat 项 complete,sha256_full_tree 核验 157,832 文件、48,191,819,862 字节、修复 0,清单 SHA-256=583a04456b8d827820853d7a16131faaf1b8788622889bbca14ec8de52964053,是 11 月 5 日 10:32 那一代,和 G 当前回执、云端成功回执的 6ba215ac8ead08d7b8010c1d0b38952634740d8b38c8ba1505b591c6054b8eb9 不同,H 要等下一轮冷备;这项没写自己的结束时刻,本次也未再重算 G/H 全部文件。客户端恢复 not_tested、应用一致性 not_proven(11 月 6 日 13:51 回读)

关键规则与设计选择
1
11 月 6 日 G 盘这一代约 48.21 GB,仍采用文件级候选,不为每次增量重新压缩整个媒体库。
2
G 盘先建立独立候选再校验切换,旧成功代保留;可复用的硬链接只来自已验备份,不能把活动原件硬链接进去。个别文件有警告时保留它的旧文件或登记的旧一代,可恢复的前代可以多于一份。
3
Drive 只消费 G 盘当前已核对的一代:回执不超过 48 小时、目标匹配、整树哈希和 VSS 时点都已确认,上传全程锁住 G 盘副本;缺失、过旧、损坏或不是 VSS 时点就拒绝,不读活动原件补传。复制、核对后在相同过滤范围删除旧对象并严格复验,警告文件的云端旧副本不删。每天先检查:同一范围、同一 Hot 根、同一清单、同一远端目的地,且已有云端成功不足 7 天,就记 skipped_current、不刷新成功时间;新一代清单改变或旧成功过期,才按当前流程上传。任务名 WeChatBackup-Drive-Weekly 是兼容旧名,10 月 20 日起(5dab503)实际每天运行。
4
默认 -MaxTransfer 8G 只限制一次 rclone 进程;WeChatBackup-Drive-Weekly 任务设置里 RestartCount 仍是 3、间隔 30 分钟、最长运行 4 小时,但不当作业务失败的补跑承诺,正常补跑是下一次每天 11:00 的定时运行;每次运行重新获得自己的单次额度,所以累计流量和云空间仍要另看。rclone 自己的内部重试和任务级重试不是一回事。
5
WAL、SHM 和 journal 继续随数据库保留。默认隐藏 Hot 带 UseVss,只有快照真实创建并按它取数才写 vss_crash_consistent;手动不带该参数明确写 live_source,二者都不宣称应用一致性。
6
Hot 成功后原子写入并回读有界 JSON 回执;PCConfig 只在回执目标匹配且不超过 36 小时时接受微信热备前置条件。
7
云端补传监控(WeChatDrive-Monitor-Hourly)已停用,最后一次运行是北京时间 7 月 11 日 01:53;正常运行依赖每天 09:30 的 G 盘任务和每天 11:00 的云端任务。
当前怎样实现
  • Backup-WeChat.ps1 常规任务用 -Target Hot(G 盘)和 Drive(云端);“E 盘再存一份”(-Target Local)和“云端只传数据库”(-DbOnly)已停用,源码里只留兼容实现,-DriveFull 可覆盖 DbOnly 回到完整范围。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
1
微信 Hot 隐藏任务每天 09:30 以当前用户 Highest 启动,并传入 -Target Hot -UseVss;先创建受约束的时点副本,再从该副本捕获。
2
复制到独立候选,逐个文件复制并核对 SHA-256,已验同内容的文件从旧备份做硬链接,两阶段切换后再读回确认;个别文件被杀毒软件拦下或扫描后消失记警告,其余照常完成。
3
源根仍可用且集合完整时切换当前与前一成功代,发布 v2 Hot 回执;读不完整或切换失败保留旧成功状态。
  • -MaxTransfer 0 会关闭单次 8G 上限,只适合明确的一次性补齐并由人持续看进度;常规定时任务保持默认上限。
  • wechat.hot-backup-receipt.v2 绑定完整 manifest(清单)、generation(代际)、数量/字节、sha256_full_tree 与 source_follow_verified;有警告时额外列出警告文件的相对路径、原因和错误码,核对范围标为“除警告文件外的所选文件”。状态读取回执而非重新哈希整库;10 月 21 日这一代的回执就是这样读到的。
  • WeChat-Recovery.Common.ps1 负责路径规范化、目标/进程检查、复制与回滚;WAL/SHM/journal 的保留来自备份过滤规则,而不是这个恢复模块定位数据库。
  • Monitor-WeChatDrive.ps1 是首次补齐时用的续传监控,对应计划任务已停用;源码还在,重装任务时保持停用,只有显式启用才会运行。
  • tests/Assert-WeChatIncrementalIntegrity.ps1 验证 checksum 内容变化用例,并静态检查流量上限、WAL/SHM 不被过滤和 Hot 回执字段。
执行流程
技术实现与依据(二)
1
微信 Hot 隐藏任务每天 09:30 以当前用户 Highest 启动,并传入 -Target Hot -UseVss;先创建受约束的时点副本,再从该副本捕获。
2
复制到独立候选,逐个文件复制并核对 SHA-256,已验同内容的文件从旧备份做硬链接,两阶段切换后再读回确认;个别文件被杀毒软件拦下或扫描后消失记警告,其余照常完成。
3
源根仍可用且集合完整时切换当前与前一成功代,发布 v2 Hot 回执;读不完整或切换失败保留旧成功状态。
  • -MaxTransfer 0 会关闭单次 8G 上限,只适合明确的一次性补齐并由人持续看进度;常规定时任务保持默认上限。
  • wechat.hot-backup-receipt.v2 绑定完整 manifest(清单)、generation(代际)、数量/字节、sha256_full_tree 与 source_follow_verified;有警告时额外列出警告文件的相对路径、原因和错误码,核对范围标为“除警告文件外的所选文件”。状态读取回执而非重新哈希整库;10 月 21 日这一代的回执就是这样读到的。
  • WeChat-Recovery.Common.ps1 负责路径规范化、目标/进程检查、复制与回滚;WAL/SHM/journal 的保留来自备份过滤规则,而不是这个恢复模块定位数据库。
  • Monitor-WeChatDrive.ps1 是首次补齐时用的续传监控,对应计划任务已停用;源码还在,重装任务时保持停用,只有显式启用才会运行。
  • tests/Assert-WeChatIncrementalIntegrity.ps1 验证 checksum 内容变化用例,并静态检查流量上限、WAL/SHM 不被过滤和 Hot 回执字段。
执行流程
技术实现与依据(三)
4
每天 11:00 启动 WeChatBackup-Drive-Weekly(任务名是旧的,实际每天运行),先按上面的条件判断要不要跳过。最近一次是 11 月 6 日 11:00:02—12:11:19,complete,upload_source.gate=passed、用的是 G 已验代,本机记录,没有联网重读云端;此前 11 月 5 日 11:00:02—12:23:02 也完成;11 月 4 日 11:00:02—12:11:44 那次最终核对失败(wechat_drive_final_verification_failed),任务退出 1;更早的成功是 11 月 3 日 11:00:02—12:11:08 那次;11 月 2 日 11:00:01 那次中途结束、没有最终记录(backup_process_interrupted,退出码未知);10 月 19 日那次因热备事务没收尾而失败;10 月 22 日 11:00—12:10 那次完成。
5
按远端 binding 锁定 G 盘当前已核对的一代,复制、核对后在同过滤范围清旧并复验;不直接边读活动微信边上传,警告文件的云端旧副本不清。
6
默认传完整原应用目录;只传 db_storage 的 -DbOnly 已停用,常规任务不用。仅明确人工补齐时可用 -MaxTransfer 0 关闭单次上限。
7
达到单次流量上限时记录未完成,不发布全量成功;正常完成还需严格集合/内容比对并上传可携带清单,之后的定时运行仍单独累计流量。
技术实现与依据(三)
4
每天 11:00 启动 WeChatBackup-Drive-Weekly(任务名是旧的,实际每天运行),先按上面的条件判断要不要跳过。最近一次是 11 月 6 日 11:00:02—12:11:19,complete,upload_source.gate=passed、用的是 G 已验代,本机记录,没有联网重读云端;此前 11 月 5 日 11:00:02—12:23:02 也完成;11 月 4 日 11:00:02—12:11:44 那次最终核对失败(wechat_drive_final_verification_failed),任务退出 1;更早的成功是 11 月 3 日 11:00:02—12:11:08 那次;11 月 2 日 11:00:01 那次中途结束、没有最终记录(backup_process_interrupted,退出码未知);10 月 19 日那次因热备事务没收尾而失败;10 月 22 日 11:00—12:10 那次完成。
5
按远端 binding 锁定 G 盘当前已核对的一代,复制、核对后在同过滤范围清旧并复验;不直接边读活动微信边上传,警告文件的云端旧副本不清。
6
默认传完整原应用目录;只传 db_storage 的 -DbOnly 已停用,常规任务不用。仅明确人工补齐时可用 -MaxTransfer 0 关闭单次上限。
7
达到单次流量上限时记录未完成,不发布全量成功;正常完成还需严格集合/内容比对并上传可携带清单,之后的定时运行仍单独累计流量。
名词和入口
本模块用到的名词
名词意思
File-by-File Incremental(逐文件增量)针对已压缩的多媒体大目录,按单个文件比对哈希只传变动文件,避免整包重新打包。
Transfer Fuse(流量保险丝)限制一次 rclone 进程的传输量;它不限制多次计划任务重试的累计流量,也不保证云盘总空间够用。
WAL Co-preservation(预写式日志伴生保全)SQLite WAL 模式下可能有已提交事务尚未合并进主库,因此 -wal、-shm 和 journal 不应被备份过滤;一起复制仍不保证运行中快照一致。
Bounded Hot Receipt(有界热备回执)用完整集合清单、代号、数量与全树哈希验真状态说明这次保全边界(例如 10 月 21 日那份记 collection complete、sha256_full_tree、source_follow_verified);从不读取或解释聊天内容,没有警告时也不列文件名,有警告时只列警告文件的相对路径和原因;不证明微信已成功登录。
专业定义

几十 GB 不反复压成整包;先复制验真,再切换当前/前一代。本人从可信原件中删除的文件可以同步退出,整根离线不会当空库。

名词和入口
本模块用到的名词
名词意思
File-by-File Incremental(逐文件增量)
意思:
针对已压缩的多媒体大目录,按单个文件比对哈希只传变动文件,避免整包重新打包。
Transfer Fuse(流量保险丝)
意思:
限制一次 rclone 进程的传输量;它不限制多次计划任务重试的累计流量,也不保证云盘总空间够用。
WAL Co-preservation(预写式日志伴生保全)
意思:
SQLite WAL 模式下可能有已提交事务尚未合并进主库,因此 -wal、-shm 和 journal 不应被备份过滤;一起复制仍不保证运行中快照一致。
Bounded Hot Receipt(有界热备回执)
意思:
用完整集合清单、代号、数量与全树哈希验真状态说明这次保全边界(例如 10 月 21 日那份记 collection complete、sha256_full_tree、source_follow_verified);从不读取或解释聊天内容,没有警告时也不列文件名,有警告时只列警告文件的相对路径和原因;不证明微信已成功登录。
专业定义

几十 GB 不反复压成整包;先复制验真,再切换当前/前一代。本人从可信原件中删除的文件可以同步退出,整根离线不会当空库。

出问题时

解决什么

避免大体积微信数据阻塞配置包,也避免每次全量重传;同时防止只看任务名称或目录存在就误以为最近热备一定完成。

边界
  • 原应用数据采用文件级增量;源可用且集合完整时传播实际删除,源根离线、无法读全或身份不符不当作空源。扫描后消失的文件只在这次保留旧副本,下次源正常且仍不在才按我删除处理;被杀毒软件拦下的文件一直保留旧副本,直到重新可读。
  • 默认单次调用设置 8G 传输上限;多次运行的累计流量另算,-MaxTransfer 0 仅供人工看守的一次性补齐。
  • -DbOnly 已停用,只保留兼容代码;它只含 db_storage,不能冒充包含图片、视频等媒体的完整原应用备份,也不会删云端已有媒体。
  • 伴随保留 SQLite WAL 与 SHM;VSS 只证明文件系统时点,手动 live_source 还可能跨时刻读取。两条路线均需实际微信客户端恢复验收。
失败与恢复
  • 单次上传达到 -MaxTransfer 8G 上限: rclone 停止这次继续传输并把非完成结果交给任务;后续任务可继续,但总云空间与累计流量仍需单独观察。
  • 复制时遇到占用、目标空间不足、来源根不可读或内容核对不一致: 这次 Hot 失败且不发布新的 complete 回执;旧热备不删除,下一次任务再补。只有单个文件被杀毒软件拦下或扫描后消失时才记警告继续。
  • 云端目标路径不可达或网络中断: 保留 G 盘副本并让 Drive 任务返回失败;补传监控已停用,正常补跑来自下一次每天 11:00 的定时运行;任务设置里的 RestartCount 不当作业务失败的补跑承诺。
出问题时

解决什么

避免大体积微信数据阻塞配置包,也避免每次全量重传;同时防止只看任务名称或目录存在就误以为最近热备一定完成。

边界
  • 原应用数据采用文件级增量;源可用且集合完整时传播实际删除,源根离线、无法读全或身份不符不当作空源。扫描后消失的文件只在这次保留旧副本,下次源正常且仍不在才按我删除处理;被杀毒软件拦下的文件一直保留旧副本,直到重新可读。
  • 默认单次调用设置 8G 传输上限;多次运行的累计流量另算,-MaxTransfer 0 仅供人工看守的一次性补齐。
  • -DbOnly 已停用,只保留兼容代码;它只含 db_storage,不能冒充包含图片、视频等媒体的完整原应用备份,也不会删云端已有媒体。
  • 伴随保留 SQLite WAL 与 SHM;VSS 只证明文件系统时点,手动 live_source 还可能跨时刻读取。两条路线均需实际微信客户端恢复验收。
失败与恢复
  • 单次上传达到 -MaxTransfer 8G 上限: rclone 停止这次继续传输并把非完成结果交给任务;后续任务可继续,但总云空间与累计流量仍需单独观察。
  • 复制时遇到占用、目标空间不足、来源根不可读或内容核对不一致: 这次 Hot 失败且不发布新的 complete 回执;旧热备不删除,下一次任务再补。只有单个文件被杀毒软件拦下或扫描后消失时才记警告继续。
  • 云端目标路径不可达或网络中断: 保留 G 盘副本并让 Drive 任务返回失败;补传监控已停用,正常补跑来自下一次每天 11:00 的定时运行;任务设置里的 RestartCount 不当作业务失败的补跑承诺。
依据与来源(一)
真实入口
  • Backup-WeChat.ps1: 微信原生应用数据增量备份主流水线
  • G:\80_Backup\ControlPlane\wechat-hot-last.json: 微信 Hot 完成回执,供 PCConfig 冷备前置检查;不含聊天内容,有警告时列出警告文件路径
  • WeChat-Recovery.Common.ps1: 微信恢复路径、客户端状态、本地复制与失败回滚通用模块
  • Monitor-WeChatDrive.ps1: 首次云端补齐期间的临时续传监控;对应任务已停用,当前并非常规运行任务
  • tests/Assert-WeChatIncrementalIntegrity.ps1: checksum 内容变化 fixture、Hot 回执字段和部分静态接线检查
  • tests/Assert-CloudBackupIntegrity.ps1: 远端对象核对与 WAL/SHM/journal 未被过滤的静态合同
如何验证
  • 当前来源回归覆盖微信候选、保留与同名内容漂移;网页本轮(10 月 22 日)没有重新执行源测试或修改原应用数据。
  • 8G 上限、DbOnly/DriveFull 范围、警告文件保旧与 WAL/SHM 保留只有脚本/静态合同证据;本轮没有真的传满 8G,没有触发过警告场景,也没有运行 SQLite 一致性测试。
依据与来源(一)
真实入口
  • Backup-WeChat.ps1: 微信原生应用数据增量备份主流水线
  • G:\80_Backup\ControlPlane\wechat-hot-last.json: 微信 Hot 完成回执,供 PCConfig 冷备前置检查;不含聊天内容,有警告时列出警告文件路径
  • WeChat-Recovery.Common.ps1: 微信恢复路径、客户端状态、本地复制与失败回滚通用模块
  • Monitor-WeChatDrive.ps1: 首次云端补齐期间的临时续传监控;对应任务已停用,当前并非常规运行任务
  • tests/Assert-WeChatIncrementalIntegrity.ps1: checksum 内容变化 fixture、Hot 回执字段和部分静态接线检查
  • tests/Assert-CloudBackupIntegrity.ps1: 远端对象核对与 WAL/SHM/journal 未被过滤的静态合同
如何验证
  • 当前来源回归覆盖微信候选、保留与同名内容漂移;网页本轮(10 月 22 日)没有重新执行源测试或修改原应用数据。
  • 8G 上限、DbOnly/DriveFull 范围、警告文件保旧与 WAL/SHM 保留只有脚本/静态合同证据;本轮没有真的传满 8G,没有触发过警告场景,也没有运行 SQLite 一致性测试。
依据与来源(二)
11 月 6 日 13:51 核对状态与回执(Backup-Status -NoDrive -Json 零写入、退出码 0):整体 receipts_current_with_skipped_files,跳过的是配置采集里 1 个锁文件,微信这一层是 current。G 微信热备 11 月 6 日 10:17:03 完成,157,950 文件、48,206,842,439 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,这次只读取、没有重新散列原文件。微信 Drive 成功回执 11 月 6 日 11:10:55,157,950 文件、48,206,842,439 字节,清单 SHA-256=6ba215ac8ead08d7b8010c1d0b38952634740d8b38c8ba1505b591c6054b8eb9,rclone_checksum_check、source_follow_verified,来源绑定 G 上同一代;这次没有联网重读云端(not_contacted)。H 上还是旧清单 583a04456b8d827820853d7a16131faaf1b8788622889bbca14ec8de52964053(11 月 5 日 10:32 那一代):PCConfig 的 core-recovery/cold-last.json 记 11 月 6 日 01:23:22—02:51:48 那一轮整体 partial(挡住的是 personal_data),wechat 集合 complete,sha256_full_tree 核验 157,832 文件、48,191,819,862 字节、修复 0,source_follow_verified_prune、0 单文件警告;要等下一轮冷备,回执没写这一项的结束时刻,H 上的内容这次没有再重算。
历史:11 月 6 日 05:30 核对状态与回执(Backup-Status -NoDrive -Json 零写入、退出码 0):整体 receipts_current_with_skipped_files,跳过的是配置采集里 1 个锁文件,微信这一层是 current。G 微信热备 11 月 5 日 10:32:55 完成,157,832 文件、48,191,819,862 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,这次只读取、没有重新散列原文件。微信 Drive 成功回执 11 月 5 日 12:22:41,157,832 文件、48,191,819,862 字节,rclone_checksum_check、source_follow_verified,来源绑定 G 上同一代;这次没有联网重读云端(not_contacted)。PCConfig 的 core-recovery/cold-last.json 记 11 月 6 日 01:23:22—02:51:48 那一轮整体 partial(挡住的是 personal_data),wechat 集合 complete,sha256_full_tree 核验 157,832 文件、48,191,819,862 字节、修复 0,source_follow_verified_prune、0 单文件警告,清单 SHA-256 与 G 相同;回执没写这一项的结束时刻,H 上的内容这次没有再重算。
历史:11 月 4 日 15:08 核对状态与回执(Backup-Status -NoDrive -Json 零写入、退出码 0):整体 attention_required,因为当天微信上云失败;配置采集另有 5 个跳过的锁文件,微信 G 副本这一层是 current。G 微信热备 11 月 4 日 10:17:54 完成,157,674 文件、48,182,328,962 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,当时只读取、没有重新散列原文件。微信 Drive 成功回执 11 月 3 日 12:10:47,157,403 文件、48,171,565,186 字节,rclone_checksum_check、source_follow_verified,来源绑定 11 月 3 日 10:25:56 那一代 G 热备;当时没有联网重读云端(not_contacted)。15:08 另读 G/H 清单:同 run_id=cd2285a15e784719a1d3e25da3b92f88、同 content_sha256=e366230f48c268cd97cd2f211357337b7b9b58b6b8fd9d4e6b38ca55a0310958,H 清单也记 157,674 文件、48,182,328,962 字节。当时未逐文件重算 G/H,也没有另取 H 子项完成回执;G 清单生成时刻不能当 H 完成时刻。PCConfig 当天 14:30 新一轮当时还在运行。再上一份已结束的整轮证据:core-recovery/cold-last.json 记 11 月 3 日 16:03:21—17:53:13 那一轮整体 partial(挡住的是文档与本地存档、个人媒体),wechat 集合 complete,157,403 文件,source_follow_verified_prune、0 单文件警告;没有在 H 上重算全树内容。
  • 9 月 18 日历史 Hot 为 145,307 文件、45,218,959,121 字节,当时 PCConfig 对 G/H 全量验真并修复 53 个同大小/时间的冷备差异;9 月 22 日 145,473 文件、45,413,770,744 字节,9 月 24 日 145,544 文件、45,422,871,529 字节,9 月 28 日 146,300 文件、45,603,489,818 字节,都保留原日期。北京时间 10 月 11 日 09:30—11:02 的自然运行在 G 盘生成 148,592 文件、45,972,129,496 字节的一代,生产者报告 VSS 与全树验真、无警告。H 盘(历史):10 月 12 日 05:40 回读 PCConfig 10 月 11 日 18:39:26 的冷备记录,H 微信完成 148,592 文件、45,972,129,496 字节,sha256_full_tree 全树核对,修复 16 个文件,0 文件警告,清单哈希与 G 当时的回执一致;这是冷备生产者当时的验真,当时只读取、没有重算。热维护和冷备两份回执引用同一个恢复上下文编号;整次冷备结果为 complete_with_warnings,警告来自其他集合,微信集合本身是 complete。
  • 历史:10 月 30 日 11:11 的 Backup-Status -NoDrive -Json(零写入,退出码 0):整体 attention_required,原因在配置包过期,微信这一层是 current。当时的 G 微信热备(10 月 30 日 10:10:50 完成)是 156,448 文件、48,064,272,633 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,当时只读取、没有重新散列原文件。10 月 30 日 11:00 开始的微信上云在读状态时仍是 running,不算已完成,也不是失败;Drive 当时 not_contacted,没有联网重读云端。PCConfig 正式默认的 core-recovery/cold-last.json 记 10 月 29 日 14:30—18:06 那一轮整体 partial(配置项因来源过旧被挡),wechat 集合 complete,156,156 文件、48,037,548,152 字节,sha256_full_tree;那是早于 30 日 G 这一份的另一代,G 的数字和日期不能借给 H,旧的单项冷备回执也不能覆盖当时那份总批次。
  • 历史:10 月 23 日 10:28 的 Backup-Status -NoDrive -Json(零写入,退出码 0):整体 receipts_current。10 月 23 日 10:16:05 那次 G 微信热备完成,154,912 文件、46,826,139,227 字节,collection complete、sha256_full_tree、source_follow_verified、无文件警告;这是生产者的验真,当时只读取、没有重算。本机最近一次微信上云记录是 10 月 22 日 11:00—12:10:58 drive=complete,上传来源是上一代(22 日 10:14:14 那份 G 热备,gate passed);23 日 10:16:05 这一代还没有上云记录;Drive 当时 not_contacted,没有联网重读云端。PCConfig 冷备当时没有新读:10 月 22 日 06:47 读到的 core-recovery/cold-last.json 记 10 月 21 日 16:47:54 那一轮整体 complete_with_warnings、20 个集合没有 blocked,wechat 集合 complete,警告来自密码中心那一项 H 落后 G 和四个来源新鲜度 unknown;那一轮早于现在这一代。
  • 历史:10 月 20 日 07:41 的 Backup-Status -NoDrive(零写入):微信 verification=unknown,reason=backup_tree_transaction_pending。10 月 19 日 09:30 启动的热备尝试回执仍是 running,计划任务上次结果 125;当天 11:00 上云失败,原因相同。G 上最近的成功回执仍记 10 月 18 日 10:14,153,226 文件、46,623,230,809 字节,但事务门没放行前不能凭这份旧回执说当前完整。微信 Drive 最近成功为 10 月 12 日 12:18,148,878 文件、46,034,606,676 字节,完整原应用数据、经 rclone 校验(不含有文件警告的文件)。PCConfig 10 月 19 日 14:30:11 冷备 status=blocked、reason=required_backup_freshness_not_ready:wechat,H 写入状态 unknown_no_complete_receipt。当时没有修复事务、启动备份或改 PCConfig。10 月 12 日那次状态曾显示微信 Drive 最近成功为 10 月 5 日 12:17,147,560 文件、45,777,553,213 字节。没有读取聊天内容、访问云端或把生产者此前验真冒充这次重新计算。
  • 云端最后成功采用本机已有回执;网页没有重列微信远端对象、执行 rclone check 或登录客户端。
与其他模块的关系

把体积大、变化快的微信原应用目录从配置包里拆出来单独维护;热备结果再用有界回执交给 PCConfig 判断冷备前置条件。

依据与来源(二)
11 月 6 日 13:51 核对状态与回执(Backup-Status -NoDrive -Json 零写入、退出码 0):整体 receipts_current_with_skipped_files,跳过的是配置采集里 1 个锁文件,微信这一层是 current。G 微信热备 11 月 6 日 10:17:03 完成,157,950 文件、48,206,842,439 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,这次只读取、没有重新散列原文件。微信 Drive 成功回执 11 月 6 日 11:10:55,157,950 文件、48,206,842,439 字节,清单 SHA-256=6ba215ac8ead08d7b8010c1d0b38952634740d8b38c8ba1505b591c6054b8eb9,rclone_checksum_check、source_follow_verified,来源绑定 G 上同一代;这次没有联网重读云端(not_contacted)。H 上还是旧清单 583a04456b8d827820853d7a16131faaf1b8788622889bbca14ec8de52964053(11 月 5 日 10:32 那一代):PCConfig 的 core-recovery/cold-last.json 记 11 月 6 日 01:23:22—02:51:48 那一轮整体 partial(挡住的是 personal_data),wechat 集合 complete,sha256_full_tree 核验 157,832 文件、48,191,819,862 字节、修复 0,source_follow_verified_prune、0 单文件警告;要等下一轮冷备,回执没写这一项的结束时刻,H 上的内容这次没有再重算。
历史:11 月 6 日 05:30 核对状态与回执(Backup-Status -NoDrive -Json 零写入、退出码 0):整体 receipts_current_with_skipped_files,跳过的是配置采集里 1 个锁文件,微信这一层是 current。G 微信热备 11 月 5 日 10:32:55 完成,157,832 文件、48,191,819,862 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,这次只读取、没有重新散列原文件。微信 Drive 成功回执 11 月 5 日 12:22:41,157,832 文件、48,191,819,862 字节,rclone_checksum_check、source_follow_verified,来源绑定 G 上同一代;这次没有联网重读云端(not_contacted)。PCConfig 的 core-recovery/cold-last.json 记 11 月 6 日 01:23:22—02:51:48 那一轮整体 partial(挡住的是 personal_data),wechat 集合 complete,sha256_full_tree 核验 157,832 文件、48,191,819,862 字节、修复 0,source_follow_verified_prune、0 单文件警告,清单 SHA-256 与 G 相同;回执没写这一项的结束时刻,H 上的内容这次没有再重算。
历史:11 月 4 日 15:08 核对状态与回执(Backup-Status -NoDrive -Json 零写入、退出码 0):整体 attention_required,因为当天微信上云失败;配置采集另有 5 个跳过的锁文件,微信 G 副本这一层是 current。G 微信热备 11 月 4 日 10:17:54 完成,157,674 文件、48,182,328,962 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,当时只读取、没有重新散列原文件。微信 Drive 成功回执 11 月 3 日 12:10:47,157,403 文件、48,171,565,186 字节,rclone_checksum_check、source_follow_verified,来源绑定 11 月 3 日 10:25:56 那一代 G 热备;当时没有联网重读云端(not_contacted)。15:08 另读 G/H 清单:同 run_id=cd2285a15e784719a1d3e25da3b92f88、同 content_sha256=e366230f48c268cd97cd2f211357337b7b9b58b6b8fd9d4e6b38ca55a0310958,H 清单也记 157,674 文件、48,182,328,962 字节。当时未逐文件重算 G/H,也没有另取 H 子项完成回执;G 清单生成时刻不能当 H 完成时刻。PCConfig 当天 14:30 新一轮当时还在运行。再上一份已结束的整轮证据:core-recovery/cold-last.json 记 11 月 3 日 16:03:21—17:53:13 那一轮整体 partial(挡住的是文档与本地存档、个人媒体),wechat 集合 complete,157,403 文件,source_follow_verified_prune、0 单文件警告;没有在 H 上重算全树内容。
  • 9 月 18 日历史 Hot 为 145,307 文件、45,218,959,121 字节,当时 PCConfig 对 G/H 全量验真并修复 53 个同大小/时间的冷备差异;9 月 22 日 145,473 文件、45,413,770,744 字节,9 月 24 日 145,544 文件、45,422,871,529 字节,9 月 28 日 146,300 文件、45,603,489,818 字节,都保留原日期。北京时间 10 月 11 日 09:30—11:02 的自然运行在 G 盘生成 148,592 文件、45,972,129,496 字节的一代,生产者报告 VSS 与全树验真、无警告。H 盘(历史):10 月 12 日 05:40 回读 PCConfig 10 月 11 日 18:39:26 的冷备记录,H 微信完成 148,592 文件、45,972,129,496 字节,sha256_full_tree 全树核对,修复 16 个文件,0 文件警告,清单哈希与 G 当时的回执一致;这是冷备生产者当时的验真,当时只读取、没有重算。热维护和冷备两份回执引用同一个恢复上下文编号;整次冷备结果为 complete_with_warnings,警告来自其他集合,微信集合本身是 complete。
  • 历史:10 月 30 日 11:11 的 Backup-Status -NoDrive -Json(零写入,退出码 0):整体 attention_required,原因在配置包过期,微信这一层是 current。当时的 G 微信热备(10 月 30 日 10:10:50 完成)是 156,448 文件、48,064,272,633 字节,verification=producer_verified_manifest_bound、capture_consistency=vss_crash_consistent、无文件警告;这是生产者的验真,当时只读取、没有重新散列原文件。10 月 30 日 11:00 开始的微信上云在读状态时仍是 running,不算已完成,也不是失败;Drive 当时 not_contacted,没有联网重读云端。PCConfig 正式默认的 core-recovery/cold-last.json 记 10 月 29 日 14:30—18:06 那一轮整体 partial(配置项因来源过旧被挡),wechat 集合 complete,156,156 文件、48,037,548,152 字节,sha256_full_tree;那是早于 30 日 G 这一份的另一代,G 的数字和日期不能借给 H,旧的单项冷备回执也不能覆盖当时那份总批次。
  • 历史:10 月 23 日 10:28 的 Backup-Status -NoDrive -Json(零写入,退出码 0):整体 receipts_current。10 月 23 日 10:16:05 那次 G 微信热备完成,154,912 文件、46,826,139,227 字节,collection complete、sha256_full_tree、source_follow_verified、无文件警告;这是生产者的验真,当时只读取、没有重算。本机最近一次微信上云记录是 10 月 22 日 11:00—12:10:58 drive=complete,上传来源是上一代(22 日 10:14:14 那份 G 热备,gate passed);23 日 10:16:05 这一代还没有上云记录;Drive 当时 not_contacted,没有联网重读云端。PCConfig 冷备当时没有新读:10 月 22 日 06:47 读到的 core-recovery/cold-last.json 记 10 月 21 日 16:47:54 那一轮整体 complete_with_warnings、20 个集合没有 blocked,wechat 集合 complete,警告来自密码中心那一项 H 落后 G 和四个来源新鲜度 unknown;那一轮早于现在这一代。
  • 历史:10 月 20 日 07:41 的 Backup-Status -NoDrive(零写入):微信 verification=unknown,reason=backup_tree_transaction_pending。10 月 19 日 09:30 启动的热备尝试回执仍是 running,计划任务上次结果 125;当天 11:00 上云失败,原因相同。G 上最近的成功回执仍记 10 月 18 日 10:14,153,226 文件、46,623,230,809 字节,但事务门没放行前不能凭这份旧回执说当前完整。微信 Drive 最近成功为 10 月 12 日 12:18,148,878 文件、46,034,606,676 字节,完整原应用数据、经 rclone 校验(不含有文件警告的文件)。PCConfig 10 月 19 日 14:30:11 冷备 status=blocked、reason=required_backup_freshness_not_ready:wechat,H 写入状态 unknown_no_complete_receipt。当时没有修复事务、启动备份或改 PCConfig。10 月 12 日那次状态曾显示微信 Drive 最近成功为 10 月 5 日 12:17,147,560 文件、45,777,553,213 字节。没有读取聊天内容、访问云端或把生产者此前验真冒充这次重新计算。
  • 云端最后成功采用本机已有回执;网页没有重列微信远端对象、执行 rclone check 或登录客户端。
与其他模块的关系

把体积大、变化快的微信原应用目录从配置包里拆出来单独维护;热备结果再用有界回执交给 PCConfig 判断冷备前置条件。

数字截至 2026 年 11 月 6 日

复制 AI 续作说明

项目:微信先形成验真副本,再让热备、云端跟随实际原件集合;仓库:wlyaaaaa/devconfig-backup;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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