

DevConfig Backup · 功能说明
既不做整机镜像,也不为了追求漂亮的小数字漏掉有用状态。软件清单负责重新下载,恢复包负责保留难以重建的部分。
当前情况:清单共 70 个文件和目录来源,其中 6 条必需;正在用的配置数据库会先做一份一致副本再进包。必需来源读不到、来源一直在变或数据库副本失败都会让这次失败并保留旧包,10 月 11 日中午和 10 月 29 日中午都是一个数据库副本超时;个别文件扫描后消失只记警告。现在的成功包是 11 月 6 日 12:16 做成的(10,038 个文件、461.1 MiB),本机和 G 都是最新,5 个数据库副本都做成了;这次采集有 1 个被占用的锁文件没收进去,所以不能说所有来源都完整。软件安装本体和明确排除内容仍不在包内。
项目快照核对于 2026-11-06 13:51(北京时间),只读了零写入状态入口和回执,没有重跑、没有重新解包或重算哈希;具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

DevConfig Backup · 功能说明
既不做整机镜像,也不为了追求漂亮的小数字漏掉有用状态。软件清单负责重新下载,恢复包负责保留难以重建的部分。
当前情况:清单共 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 清单;日常由备份任务按清单执行。
- 要保留的软件设置或密钥类别
- 是否需要换机恢复


在已接入的 AI 对话中说明要保护哪些难重建设置,要求检查 DevConfig 清单;日常由备份任务按清单执行。
- 要保留的软件设置或密钥类别
- 是否需要换机恢复


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

这里保留实现、关键条件、精确入口、历史记录和验证结果。
当前成功代是 11 月 6 日 12:16 的 483,495,780 字节包(10,038 个文件,11 月 6 日 13:51 只读),本地/G 都是 current,这次采集跳过 1 个被占用的锁文件;10 月 29 日和 10 月 11 日都因数据库副本超时失败、各自保留前一个成功代;9 月 18 日旧包验真仍是历史,应用恢复另验
数字截至 2026 年 11 月 6 日

- 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,不递归收整个数据树。


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




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

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



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

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


- 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 与私钥误提交至开源仓库。


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








