按清单保留难重建资产,每份恢复包都能核对来源和完整性
现在
常用 · 回执核对 11 月 6 日 13:51
最新一次采集跳过 1 个被占用的锁文件
截至 11 月 6 日 · 项目仓库和备份回执

既不做整机镜像,也不为了追求漂亮的小数字漏掉有用状态。软件清单负责重新下载,恢复包负责保留难以重建的部分。

当前情况:清单共 70 个文件和目录来源,其中 6 条必需;正在用的配置数据库会先做一份一致副本再进包。必需来源读不到、来源一直在变或数据库副本失败都会让这次失败并保留旧包,10 月 11 日中午和 10 月 29 日中午都是一个数据库副本超时;个别文件扫描后消失只记警告。现在的成功包是 11 月 6 日 12:16 做成的(10,038 个文件、461.1 MiB),本机和 G 都是最新,5 个数据库副本都做成了;这次采集有 1 个被占用的锁文件没收进去,所以不能说所有来源都完整。软件安装本体和明确排除内容仍不在包内。

项目快照核对于 2026-11-06 13:51(北京时间),只读了零写入状态入口和回执,没有重跑、没有重新解包或重算哈希;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

按清单保留难重建资产,每份恢复包都能核对来源和完整性
现在
常用 · 回执核对 11 月 6 日 13:51
最新一次采集跳过 1 个被占用的锁文件
截至 11 月 6 日 · 项目仓库和备份回执

既不做整机镜像,也不为了追求漂亮的小数字漏掉有用状态。软件清单负责重新下载,恢复包负责保留难以重建的部分。

当前情况:清单共 70 个文件和目录来源,其中 6 条必需;正在用的配置数据库会先做一份一致副本再进包。必需来源读不到、来源一直在变或数据库副本失败都会让这次失败并保留旧包,10 月 11 日中午和 10 月 29 日中午都是一个数据库副本超时;个别文件扫描后消失只记警告。现在的成功包是 11 月 6 日 12:16 做成的(10,038 个文件、461.1 MiB),本机和 G 都是最新,5 个数据库副本都做成了;这次采集有 1 个被占用的锁文件没收进去,所以不能说所有来源都完整。软件安装本体和明确排除内容仍不在包内。

项目快照核对于 2026-11-06 13:51(北京时间),只读了零写入状态入口和回执,没有重跑、没有重新解包或重算哈希;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

安装包和插件大多还能重下,私人设置、密钥和终端连接记录更难重建。清单优先保留这些材料;它是供换机时逐项选择的包,不是一键覆盖新电脑。

举个实际例子

我说“重装时别把十几 G 插件都打进去,但密钥和设置不要漏”:清单保留难重建资产、导出可重装软件列表;必需来源不可读直接失败,可选来源未安装则明确记缺席,正在用的 AI 工具数据库先取一份一致副本再收。

最后我会得到什么

得到带日期和完整性清单的配置包、要重新安装的软件列表、哪些来源没有收入,以及哪些文件只记了警告。包可能包含凭据,只能保存在可信介质;恢复前按清单确认所选副本的来源范围。

这项功能怎样使用

用途与实际影响

为什么需要它

安装包和插件大多还能重下,私人设置、密钥和终端连接记录更难重建。清单优先保留这些材料;它是供换机时逐项选择的包,不是一键覆盖新电脑。

举个实际例子

我说“重装时别把十几 G 插件都打进去,但密钥和设置不要漏”:清单保留难重建资产、导出可重装软件列表;必需来源不可读直接失败,可选来源未安装则明确记缺席,正在用的 AI 工具数据库先取一份一致副本再收。

最后我会得到什么

得到带日期和完整性清单的配置包、要重新安装的软件列表、哪些来源没有收入,以及哪些文件只记了警告。包可能包含凭据,只能保存在可信介质;恢复前按清单确认所选副本的来源范围。

结果怎么看
正常时

清单列出的必需配置都能读取,排除的安装本体、插件和缓存没有混入;采集结束再次核对来源范围和逐文件完整性后,才交回可选择恢复的这一代配置包与软件补齐清单。每个文件各自核对,不声称整包来自同一时刻。

发现问题时

来源集合在采集中有增删,就在新的候选里整轮重采,默认最多 3 轮,用完仍在变才失败并保留旧包;单个文件扫描后消失或被杀毒软件拦下,记成警告,警告文件不算进这一代的完整性承诺;文件读完后又被应用修改会单列说明。

入口不可用或证据不足时

必需磁盘或软件配置不可读、数据库一致副本做不出来、包或清单无法核对时,保留上次成功包并说明本轮不能形成新版本;可选软件未安装则记录缺席,不用空目录冒充已经备份。

结果怎么看
正常时

清单列出的必需配置都能读取,排除的安装本体、插件和缓存没有混入;采集结束再次核对来源范围和逐文件完整性后,才交回可选择恢复的这一代配置包与软件补齐清单。每个文件各自核对,不声称整包来自同一时刻。

发现问题时

来源集合在采集中有增删,就在新的候选里整轮重采,默认最多 3 轮,用完仍在变才失败并保留旧包;单个文件扫描后消失或被杀毒软件拦下,记成警告,警告文件不算进这一代的完整性承诺;文件读完后又被应用修改会单列说明。

入口不可用或证据不足时

必需磁盘或软件配置不可读、数据库一致副本做不出来、包或清单无法核对时,保留上次成功包并说明本轮不能形成新版本;可选软件未安装则记录缺席,不用空目录冒充已经备份。

从哪里开始

在已接入的 AI 对话中说明要保护哪些难重建设置,要求检查 DevConfig 清单;日常由备份任务按清单执行。

需要准备什么
  • 要保留的软件设置或密钥类别
  • 是否需要换机恢复
从开始到拿到结果
1确定真正要留什么
系统按来源清单选配置、私钥和导出清单,排除可重下的大型安装物和缓存。
2形成可核对的恢复包
必需来源缺失、来源持续变化或数据库副本失败就不发布本轮;成功包附文件清单和完整性校验,并列出只记警告的文件,便于换机时确认拿到的是同一份材料。
3拿到选择依据
交回哪些资料已被这代包含、哪些没包含;恢复时按需取用,不把包直接整机覆盖。
从哪里开始

在已接入的 AI 对话中说明要保护哪些难重建设置,要求检查 DevConfig 清单;日常由备份任务按清单执行。

需要准备什么
  • 要保留的软件设置或密钥类别
  • 是否需要换机恢复
从开始到拿到结果
1确定真正要留什么
系统按来源清单选配置、私钥和导出清单,排除可重下的大型安装物和缓存。
2形成可核对的恢复包
必需来源缺失、来源持续变化或数据库副本失败就不发布本轮;成功包附文件清单和完整性校验,并列出只记警告的文件,便于换机时确认拿到的是同一份材料。
3拿到选择依据
交回哪些资料已被这代包含、哪些没包含;恢复时按需取用,不把包直接整机覆盖。
技术实现与依据(一)

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

当前成功代是 11 月 6 日 12:16 的 483,495,780 字节包(10,038 个文件,11 月 6 日 13:51 只读),本地/G 都是 current,这次采集跳过 1 个被占用的锁文件;10 月 29 日和 10 月 11 日都因数据库副本超时失败、各自保留前一个成功代;9 月 18 日旧包验真仍是历史,应用恢复另验

关键规则与设计选择
1
当前本地/G 成功包为 11 月 6 日 12:16:02 本机、12:16:05 G 完成的那一代(北京时间,devconfig-20261105-211440-97ace87f.zip),483,495,780 字节(约 461.1 MiB),回执 10,038 个文件,原始字节数这次没有读,无文件警告;11 月 6 日 13:51 零写入状态入口读到两层都是 current,生产者已核对,状态入口没有重算哈希。这次采集(12:05:02—12:16:12)是 complete_with_skipped_files,跳过 1 个被占用的锁文件,所以包回执的 complete 只对已收录的文件成立;5 个数据库一致副本都 integrity_check=ok;逐文件一致不等于同一时点快照,也没有做应用恢复。11 月 6 日 05:30 读到的是前面的一代:01:47:41 本机、01:47:43 G 完成,483,162,505 字节(约 460.8 MiB),10,018 个文件,当时也跳过 1 个被占用的锁文件。11 月 4 日 12:39 读到的是更早的一代:11 月 4 日 12:19:33 本机、12:19:35 G 完成,481,660,055 字节(约 459.3 MiB),9,942 个文件,当时跳过 5 个被占用的锁文件。10 月 30 日 11:11 读到的是更早的一代:10 月 27 日 12:08:58 本机、12:09:04 G 完成,455,582,743 字节(约 434.5 MiB),6,364 个文件,当时两层都是 stale(超过 36 小时没有更新);此前 10 月 29 日 12:05–12:41 的采集因数据库副本超时失败(backup_sqlite_capture_failed),没有发布新包。10 月 23 日核对时的成功包是 devconfig-20261021-230914-6ea337d3.zip(北京时间 10 月 22 日 12:09 生成),449,631,558 字节(约 428.8 MiB),回执记 6,344 个文件、那一代没给原始字节数,无文件警告。10 月 11 日核对时的成功包是 10 月 10 日 12:12 生成的那代:299,791,772 字节(约 286.0 MiB),6,270 个文件、原始 942,360,581 字节。9 月 18 日旧包隔离恢复曾解出 8,640 文件共 8,531,705,353 字节并逐文件核对,不能拿旧恢复验收证明新包恢复通过。压缩包、解包范围与应用恢复分别说明。
2
PowerToys 只取 AppData\Local 下的设置,坚决不取安装本体(早期选型时设置约 1.3 MB、安装本体 843 MB,之后未重新核对)。
3
JetBrains 剔除 plugins 与 jdbc-drivers 目录,通过导出 txt 清单实现重装自动下载(早期选型时这两个目录约 10.6 GB,之后未重新核对)。
4
Docker 仅备份 CLI(命令行工具)config.json、contexts 与 Desktop 小配置,坚决排除动辄几十 GB 的 docker_data.vhdx 磁盘镜像和容器运行态。
5
FinalShell 只取 conn\ 会话,PixPin 只取 Config 和 LocalStorage、剔除截图历史,Clash 剔除规则数据库(早期选型时约 34 MB,之后未重新核对);10 月 7 日起新增 FlyingBird 的四项设置和数据库。
6
AI 聊天历史默认排除;-IncludeHistory 只撤掉“历史”这一类排除,不撤掉精确排除,所以 Codex 的附件、线程备份、生成图片和 Antigravity CLI 的对话、知识库等即使开了也不进包。自动任务不传这个开关。Claude 只备配置,对话和项目记忆不备;OpenClaw 已从来源里移出。
7
实际备份包包含部分明文凭据和不可轮换的 GPG 私钥;它与公开脚本仓库是两件事,恢复和介质保护要按材料类型处理。
8
提交前由 Assert-NoBackupArtifacts.ps1 检查 Git 文件候选的目录、扩展名和已知数据库路径;它不替代对任意源码正文的秘密检查。它属于 9 月 18 日历史上全部通过的那批脚本,这次没有运行。
技术实现与依据(一)

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

当前成功代是 11 月 6 日 12:16 的 483,495,780 字节包(10,038 个文件,11 月 6 日 13:51 只读),本地/G 都是 current,这次采集跳过 1 个被占用的锁文件;10 月 29 日和 10 月 11 日都因数据库副本超时失败、各自保留前一个成功代;9 月 18 日旧包验真仍是历史,应用恢复另验

关键规则与设计选择
1
当前本地/G 成功包为 11 月 6 日 12:16:02 本机、12:16:05 G 完成的那一代(北京时间,devconfig-20261105-211440-97ace87f.zip),483,495,780 字节(约 461.1 MiB),回执 10,038 个文件,原始字节数这次没有读,无文件警告;11 月 6 日 13:51 零写入状态入口读到两层都是 current,生产者已核对,状态入口没有重算哈希。这次采集(12:05:02—12:16:12)是 complete_with_skipped_files,跳过 1 个被占用的锁文件,所以包回执的 complete 只对已收录的文件成立;5 个数据库一致副本都 integrity_check=ok;逐文件一致不等于同一时点快照,也没有做应用恢复。11 月 6 日 05:30 读到的是前面的一代:01:47:41 本机、01:47:43 G 完成,483,162,505 字节(约 460.8 MiB),10,018 个文件,当时也跳过 1 个被占用的锁文件。11 月 4 日 12:39 读到的是更早的一代:11 月 4 日 12:19:33 本机、12:19:35 G 完成,481,660,055 字节(约 459.3 MiB),9,942 个文件,当时跳过 5 个被占用的锁文件。10 月 30 日 11:11 读到的是更早的一代:10 月 27 日 12:08:58 本机、12:09:04 G 完成,455,582,743 字节(约 434.5 MiB),6,364 个文件,当时两层都是 stale(超过 36 小时没有更新);此前 10 月 29 日 12:05–12:41 的采集因数据库副本超时失败(backup_sqlite_capture_failed),没有发布新包。10 月 23 日核对时的成功包是 devconfig-20261021-230914-6ea337d3.zip(北京时间 10 月 22 日 12:09 生成),449,631,558 字节(约 428.8 MiB),回执记 6,344 个文件、那一代没给原始字节数,无文件警告。10 月 11 日核对时的成功包是 10 月 10 日 12:12 生成的那代:299,791,772 字节(约 286.0 MiB),6,270 个文件、原始 942,360,581 字节。9 月 18 日旧包隔离恢复曾解出 8,640 文件共 8,531,705,353 字节并逐文件核对,不能拿旧恢复验收证明新包恢复通过。压缩包、解包范围与应用恢复分别说明。
2
PowerToys 只取 AppData\Local 下的设置,坚决不取安装本体(早期选型时设置约 1.3 MB、安装本体 843 MB,之后未重新核对)。
3
JetBrains 剔除 plugins 与 jdbc-drivers 目录,通过导出 txt 清单实现重装自动下载(早期选型时这两个目录约 10.6 GB,之后未重新核对)。
4
Docker 仅备份 CLI(命令行工具)config.json、contexts 与 Desktop 小配置,坚决排除动辄几十 GB 的 docker_data.vhdx 磁盘镜像和容器运行态。
5
FinalShell 只取 conn\ 会话,PixPin 只取 Config 和 LocalStorage、剔除截图历史,Clash 剔除规则数据库(早期选型时约 34 MB,之后未重新核对);10 月 7 日起新增 FlyingBird 的四项设置和数据库。
6
AI 聊天历史默认排除;-IncludeHistory 只撤掉“历史”这一类排除,不撤掉精确排除,所以 Codex 的附件、线程备份、生成图片和 Antigravity CLI 的对话、知识库等即使开了也不进包。自动任务不传这个开关。Claude 只备配置,对话和项目记忆不备;OpenClaw 已从来源里移出。
7
实际备份包包含部分明文凭据和不可轮换的 GPG 私钥;它与公开脚本仓库是两件事,恢复和介质保护要按材料类型处理。
8
提交前由 Assert-NoBackupArtifacts.ps1 检查 Git 文件候选的目录、扩展名和已知数据库路径;它不替代对任意源码正文的秘密检查。它属于 9 月 18 日历史上全部通过的那批脚本,这次没有运行。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
当前怎样实现
1
Backup-DevConfig.ps1 读取 sources.psd1,初始化 staging 临时目录。
2
逐项采集用户根目录散件、SSH 会话、GPG 私钥与各 AI 工具设置;登记的活动数据库走一致副本流程。
  • sources.psd1 声明采集与排除范围:HomeDirs 等目录 19 项、单文件 17 项、AppData 33 项、Scoop persist 1 项,共 70 个来源;必需来源 6 条,系统注册表导出 3 项,计划任务名字规则 11 条(11 月 4 日按规则匹配现场是 15 个任务,其中 8 个已停用,没有打开最新包里的导出文件逐项核对;10 月 11 日匹配的是 16 个)。
  • 普通文件由 DevConfig.Sources.ps1 按清单枚举,逐个只读打开、写独立临时副本、SHA-256 核对后再放进候选;每个文件最多三次有界稳定读取。来源集合有增删就整轮重采,默认 3 轮、可设 1—10 轮,回执记录轮次、失败阶段和增删数量;同路径读完后又被修改记 changed_after_capture_count,不承诺全应用同一时点。
  • DevConfig.Sqlite.py 处理登记的活动数据库(home/.codex/*.sqlite、home/.codex/sqlite/codex.db 和 FlyingBird 的 database.sqlite):只读打开、固定一个读事务快照,用 SQLite 自带的在线备份做副本,完整性检查通过才进包;在线备份和完整性检查共用每库 120 秒硬期限,另有 30 秒无进展期限(只有待复制页数真的下降才刷新进度),宿主再给 5 秒退出余量、到 125 秒不退就终止子进程,忙或超时最多试 3 次,失败不跳过、也不退回直接复制原文件。失败回执写固定的阶段、原因、退出码和数字错误码,不输出数据库正文。这套期限是 10 月 29 日 12:05 那次超时失败(等子进程约 22.8 秒时超时)之后改的,之前是单次检查限时 15 秒、子进程 20 秒;改后已有成功采集:11 月 3 日 16:21 这次的回执记 5 个副本(home/.codex 下的 goals_1、memories_1、queue_1、state_5 和 sqlite/codex.db)全部 sqlite_online_backup、integrity_check=ok。读的是回执里的结果,没有解包或打开数据库;这一次成功不能推断以前失败的原因已根治。
  • 系统导出生成 env-user.reg, env-machine.reg 与 path-machine.txt 注册表导出,以及 Xshell、hosts 等。
  • 通过 netsh wlan export profile 自动导出全部 Wi-Fi 配置文件(含密码 XML);_manifests 目录现场执行 scoop export, winget export 与 code --list-extensions 生成软件补齐清单。
  • tests/Assert-DockerScope.ps1 验证 Docker 采集只引用 allowlist(允许清单)的配置文件与 contexts,不递归收整个数据树。
执行流程
技术实现与依据(二)
当前怎样实现
1
Backup-DevConfig.ps1 读取 sources.psd1,初始化 staging 临时目录。
2
逐项采集用户根目录散件、SSH 会话、GPG 私钥与各 AI 工具设置;登记的活动数据库走一致副本流程。
  • sources.psd1 声明采集与排除范围:HomeDirs 等目录 19 项、单文件 17 项、AppData 33 项、Scoop persist 1 项,共 70 个来源;必需来源 6 条,系统注册表导出 3 项,计划任务名字规则 11 条(11 月 4 日按规则匹配现场是 15 个任务,其中 8 个已停用,没有打开最新包里的导出文件逐项核对;10 月 11 日匹配的是 16 个)。
  • 普通文件由 DevConfig.Sources.ps1 按清单枚举,逐个只读打开、写独立临时副本、SHA-256 核对后再放进候选;每个文件最多三次有界稳定读取。来源集合有增删就整轮重采,默认 3 轮、可设 1—10 轮,回执记录轮次、失败阶段和增删数量;同路径读完后又被修改记 changed_after_capture_count,不承诺全应用同一时点。
  • DevConfig.Sqlite.py 处理登记的活动数据库(home/.codex/*.sqlite、home/.codex/sqlite/codex.db 和 FlyingBird 的 database.sqlite):只读打开、固定一个读事务快照,用 SQLite 自带的在线备份做副本,完整性检查通过才进包;在线备份和完整性检查共用每库 120 秒硬期限,另有 30 秒无进展期限(只有待复制页数真的下降才刷新进度),宿主再给 5 秒退出余量、到 125 秒不退就终止子进程,忙或超时最多试 3 次,失败不跳过、也不退回直接复制原文件。失败回执写固定的阶段、原因、退出码和数字错误码,不输出数据库正文。这套期限是 10 月 29 日 12:05 那次超时失败(等子进程约 22.8 秒时超时)之后改的,之前是单次检查限时 15 秒、子进程 20 秒;改后已有成功采集:11 月 3 日 16:21 这次的回执记 5 个副本(home/.codex 下的 goals_1、memories_1、queue_1、state_5 和 sqlite/codex.db)全部 sqlite_online_backup、integrity_check=ok。读的是回执里的结果,没有解包或打开数据库;这一次成功不能推断以前失败的原因已根治。
  • 系统导出生成 env-user.reg, env-machine.reg 与 path-machine.txt 注册表导出,以及 Xshell、hosts 等。
  • 通过 netsh wlan export profile 自动导出全部 Wi-Fi 配置文件(含密码 XML);_manifests 目录现场执行 scoop export, winget export 与 code --list-extensions 生成软件补齐清单。
  • tests/Assert-DockerScope.ps1 验证 Docker 采集只引用 allowlist(允许清单)的配置文件与 contexts,不递归收整个数据树。
执行流程

数字截至 2026 年 11 月 6 日

技术实现与依据(三)
3
实时执行注册表导出、计划任务 XML 复制与包管理器软件清单导出。
4
普通文件按清单逐个只读复制并核对 SHA-256,目录、文件和精确相对路径的排除由清单声明,过滤缓存与日志;来源集合变化就整轮重采。
5
7-Zip 检测、文件清单与成功回执闭合后才发布 current(当前状态);独立候选失败不更新指针,不因漏采把旧成功包删掉。有文件警告时回执列出警告,旧包暂不清理。
技术实现与依据(三)
3
实时执行注册表导出、计划任务 XML 复制与包管理器软件清单导出。
4
普通文件按清单逐个只读复制并核对 SHA-256,目录、文件和精确相对路径的排除由清单声明,过滤缓存与日志;来源集合变化就整轮重采。
5
7-Zip 检测、文件清单与成功回执闭合后才发布 current(当前状态);独立候选失败不更新指针,不因漏采把旧成功包删掉。有文件警告时回执列出警告,旧包暂不清理。
名词和入口
本模块用到的名词
名词意思
Data-Driven Manifest(数据驱动清单)配置规则与代码逻辑解耦,增删备份项只需修改 psd1 数据文件,不动任何执行脚本。
Signal-to-Noise Ratio(高信噪比备份)优先剔除可重建的大体积二进制与缓存,同时允许真实恢复状态随使用增长;目标不是永远维持某个包体数字。
Public Artifact Gate(公开制品门)提交前检查 Git 文件候选的已知备份目录、归档扩展名和微信数据库路径;更广的公开正文检查由网站发布门单独完成。
专业定义

安装包、插件和缓存可以再下载;配置与恢复状态按必需/可选清单采集,缺重要来源就不发一个假完整包。

名词和入口
本模块用到的名词
名词意思
Data-Driven Manifest(数据驱动清单)
意思:
配置规则与代码逻辑解耦,增删备份项只需修改 psd1 数据文件,不动任何执行脚本。
Signal-to-Noise Ratio(高信噪比备份)
意思:
优先剔除可重建的大体积二进制与缓存,同时允许真实恢复状态随使用增长;目标不是永远维持某个包体数字。
Public Artifact Gate(公开制品门)
意思:
提交前检查 Git 文件候选的已知备份目录、归档扩展名和微信数据库路径;更广的公开正文检查由网站发布门单独完成。
专业定义

安装包、插件和缓存可以再下载;配置与恢复状态按必需/可选清单采集,缺重要来源就不发一个假完整包。

出问题时

解决什么

防止将数十 GB 的 node_modules、浏览器缓存、软件本体与 Docker 磁盘镜像打进备份包,并防止把明文 API Key 与私钥误提交至开源仓库。

边界
  • 严格禁止把软件安装目录、IDE 插件二进制包、缓存与 node_modules 打进备份。
  • 严格禁止 Docker Desktop 的 VHDX 磁盘镜像、容器层与运行态进入配置包。
  • 真实备份包可能含明文凭据,但不得进入 Git;不可轮换的 GPG 私钥需要比普通可轮换 token 更谨慎地选择加密与介质。
失败与恢复
  • sources.psd1 存在语法错误或非 UTF-8 BOM 编码: PowerShell 5.1 无法解析时本轮采集停止;先修复数据文件,再重新生成包。
  • Git 暂存区中误加入了备份 zip、reg 或敏感数据库文件: Assert-NoBackupArtifacts.ps1 门禁测试失败,阻断任何提交与发布流程。
  • Docker Desktop 正在生成新的大文件或临时日志: 采集只读取明确列出的 CLI(命令行工具)/Desktop 小配置和 contexts,不递归收整个 Docker 数据树。
出问题时

解决什么

防止将数十 GB 的 node_modules、浏览器缓存、软件本体与 Docker 磁盘镜像打进备份包,并防止把明文 API Key 与私钥误提交至开源仓库。

边界
  • 严格禁止把软件安装目录、IDE 插件二进制包、缓存与 node_modules 打进备份。
  • 严格禁止 Docker Desktop 的 VHDX 磁盘镜像、容器层与运行态进入配置包。
  • 真实备份包可能含明文凭据,但不得进入 Git;不可轮换的 GPG 私钥需要比普通可轮换 token 更谨慎地选择加密与介质。
失败与恢复
  • sources.psd1 存在语法错误或非 UTF-8 BOM 编码: PowerShell 5.1 无法解析时本轮采集停止;先修复数据文件,再重新生成包。
  • Git 暂存区中误加入了备份 zip、reg 或敏感数据库文件: Assert-NoBackupArtifacts.ps1 门禁测试失败,阻断任何提交与发布流程。
  • Docker Desktop 正在生成新的大文件或临时日志: 采集只读取明确列出的 CLI(命令行工具)/Desktop 小配置和 contexts,不递归收整个 Docker 数据树。
依据与来源(一)
真实入口
  • sources.psd1: 纯数据驱动的备份源清单、必需来源、数据库登记与排除名单
  • DevConfig.Sources.ps1: 按清单枚举来源、逐文件核对复制、整轮重采和系统导出
  • DevConfig.Sqlite.py: 活动配置数据库的一致副本与完整性检查
  • _manifests/: 生成的配置包里的软件与编辑器插件导出清单目录(不是源码仓库里的文件夹)
  • tests/Assert-NoBackupArtifacts.ps1: 提交前防泄密与备份产物过滤的机械检查
  • tests/Assert-DockerScope.ps1: Docker 配置范围严格限定的自动化断言
如何验证
  • tests/Assert-NoBackupArtifacts.ps1 只检查 Git 文件候选有没有落入已知备份目录、归档/密钥容器扩展名或微信数据库路径,不证明任意文本内容零秘密。9 月 18 日它与当时 15 个检查脚本在 PowerShell 7 和 5.1 下共 30 组全部通过;现在源码里有 29 个 Assert 脚本和 1 个 Python 测试文件,本轮没有运行,不是 24 个都刚通过。
  • tests/Assert-DockerScope.ps1 验证 Docker 只走 allowlist(允许清单),不收整个 .docker 或 Docker Desktop 树。
依据与来源(一)
真实入口
  • sources.psd1: 纯数据驱动的备份源清单、必需来源、数据库登记与排除名单
  • DevConfig.Sources.ps1: 按清单枚举来源、逐文件核对复制、整轮重采和系统导出
  • DevConfig.Sqlite.py: 活动配置数据库的一致副本与完整性检查
  • _manifests/: 生成的配置包里的软件与编辑器插件导出清单目录(不是源码仓库里的文件夹)
  • tests/Assert-NoBackupArtifacts.ps1: 提交前防泄密与备份产物过滤的机械检查
  • tests/Assert-DockerScope.ps1: Docker 配置范围严格限定的自动化断言
如何验证
  • tests/Assert-NoBackupArtifacts.ps1 只检查 Git 文件候选有没有落入已知备份目录、归档/密钥容器扩展名或微信数据库路径,不证明任意文本内容零秘密。9 月 18 日它与当时 15 个检查脚本在 PowerShell 7 和 5.1 下共 30 组全部通过;现在源码里有 29 个 Assert 脚本和 1 个 Python 测试文件,本轮没有运行,不是 24 个都刚通过。
  • tests/Assert-DockerScope.ps1 验证 Docker 只走 allowlist(允许清单),不收整个 .docker 或 Docker Desktop 树。

数字截至 2026 年 11 月 6 日

依据与来源(二)
  • 北京时间 10 月 3 日 19:46—19:51 做过 AI 工具配置范围的真实修复验证,20:07 登记通过:当时的包 6,206 个文件、297,846,179 字节,Codex 记忆、扩展、技能和 Antigravity 设置都在,OpenClaw 为 0。
  • 9 月 18 日来源曾用当时配置包做独立目标解包与全树哈希核对;10 月 10 日当时的当前包仅由生产回执确认,本轮没有再解包或读取其中私人内容。
与其他模块的关系

它是备份内容的决策中枢:明显可重建的安装本体和缓存不收,真正影响恢复的配置、凭据和状态进入候选包;恢复者再按版本与兼容性挑选。

依据与来源(二)
  • 北京时间 10 月 3 日 19:46—19:51 做过 AI 工具配置范围的真实修复验证,20:07 登记通过:当时的包 6,206 个文件、297,846,179 字节,Codex 记忆、扩展、技能和 Antigravity 设置都在,OpenClaw 为 0。
  • 9 月 18 日来源曾用当时配置包做独立目标解包与全树哈希核对;10 月 10 日当时的当前包仅由生产回执确认,本轮没有再解包或读取其中私人内容。
与其他模块的关系

它是备份内容的决策中枢:明显可重建的安装本体和缓存不收,真正影响恢复的配置、凭据和状态进入候选包;恢复者再按版本与兼容性挑选。

复制 AI 续作说明

项目:按清单保留难重建资产,每份恢复包都能核对来源和完整性;仓库:wlyaaaaa/devconfig-backup;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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