Codex会话内容去重、点校验与 H 冷备
现在
常用 · 回执核对 11 月 6 日 13:48
G 是 11 月 6 日 12:29 新一份,H 还是 11 月 5 日 12:30 那一份,差一天正常
只读回执,未重新散列全部对象或演练恢复
截至 11 月 6 日 · G、H 备份回执

相同内容只存一份,每个历史点保留自己的文件清单;H 盘每天另行跟进并独立校验,避免复制了指针却没有完整对象。个别文件被挡住时,H 宁可先保留旧的完整点,也不拿缺文件的点冒充完整。

当前情况:2026 年 11 月 6 日 13:48 核对,G 是 11 月 6 日 12:29 完成的新一份(15,289 个文件、36.7 GB),H 还是 11 月 5 日 12:31 那一份(15,095 个文件、36.5 GB,11 月 6 日 02:13 跟上);两边都读回核对完成、没有文件警告、各留 2 点。H 每天 14:30 或登录时才跟进,同步之前差一天正常。10/19 那份 H 曾没跟上、停在 10/18,原因没查清,保留历史。这次只读回执,没有重新算全部哈希,也没有演练恢复。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

Codex会话内容去重、点校验与 H 冷备
现在
常用 · 回执核对 11 月 6 日 13:48
G 是 11 月 6 日 12:29 新一份,H 还是 11 月 5 日 12:30 那一份,差一天正常
只读回执,未重新散列全部对象或演练恢复
截至 11 月 6 日 · G、H 备份回执

相同内容只存一份,每个历史点保留自己的文件清单;H 盘每天另行跟进并独立校验,避免复制了指针却没有完整对象。个别文件被挡住时,H 宁可先保留旧的完整点,也不拿缺文件的点冒充完整。

当前情况:2026 年 11 月 6 日 13:48 核对,G 是 11 月 6 日 12:29 完成的新一份(15,289 个文件、36.7 GB),H 还是 11 月 5 日 12:31 那一份(15,095 个文件、36.5 GB,11 月 6 日 02:13 跟上);两边都读回核对完成、没有文件警告、各留 2 点。H 每天 14:30 或登录时才跟进,同步之前差一天正常。10/19 那份 H 曾没跟上、停在 10/18,原因没查清,保留历史。这次只读回执,没有重新算全部哈希,也没有演练恢复。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

这项功能怎样使用

用途与实际影响

为什么需要它

同一个附件没必要在每份会话备份里重存;但变动的数据库仍会占新空间。冷盘上的点要自己通过核对,才算一份独立副本;只拿到一部分文件时,也得把范围说清楚。

举个实际例子

两份对话都用过同一张图片,G 盘只存一份。10/11 这次 G 新写 19.5 GB、复用 19.8 GB。H 盘下午 14:30 再跟进;如果有个文件被杀毒软件挡住,H 先保留原来的完整点,等文件能读了再换新点。

最后我会得到什么

我知道 G 盘和 H 盘各自有哪一份点、哪天的、覆盖了多少文件。H 真实核对通过才称冷副本可用;如果只能保存一部分,回执会写明保存了多少、漏了多少、覆盖率多少。

这项功能怎样使用

用途与实际影响

为什么需要它

同一个附件没必要在每份会话备份里重存;但变动的数据库仍会占新空间。冷盘上的点要自己通过核对,才算一份独立副本;只拿到一部分文件时,也得把范围说清楚。

举个实际例子

两份对话都用过同一张图片,G 盘只存一份。10/11 这次 G 新写 19.5 GB、复用 19.8 GB。H 盘下午 14:30 再跟进;如果有个文件被杀毒软件挡住,H 先保留原来的完整点,等文件能读了再换新点。

最后我会得到什么

我知道 G 盘和 H 盘各自有哪一份点、哪天的、覆盖了多少文件。H 真实核对通过才称冷副本可用;如果只能保存一部分,回执会写明保存了多少、漏了多少、覆盖率多少。

结果怎么看
正常时

这一点用到的文件齐全,H 再独立核对完成,各自标成功;H 比 G 晚一天属于正常节奏。

发现问题时

普通缺失、哈希损坏或清单错误仍按失败处理。个别文件被杀毒拦截时,新点在 H 暂缓,H 保留旧完整点;连一个可读的完整点都没有时,才另存一份标明范围的“健康子集”。

入口不可用或证据不足时

H 没接上就跳过并记 H_unavailable,不影响已核对的 G 点;接上盘也不会立刻触发同步,要等既有任务下一次开始(每天 14:30 或登录时),能不能写仍看盘和核对条件。

结果怎么看
正常时

这一点用到的文件齐全,H 再独立核对完成,各自标成功;H 比 G 晚一天属于正常节奏。

发现问题时

普通缺失、哈希损坏或清单错误仍按失败处理。个别文件被杀毒拦截时,新点在 H 暂缓,H 保留旧完整点;连一个可读的完整点都没有时,才另存一份标明范围的“健康子集”。

入口不可用或证据不足时

H 没接上就跳过并记 H_unavailable,不影响已核对的 G 点;接上盘也不会立刻触发同步,要等既有任务下一次开始(每天 14:30 或登录时),能不能写仍看盘和核对条件。

从哪里开始

在已接入的 AI 对话中查询某个 Codex 会话点是否已到 G 或 H;H 冷备由 PCConfig 的既有任务处理(每天 14:30 或登录时触发)。

需要准备什么
  • 要找的点位或日期
  • G 与 H 介质状态
从开始到拿到结果
1先查 G 盘这份点是否完整
核对这一点用到的每个文件和清单;相同内容共用一份,变动的数据库要新副本。
2H 可用时再跟进
冷任务(每天 14:30 或登录时触发)复制所需对象,H 端校验完整才发布 H 指针;遇到单文件警告则保留旧完整点。
3说明真正完成到哪
H 未接时明确跳过;只保存了部分范围就写明覆盖率,指针更新但清理没做完也只报告已完成的阶段。
从哪里开始

在已接入的 AI 对话中查询某个 Codex 会话点是否已到 G 或 H;H 冷备由 PCConfig 的既有任务处理(每天 14:30 或登录时触发)。

需要准备什么
  • 要找的点位或日期
  • G 与 H 介质状态
从开始到拿到结果
1先查 G 盘这份点是否完整
核对这一点用到的每个文件和清单;相同内容共用一份,变动的数据库要新副本。
2H 可用时再跟进
冷任务(每天 14:30 或登录时触发)复制所需对象,H 端校验完整才发布 H 指针;遇到单文件警告则保留旧完整点。
3说明真正完成到哪
H 未接时明确跳过;只保存了部分范围就写明覆盖率,指针更新但清理没做完也只报告已完成的阶段。
技术实现与依据(一)

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

截至 2026-11-06 13:48:G 当前是 20261106T042141Z-ba49f855(closure_sha256 fab7d4d8…),15,289 个文件、36,686,768,485 字节(36.7 GB);G 11 月 6 日 12:29:54 完成,status=complete、readback_verified=true、文件警告 0、保留 2 点;其中新写 15,270,278,469 字节、复用 21,416,490,016 字节。H 当前还是 20261105T042159Z-19d60ba0(closure_sha256 7c908eef…),15,095 个文件、36,455,588,230 字节(36.5 GB);H 11 月 6 日 02:02:09 发布指针、02:13:01 冷备完成,status=complete、readback_verified=true、verification_scope=all_manifest_files、partial_coverage=false、覆盖 100%、文件警告 0、保留 2 点。两边差一代是正常节奏:按这次读取时的任务定义,H 每天 14:30 或登录时同步,后续结果看驾驶舱。这里只读生产回执,没有重新散列全部对象,也没有执行恢复。回执完成不等于新机恢复成功。

11 月 6 日 05:20 历史观察(当时 H 刚跟上):G、H 同为 20261105T042159Z-19d60ba0,15,095 个文件、36,455,588,230 字节;G 11 月 5 日 12:31:52 完成,新写 15,272,623,188 字节、复用 21,182,965,042 字节;H 11 月 6 日 02:13:01 冷备完成。

11 月 4 日 12:39 历史观察(当时 H 还没到同步时刻):两边不同代,G 是 20261104T042029Z-d0663831,14,787 个文件、36,268,188,420 字节(36.3 GB),11 月 4 日 12:28:35 完成,新写 15,340,349,852 字节、复用 20,927,838,568 字节;H 是 20261103T042223Z-8d50763d,14,375 个文件、36,093,155,563 字节(36.1 GB),11 月 3 日 16:36:20 发布指针、16:47:28 冷备完成。

上午历史观察(不代表午后仍同代):2026-11-04 09:18:G、H 当前同为 20261103T042223Z-8d50763d,14,375 个文件、36,093,155,563 字节。G 11/3 12:31:12 完成、回读已核对、无文件警告、保留 2 点;H 指针 11/3 16:36:20 发布,冷备 16:47:28 完成、全清单核对(all_manifest_files)、partial_coverage=false、覆盖 100%、无文件警告、保留 2 点(两边各有 2 个 cold-payload 点目录)。11/4 没有重新散列对象,也没有演练恢复。更早的读数是历史:10/30 11:21 读到两边同为 10/29 点 20261029T043532Z-e301260d,12,973 个文件、36,503,940,586 字节(G 12:58:07、H 15:58:19 完成);10/22 06:50 读到两边同为 10/21 点 20261021T041925Z-37027d1b,11,322 个文件、34,124,573,977 字节(H 指针 10/21 15:12:20 发布、冷备 15:23:15 完成);10/20 07:41 读到两边不同代:G 是 10/19 点,11,108 个文件、39,488,518,338 字节;H 停在 10/18 点(20261018T041859Z-5abb3a50),11,093 个文件、39,461,693,231 字节;10/19 那份没同步到 H,原因没查清。更早 10/12 核对时两边同为 10/11 点:10,491 个文件、39,234,419,908 字节,复用 19.8 GB、新写 19.5 GB(两个数各自四舍五入,相加 39.3 GB 与总量差 0.1 GB 是舍入)。

关键规则与设计选择
1
去重粒度是完整文件;相同字节复用,变化后的大数据库会占新空间。
2
点清单发布后正常备份不再就地修改;哈希用来发现差异,不是对所有损坏的免疫保证。
3
无警告时 G 保留当前和上一点;H 核对完 G 的有效保留集合、发布自己的指针、清掉 H 独有的旧点和对象并回读,才写 cold_retention_status=complete。
4
单文件警告时:被挡的点在 H 暂缓(current_point_deferred=true),H 不做跟随删除(cold_retention_status=deferred_file_warnings),旧完整点先保留;文件恢复后发布完整点,再按原规则清理。
5
没有任何可读完整点时,才按已核对的 G 清单在 H 另建“健康子集”:写 partial_coverage=true、verification_scope=selected_files_excluding_file_warnings、源/已存/遗漏文件数和覆盖率;不改 G 原点,不读活动目录,不拿缺对象的旧清单当完整。
6
H 不可用就跳过;接盘本身不新增即时触发。
当前怎样实现
  • 对象路径为 objects\sha256\<前两位>\<完整 64 位 SHA-256>,文件名是完整哈希。
  • 点校验核对数据结构、清单和闭包哈希、文件数和字节数,以及每个引用对象。
技术实现与依据(一)

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

截至 2026-11-06 13:48:G 当前是 20261106T042141Z-ba49f855(closure_sha256 fab7d4d8…),15,289 个文件、36,686,768,485 字节(36.7 GB);G 11 月 6 日 12:29:54 完成,status=complete、readback_verified=true、文件警告 0、保留 2 点;其中新写 15,270,278,469 字节、复用 21,416,490,016 字节。H 当前还是 20261105T042159Z-19d60ba0(closure_sha256 7c908eef…),15,095 个文件、36,455,588,230 字节(36.5 GB);H 11 月 6 日 02:02:09 发布指针、02:13:01 冷备完成,status=complete、readback_verified=true、verification_scope=all_manifest_files、partial_coverage=false、覆盖 100%、文件警告 0、保留 2 点。两边差一代是正常节奏:按这次读取时的任务定义,H 每天 14:30 或登录时同步,后续结果看驾驶舱。这里只读生产回执,没有重新散列全部对象,也没有执行恢复。回执完成不等于新机恢复成功。

11 月 6 日 05:20 历史观察(当时 H 刚跟上):G、H 同为 20261105T042159Z-19d60ba0,15,095 个文件、36,455,588,230 字节;G 11 月 5 日 12:31:52 完成,新写 15,272,623,188 字节、复用 21,182,965,042 字节;H 11 月 6 日 02:13:01 冷备完成。

11 月 4 日 12:39 历史观察(当时 H 还没到同步时刻):两边不同代,G 是 20261104T042029Z-d0663831,14,787 个文件、36,268,188,420 字节(36.3 GB),11 月 4 日 12:28:35 完成,新写 15,340,349,852 字节、复用 20,927,838,568 字节;H 是 20261103T042223Z-8d50763d,14,375 个文件、36,093,155,563 字节(36.1 GB),11 月 3 日 16:36:20 发布指针、16:47:28 冷备完成。

上午历史观察(不代表午后仍同代):2026-11-04 09:18:G、H 当前同为 20261103T042223Z-8d50763d,14,375 个文件、36,093,155,563 字节。G 11/3 12:31:12 完成、回读已核对、无文件警告、保留 2 点;H 指针 11/3 16:36:20 发布,冷备 16:47:28 完成、全清单核对(all_manifest_files)、partial_coverage=false、覆盖 100%、无文件警告、保留 2 点(两边各有 2 个 cold-payload 点目录)。11/4 没有重新散列对象,也没有演练恢复。更早的读数是历史:10/30 11:21 读到两边同为 10/29 点 20261029T043532Z-e301260d,12,973 个文件、36,503,940,586 字节(G 12:58:07、H 15:58:19 完成);10/22 06:50 读到两边同为 10/21 点 20261021T041925Z-37027d1b,11,322 个文件、34,124,573,977 字节(H 指针 10/21 15:12:20 发布、冷备 15:23:15 完成);10/20 07:41 读到两边不同代:G 是 10/19 点,11,108 个文件、39,488,518,338 字节;H 停在 10/18 点(20261018T041859Z-5abb3a50),11,093 个文件、39,461,693,231 字节;10/19 那份没同步到 H,原因没查清。更早 10/12 核对时两边同为 10/11 点:10,491 个文件、39,234,419,908 字节,复用 19.8 GB、新写 19.5 GB(两个数各自四舍五入,相加 39.3 GB 与总量差 0.1 GB 是舍入)。

关键规则与设计选择
1
去重粒度是完整文件;相同字节复用,变化后的大数据库会占新空间。
2
点清单发布后正常备份不再就地修改;哈希用来发现差异,不是对所有损坏的免疫保证。
3
无警告时 G 保留当前和上一点;H 核对完 G 的有效保留集合、发布自己的指针、清掉 H 独有的旧点和对象并回读,才写 cold_retention_status=complete。
4
单文件警告时:被挡的点在 H 暂缓(current_point_deferred=true),H 不做跟随删除(cold_retention_status=deferred_file_warnings),旧完整点先保留;文件恢复后发布完整点,再按原规则清理。
5
没有任何可读完整点时,才按已核对的 G 清单在 H 另建“健康子集”:写 partial_coverage=true、verification_scope=selected_files_excluding_file_warnings、源/已存/遗漏文件数和覆盖率;不改 G 原点,不读活动目录,不拿缺对象的旧清单当完整。
6
H 不可用就跳过;接盘本身不新增即时触发。
当前怎样实现
  • 对象路径为 objects\sha256\<前两位>\<完整 64 位 SHA-256>,文件名是完整哈希。
  • 点校验核对数据结构、清单和闭包哈希、文件数和字节数,以及每个引用对象。
技术实现与依据(二)
1
按完整文件内容算 SHA-256。
2
同哈希对象已存在且有效就复用,否则写新对象并回读。
3
生成这一点的清单和闭包,引用对象完整才更新 G 当前指针。
4
PCConfig 冷任务 AIRecoveryColdSync-Daily(现场有每日 14:30 和登录两个触发器)在 H 可用时增量复制,不直接复制 G 指针。
5
H 点核对通过才发布 H 指针,再清理 H 独有点并回读;有单文件警告则保留旧完整点或另建标明范围的健康子集,中途失败只报告实际完成的阶段。
  • Validate 只查选定的 Hot 或 Cold 点,不是全盘检查;-ReadOnly 不写进度,都不改对象;结果另带 partial、校验范围、覆盖率和单文件警告。pass 只代表所选清单范围。
  • FinalizeCold/SyncCold 核对 G 当前及有效点,复制缺的对象并独立核对 H;警告回执分开写实际 H 点和请求的 G 点。
执行流程
技术实现与依据(二)
1
按完整文件内容算 SHA-256。
2
同哈希对象已存在且有效就复用,否则写新对象并回读。
3
生成这一点的清单和闭包,引用对象完整才更新 G 当前指针。
4
PCConfig 冷任务 AIRecoveryColdSync-Daily(现场有每日 14:30 和登录两个触发器)在 H 可用时增量复制,不直接复制 G 指针。
5
H 点核对通过才发布 H 指针,再清理 H 独有点并回读;有单文件警告则保留旧完整点或另建标明范围的健康子集,中途失败只报告实际完成的阶段。
  • Validate 只查选定的 Hot 或 Cold 点,不是全盘检查;-ReadOnly 不写进度,都不改对象;结果另带 partial、校验范围、覆盖率和单文件警告。pass 只代表所选清单范围。
  • FinalizeCold/SyncCold 核对 G 当前及有效点,复制缺的对象并独立核对 H;警告回执分开写实际 H 点和请求的 G 点。
执行流程
名词和入口
本模块用到的名词
名词意思
Content-Addressed Storage(内容寻址存储)一种数据存储模式,文件的存储路径直接由其内容的哈希值决定,内容变则路径变,内容同则天然去重。
Bit Rot Defense(静默位翻转防御)长期冷备介质可能因磁性或电荷衰减导致个别位翻转,通过强制性的 SHA-256 闭包校验和可以在恢复前及时发现数据损坏。
专业定义

相同对象复用;H 没连接就明确冷备未完成

名词和入口
本模块用到的名词
名词意思
Content-Addressed Storage(内容寻址存储)
意思:
一种数据存储模式,文件的存储路径直接由其内容的哈希值决定,内容变则路径变,内容同则天然去重。
Bit Rot Defense(静默位翻转防御)
意思:
长期冷备介质可能因磁性或电荷衰减导致个别位翻转,通过强制性的 SHA-256 闭包校验和可以在恢复前及时发现数据损坏。
专业定义

相同对象复用;H 没连接就明确冷备未完成

出问题时
解决什么

减少重复文件占用,避免不完整的对象集被当成可用备份点,也避免一个被挡住的文件拖垮整条冷备。

边界
  • 无警告时固定保留两点;有警告时为了保住完整旧点,可能暂时多于两点,不能说任何情况下都恰好两点。
  • 健康子集的“完成”只代表它写明的那部分范围;零个健康文件时也明确写 0。
  • 指针已更新本身不证明后续清理完成。
失败与恢复
情况
怎么办
H 不可用
冷任务记录 H_unavailable 并跳过;只读检查不代替任务回执。
点或对象哈希不符、普通缺失
返回 point_closure_invalid、content_object_invalid 等错误,不发布成功指针。
个别文件被杀毒拦截
新点在 H 暂缓,保留旧完整点;没有完整点时另建健康子集并写明覆盖率。
文件恢复可读
下次发布完整点,回到全清单核对,并按原规则清理派生点。
出问题时
解决什么

减少重复文件占用,避免不完整的对象集被当成可用备份点,也避免一个被挡住的文件拖垮整条冷备。

边界
  • 无警告时固定保留两点;有警告时为了保住完整旧点,可能暂时多于两点,不能说任何情况下都恰好两点。
  • 健康子集的“完成”只代表它写明的那部分范围;零个健康文件时也明确写 0。
  • 指针已更新本身不证明后续清理完成。
失败与恢复
情况
怎么办
H 不可用
冷任务记录 H_unavailable 并跳过;只读检查不代替任务回执。
点或对象哈希不符、普通缺失
返回 point_closure_invalid、content_object_invalid 等错误,不发布成功指针。
个别文件被杀毒拦截
新点在 H 暂缓,保留旧完整点;没有完整点时另建健康子集并写明覆盖率。
文件恢复可读
下次发布完整点,回到全清单核对,并按原规则清理派生点。
依据与来源
真实入口
tools\Invoke-CodexConversationBackup.ps1
内容寻址对象写入、闭包校验、冷备与单文件警告逻辑
CONVERSATION_BACKUP.md
对话冷热备架构、存储规范和“单文件告警与可恢复点”说明
tools\test-codex-conversation-backup.ps1
对象去重、清单原子切换与校验测试
如何验证
  • 当前(2026-11-06 13:48 只读):G 指向 11 月 6 日的 20261106T042141Z-ba49f855,12:29:54 完成;H 还指向 11 月 5 日的 20261105T042159Z-19d60ba0,11 月 6 日 02:13:01 完成,closure_sha256 不同,差一代是正常节奏;各自与自己的指针和回执相符;均为生产者回执加指针和清单元数据,没有做全对象核对、执行冷同步或演练恢复。
  • 新增故障路径(10/1 起)有专用合成测试:test-conversation-file-warnings.ps1、test-conversation-cold-file-warnings.ps1、test-conversation-cold-partial-point.ps1;只看过定义、没有执行。
  • 历史:9 月 7 日三个人工点去重与恢复测试通过;2026-09-12 13:41(北京时间)G/H 同为 20260912T041508Z-8cec9794,7,167 个文件、49,655,464,859 字节,H 冷备 13:22:41 完成;9 月 14 日桌面 G/H 同点、两点保留收敛。这些都是历史,之后未重新核对。
与其他模块的关系

负责会话点的存储与核对;PCConfig 负责跨盘调度。次机配置档另有明确的有界清理。

依据与来源
真实入口
tools\Invoke-CodexConversationBackup.ps1
内容寻址对象写入、闭包校验、冷备与单文件警告逻辑
CONVERSATION_BACKUP.md
对话冷热备架构、存储规范和“单文件告警与可恢复点”说明
tools\test-codex-conversation-backup.ps1
对象去重、清单原子切换与校验测试
如何验证
  • 当前(2026-11-06 13:48 只读):G 指向 11 月 6 日的 20261106T042141Z-ba49f855,12:29:54 完成;H 还指向 11 月 5 日的 20261105T042159Z-19d60ba0,11 月 6 日 02:13:01 完成,closure_sha256 不同,差一代是正常节奏;各自与自己的指针和回执相符;均为生产者回执加指针和清单元数据,没有做全对象核对、执行冷同步或演练恢复。
  • 新增故障路径(10/1 起)有专用合成测试:test-conversation-file-warnings.ps1、test-conversation-cold-file-warnings.ps1、test-conversation-cold-partial-point.ps1;只看过定义、没有执行。
  • 历史:9 月 7 日三个人工点去重与恢复测试通过;2026-09-12 13:41(北京时间)G/H 同为 20260912T041508Z-8cec9794,7,167 个文件、49,655,464,859 字节,H 冷备 13:22:41 完成;9 月 14 日桌面 G/H 同点、两点保留收敛。这些都是历史,之后未重新核对。
与其他模块的关系

负责会话点的存储与核对;PCConfig 负责跨盘调度。次机配置档另有明确的有界清理。

复制 AI 续作说明

项目:Codex会话内容去重、点校验与 H 冷备;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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