用途与结果
最快了解这个项目
为什么需要它
不同AI工具把重要材料放在不同位置。只备份安装包会漏掉记忆和工作成果,整目录无差别复制又会混进缓存、登录与活动数据库。这里把实际保存范围、每层结果和恢复顺序放在一起解释,让我知道手上的副本能恢复什么,哪一部分还需官方登录、重装依赖或应用验证。
举个实际例子
我要换电脑,先把AI工作环境里重要的东西找回来。先恢复Codex配置和技能、Gemini项目清单与可读成果、Claude各项目记忆;OpenClaw配置和工作区按原来源分别回填,官方归档先恢复到新暂存目录。需要旧Codex对话时,再把选定会话点还原到空目录。最终逐个确认应用能加载、路径正确、登录有效和工作可继续,不用“文件已复制”代替全部恢复。
最后我会得到什么
得到按工具与时间区分的小型状态版本、G快照、Codex完整会话恢复点,以及OpenClaw官方归档和可检查的暂存副本。每套都说明本地、G、私有Git或H实际完成到哪里,恢复哪些文件、哪些需重新登录或重装,避免拿错版本和混合覆盖现有工作。
正常时
选中的设置、记忆或会话在相应副本中核对完整后,说明本机、G 盘、私有云或 H 盘分别到哪一步;恢复后还要看应用能不能真正使用。
发现问题时
云端失败或冷盘落后时,已经验过的本机副本仍保留;任务显示成功、文件存在或旧日期都不能单独证明新机应用可用。
入口不可用或证据不足时
某个应用来源、私有备份位置或完整恢复点缺失时,只停这一套恢复;不把另一款 AI 工具的副本混过来,也不覆盖正在使用的目录。
从哪里开始
在已接入 AI 工作区备份项目的本机 AI 对话中点名 Codex、Gemini、Claude 或 OpenClaw,并说明要检查备份还是恢复哪类材料;正式恢复先到空目录核对。
需要准备什么
- 具体应用与目标机器
- 要找的配置、项目记忆或会话
- 本地、G、H 或私有 Git 中可用的版本
从开始到拿到结果
- 1查清选中应用实际保存了什么
系统列出这次能找回的配置、项目记忆或会话,以及哪类登录和原始聊天不在备份里。
- 2选一个可验证版本
先看时间、清单、对象完整性及所在介质,网络失败与本地成功分别记录。
- 3恢复到隔离位置
先验包或点,再还原到空目录并保留目标现有内容。
- 4回到真实应用验收
核对路径、官方登录、应用加载及真实旧任务或消息;文件恢复成功只完成其中一层。
从这些需求了解功能
从一个实际问题看它怎样处理、交回什么;当前能做到哪一步和仍有哪些限制,也写在对应说明中。
项目指标与相关入口查看规模、覆盖范围和关联能力
当前项目指标
- AI工具
- Codex · Gemini · Claude · OpenClaw
- Codex对话G点
- G 当前 1,983 文件 · 9.11 GB
- 轻量调度
- 3个任务 · 4套备份
- 恢复边界
- 文件副本、登录与应用可用分开验
它负责
- 按明确清单保存 Codex 设置、技能和记忆,并核对本地、G 盘及私有仓库各自结果。
- 另存完整 Codex 会话、附件和选定状态,避免与小型设置备份混在一起。
- 让会话恢复点可逐文件验证;H 盘可用时由既有冷备任务复制并独立核对。
- 恢复会话先写到新的空目录,保留当前正在使用的 Codex。
- 使用已有自动备份任务,不再为每款 AI 工具造一套常驻服务。
- 分别保存 Gemini 可读项目成果、Claude 项目记忆、OpenClaw 设置和工作区,并写清各自不包含什么。
它不负责
- 轻量设置备份不包含登录凭据、完整原始会话和大型运行缓存。
- 完整会话备份也只覆盖明确选中的文件,不是整个应用目录的无差别复制。
- 把文件还原到空目录不会直接替换当前程序或恢复官方登录。
- 这次网页只说明已有状态,不触发新的大量备份或实际恢复。
- Gemini 不保原始聊天与媒体;Claude 云端只保项目文字记忆,不是完整应用。
- OpenClaw 日常设置副本与官方状态归档范围不同,恢复后还要另验网关和消息。
- 另一套独立密码库和最高权限恢复材料不混进 AI 工作区备份。
产品思想与设计核心
每款 AI 工具按真实范围找回
Codex 会话有专门的大文件恢复点;Gemini 和 Claude 主要保留可读项目资料;OpenClaw 的日常工作区与官方状态归档互补。缺失的登录或旧聊天不会被其他备份名称补出来。
小设置和大对话分开保存
配置、技能和项目笔记适合版本对比;正在变化的会话与数据库用独立本地恢复点。副机使用自己的备份位置,云端只保存明确选出的安全文本,不能代替完整私有配置。
历史版本留得住,当前删除也算数
需要保留的旧记忆可从历史找回;但最新备份要反映真实当前文件,不把本人已删的内容又并进来。旧版更大也不代表内容更正确。
笔记本不用台式机的备份路径
两台电脑各自确认来源磁盘、热副本、冷介质和云端位置;身份或目录重叠时停下,不能照抄另一台机器的盘符。
保留最近点,清理前先验完整
当前和前一恢复点先证明确实完整,再收起更旧且无人在用的文件;清理与新备份不能互相抢写。
备份对话时不强制退出 Codex
从同一时间点的文件副本读取已选会话,可在工作期间运行;仍会占用磁盘,也不能承诺故障前最后一秒或应用内部事务完全一致。
先在空目录验副本,再决定启用
选定恢复点先核对,再复制到独立空目录。能读旧对话、恢复配置、完成登录和启动新任务是不同结果,逐项回读。
H 盘没接上就说冷备还没完成
冷盘不可用时保留 G 盘已有结果;接上磁盘后仍要等原任务或明确同步,再核对 H 盘自己的恢复点。
成功要说清是哪一层
本地复制、G 盘文件、私有云提交、H 盘副本和应用实际恢复各有自己的时间与结果;同样内容沿用旧点可以合理,但一条绿色任务结果不能代替全部。
具体保存什么,分别放在哪里
先选 Codex、Gemini、Claude 或 OpenClaw,以及想找的设置、项目记忆还是对话;各应用只保存其清单列出的材料,登录与应用效果另验。
保存本人选定的程序设置、个人能力和笔记;不把认证凭据与庞大原始对话塞进这份小型备份。
本机、G 盘和私有仓库分别给版本;副机云端只保允许公开到该私有目标的安全文本,完整私有设置仍从本地恢复。
选择原始会话、附件与相关应用状态,从同一时间点的文件副本读取,不包含登录凭据或整个运行目录。
形成可核对的 G 盘恢复点;H 盘可用时另做冷副本,恢复先去空目录。
读取文件数量、完整性与任务最近结果,不打开私人会话正文来展示状态。
分别知道源文件、已备份文件和 H 盘当前是否可用。
保存项目清单、设置、笔记与可读成果,排除原始聊天、数据库和媒体。
换机时按项目位置回填并核对应用能否加载,登录另办。
本地/G 保存选中项目记忆目录,私有仓库只保文字笔记。
找回项目记忆;若需要其他附件先查本地副本,完整聊天与程序安装不在其中。
日常保存点名设置和工作区;官方归档按它自己的范围保存原生状态,两者不互相顶替。
先恢复到独立目录,再核对版本、登录、网关与真实消息。
项目怎样演化到现在
先保住容易丢的小文件
保存设置、规则和项目记忆,留下私有Git版本与独立G副本,避免换机只剩软件安装包。
完整对话不再混进轻量配置备份
原始会话、附件与数据库另走一致性恢复点,内容去重后保存到G/H;恢复先到空目录验证,不直接覆盖活动应用。
让各套 AI 的恢复范围说得清
不同工具仍沿独立来源和任务,云端失败不抹去已完成本地副本;轻量成果纳入Antigravity桌面/CLI(命令行工具),登录、活动程序和整机恢复继续独立验收。
完整项目状态与证据边界
已确认事实
- Codex保存小型规则/配置/记忆/技能,另有会话与数据库专线;Gemini保存配置、项目清单与Antigravity可读成果;Claude保存各项目memory目录,私有Git只选Markdown;OpenClaw保存指定配置文件与过滤后的工作区,另有官方状态归档。它们不共用一份数据清单,也不自动互相恢复。
- 9月9日22:08Z读取ai-memory.g-hot-snapshot.v1元数据:Gemini127文件/181,152字节,完成于05:10:06Z;Claude36文件/76,727字节,保存点日期8月21日05:20Z;OpenClaw186文件/2,840,710字节,保存点日期9月1日03:20Z。三份目录文件数与字节总量和manifest(清单)一致;没有重新逐字节哈希所有正文。旧点可以因内容相同而复用,不能只凭日期断言任务失败。
- Gemini=e3413caca7edbcf1ba9cf79d004ed26c080dbcbf,Claude=1fcc03dff6b0d5bbfa7c3a02a570d31308332b8e,OpenClaw=9359383c62008bc59e96d5891496b738c950a7b1;本轮本地工作树干净且远端引用同值。Claude第一次Git读取遇到TLS瞬断,随后GitHub引用接口回读成功。引用一致不等于应用恢复通过,也不证明各层载荷逐字相同。
- 定时backup-openclaw.ps1保存config与workspace;backup-config.ps1则调用官方backup create --no-include-workspace --verify,保存含私人状态的官方归档。9月3日224,287,339字节归档和暂存恢复是历史证据;没有自动激活,也没有把工作区暗算进该归档。
- 2026-09-12T04:27Z由PCConfig既有Manage-CodexDataBackup.ps1 Status -ReadOnly回读:ready,已安装来源c7e02a79b7922780eeae37a312d159319422c9ac且文件摘要匹配;09:00原定时任务Ready、最近返回0。热与USB冷点同为20260912T010007Z-79c363c0,323文件、407,005,388字节,readback_verified=true、cold_matches_hot=true。本轮读取既有元数据,未重新哈希全部对象。
- 同次Owner回读:安全层31文件、266,762字节;backup/secondary-laptop的远端引用dcff123c91b40ab9f9c6ddc5b2a5eea809325011与本地一致。它只保存安全配置投影、规则参考、记忆与自定义技能;该引用不证明云端含原始会话或全部私人配置。
- 9月10日既存pcconfig.codex-data-restore-test.v1回执为pass,来源点20260910T035042Z-acd75878:验证209个session文件、208条thread记录并重映射208个路径;隔离app-server列出139项,选定任务读到12轮,read_from_isolated_copy=true。未启动新回合、未复制凭据、未输出私人正文,探针与测试副本已清理。本轮只读该旧回执,不升级为登录或新回合续作通过。
- Codex轻量备份来源本地干净main=4934cada2be8b4baa6b395dc14a0e589eaa312f2,远端同值;相对前次正式来源,新提交只更新配置、记忆与清单等白名单载荷,备份脚本及恢复合同未改。桌面两点保留与H随G有效点收敛仍由旧实现承担;本轮未核次机安装,也未重新采集其他三套工具。
- Codex小文件规模保留2026-09-08T08:16:34Z的DryRun(试运行)观察:243文件、2,656,388字节;当时私有仓库因保留历史而有713文件、5,711,701字节。这是Codex自己的旧观察,不是四套备份总量,也不是固定容量上限。
- 2026-09-24T04:50Z 只读 G current(当前状态) 与所选 manifest(清单):点 20260924T041509Z-89eabfd3,1,983 文件、9,112,477,677 字节,指针于 04:16:22Z 发布,标注 VSS 崩溃一致性。独立源 Inspect 同时见活动源 1,989 文件、9,129,573,276 字节;活动源比恢复点多不等于捕获缺陷,两者时刻与集合不同。本轮未重哈希全部对象或恢复。9 月 18 日旧同点回读仅作历史。
- 桌面轻量备份先写当前本地/G快照并核验,再同步私有GitHub;仅桌面仓库复制启用ProtectHistory,保留指定较大raw_memories、已有rollout_summaries与backup-only历史。次机profile保存精确当前选中版本及删除,默认保留2份安全快照;云失败不抹掉已校验的新本地结果,也不推进云成功回执。
- Invoke-CodexConversationBackup.ps1 在 E:\Data\AppData\Codex 所在卷创建 VSS(卷影复制服务)时间点副本,捕获标注 vss_crash_consistent(崩溃一致性)。它减少活动文件复制时间错位,不承诺应用层事务已全部提交、零 I/O 开销或恢复到故障前最后一秒。
- 会话文件按 SHA-256(安全哈希算法 256 位)存入 CAS(内容寻址存储)对象池,单个对象按内容复用;每个点有 manifest(清单)、closure,引用对象校验通过才切换 current.json。桌面无 profile(设备配置档)Hot(热备)现在固定保留当前及前一完整点,先验证两点再清过期点与无引用对象;轻量本地与 G 快照的 30 份策略没有被本次会话改动替换。副驾驶配置档继续使用独立保留入口。内容相同的 G 快照仍复用,设备与备份类型各按自己的保留策略。
- 9月9日22:07Z只读回读:Codex Memory Backup最近05:05:02Z、Gemini Memory Backup最近05:10:01Z、共享OpenClaw Memory Backup最近05:20:01Z,均Ready/enabled/0;三个轻量任务实际承载四套备份,共享任务先Claude后OpenClaw,两段都会尝试并传播首个非零。Codex会话另有21:15日任务,最近04:15Z结果0;PCConfig冷备另行负责。调度时刻按America/Los_Angeles,运行结果时间按UTC。
- 2026-09-24T04:50Z 只读 H current(当前状态) 与所选 manifest(清单):仍为 20260923T041507Z-44b79c2e,1,928 文件、8,772,433,265 字节,H 指针于 9 月 23 日 06:49:40Z 发布并标注 cold_readback_verified=true。冷盘当前比 G 少一个捕获点;旧 H 点的回读不证明 9 月 24 日 G 点已复制到 H,本轮未同步介质或实做恢复。
当前缺口
- Codex桌面 G 当前为 9 月 24 日恢复点,H 冷盘当前为 9 月 23 日恢复点;选较新会话应先核实际介质和点。网页只读指针、选中清单与已有回执,不重新读取全部对象;任一点都不证明新机登录、应用续作或四套工具共享完整历史。
- 本轮只读脚本、任务与小元数据;Codex9月7日合成去重/隔离恢复、OpenClaw既有脚本与官方归档/暂存证据保留原日期。没有重新执行生产VSS、完整对象重验、四套工具的新机恢复或登录。
- raw_memories 大小保护仅避免较小当前文件覆盖私有仓库的大版本;同等或更大的错误正文仍需人判断,轻量 G 快照保存的是当次源内容。
- 桌面会话已实现并实际完成两点保留与无引用对象清理;H只保留G有效点引用的集合。大型数据库仍会产生变化对象,有界历史不等于无限历史或零增长。
- 会话 Restore 先生成文件副本;轻量恢复按文档把配置、记忆和技能放回运行根。两者都不自动注册服务、设置全局环境或恢复登录,新机器是否可用仍需应用层验证。
- Gemini与Claude当前没有专用自动还原器,按选定版本及原相对路径恢复文件后,仍要重新核对应用、项目路径与登录;Claude云副本仅Markdown,不能用它代替本地/G中memory目录的全部文件。
- Gemini与Claude在云同步阶段会再读当前来源,且Claude的云选择范围更窄;不能把G的SHA-256回读扩成三层同一时刻同一字节。OpenClaw云复制才明确使用已完成的本地/G快照。
- OpenClaw官方归档不含工作区;定时文件选择也不是原生状态目录全量镜像。归档校验、暂存恢复、离线激活与真实消息恢复各自验收。
来源与公开边界
这是四套现有备份的统一使用说明,保留codex-memory的既有网址。Codex源由独立PRIVATE(私有)仓库维护;Gemini、Claude和OpenClaw的现役备份脚本来自PUBLIC(公开) OpenClawGateway,它们的载荷仍进入各自私有目标。页面不复制真实记忆、会话、账号、令牌或备份正文;组合展示不迁移或合并源仓库。
当前关键技术事实
- 四套工具各保存什么
- Codex保存小型规则/配置/记忆/技能,另有会话与数据库专线;Gemini保存配置、项目清单与Antigravity可读成果;Claude保存各项目memory目录,私有Git只选Markdown;OpenClaw保存指定配置文件与过滤后的工作区,另有官方状态归档。它们不共用一份数据清单,也不自动互相恢复。
- Gemini、Claude与OpenClaw的G快照
- 9月9日22:08Z读取ai-memory.g-hot-snapshot.v1元数据:Gemini127文件/181,152字节,完成于05:10:06Z;Claude36文件/76,727字节,保存点日期8月21日05:20Z;OpenClaw186文件/2,840,710字节,保存点日期9月1日03:20Z。三份目录文件数与字节总量和manifest(清单)一致;没有重新逐字节哈希所有正文。旧点可以因内容相同而复用,不能只凭日期断言任务失败。
- 三套私有Git引用回读
- Gemini=e3413caca7edbcf1ba9cf79d004ed26c080dbcbf,Claude=1fcc03dff6b0d5bbfa7c3a02a570d31308332b8e,OpenClaw=9359383c62008bc59e96d5891496b738c950a7b1;本轮本地工作树干净且远端引用同值。Claude第一次Git读取遇到TLS瞬断,随后GitHub引用接口回读成功。引用一致不等于应用恢复通过,也不证明各层载荷逐字相同。
- OpenClaw两条恢复材料
- 定时backup-openclaw.ps1保存config与workspace;backup-config.ps1则调用官方backup create --no-include-workspace --verify,保存含私人状态的官方归档。9月3日224,287,339字节归档和暂存恢复是历史证据;没有自动激活,也没有把工作区暗算进该归档。
- 次机安装、自动备份与冷介质
- 2026-09-12T04:27Z由PCConfig既有Manage-CodexDataBackup.ps1 Status -ReadOnly回读:ready,已安装来源c7e02a79b7922780eeae37a312d159319422c9ac且文件摘要匹配;09:00原定时任务Ready、最近返回0。热与USB冷点同为20260912T010007Z-79c363c0,323文件、407,005,388字节,readback_verified=true、cold_matches_hot=true。本轮读取既有元数据,未重新哈希全部对象。
- 次机安全云支路
- 同次Owner回读:安全层31文件、266,762字节;backup/secondary-laptop的远端引用dcff123c91b40ab9f9c6ddc5b2a5eea809325011与本地一致。它只保存安全配置投影、规则参考、记忆与自定义技能;该引用不证明云端含原始会话或全部私人配置。
- 次机恢复副本已有可读证据
- 9月10日既存pcconfig.codex-data-restore-test.v1回执为pass,来源点20260910T035042Z-acd75878:验证209个session文件、208条thread记录并重映射208个路径;隔离app-server列出139项,选定任务读到12轮,read_from_isolated_copy=true。未启动新回合、未复制凭据、未输出私人正文,探针与测试副本已清理。本轮只读该旧回执,不升级为登录或新回合续作通过。
- 源版本与本轮修复
- Codex轻量备份来源本地干净main=4934cada2be8b4baa6b395dc14a0e589eaa312f2,远端同值;相对前次正式来源,新提交只更新配置、记忆与清单等白名单载荷,备份脚本及恢复合同未改。桌面两点保留与H随G有效点收敛仍由旧实现承担;本轮未核次机安装,也未重新采集其他三套工具。
- 小文件源清单
- Codex小文件规模保留2026-09-08T08:16:34Z的DryRun(试运行)观察:243文件、2,656,388字节;当时私有仓库因保留历史而有713文件、5,711,701字节。这是Codex自己的旧观察,不是四套备份总量,也不是固定容量上限。
- G 最新会话点与活动源不同
- 2026-09-24T04:50Z 只读 G current(当前状态) 与所选 manifest(清单):点 20260924T041509Z-89eabfd3,1,983 文件、9,112,477,677 字节,指针于 04:16:22Z 发布,标注 VSS 崩溃一致性。独立源 Inspect 同时见活动源 1,989 文件、9,129,573,276 字节;活动源比恢复点多不等于捕获缺陷,两者时刻与集合不同。本轮未重哈希全部对象或恢复。9 月 18 日旧同点回读仅作历史。
- 两条备份管道各自保留历史
- 桌面轻量备份先写当前本地/G快照并核验,再同步私有GitHub;仅桌面仓库复制启用ProtectHistory,保留指定较大raw_memories、已有rollout_summaries与backup-only历史。次机profile保存精确当前选中版本及删除,默认保留2份安全快照;云失败不抹掉已校验的新本地结果,也不推进云成功回执。
- 运行中的会话从 E 卷快照读取
- Invoke-CodexConversationBackup.ps1 在 E:\Data\AppData\Codex 所在卷创建 VSS(卷影复制服务)时间点副本,捕获标注 vss_crash_consistent(崩溃一致性)。它减少活动文件复制时间错位,不承诺应用层事务已全部提交、零 I/O 开销或恢复到故障前最后一秒。
- 去重、校验与保留期限
- 会话文件按 SHA-256(安全哈希算法 256 位)存入 CAS(内容寻址存储)对象池,单个对象按内容复用;每个点有 manifest(清单)、closure,引用对象校验通过才切换 current.json。桌面无 profile(设备配置档)Hot(热备)现在固定保留当前及前一完整点,先验证两点再清过期点与无引用对象;轻量本地与 G 快照的 30 份策略没有被本次会话改动替换。副驾驶配置档继续使用独立保留入口。内容相同的 G 快照仍复用,设备与备份类型各按自己的保留策略。
- 实际任务状态
- 9月9日22:07Z只读回读:Codex Memory Backup最近05:05:02Z、Gemini Memory Backup最近05:10:01Z、共享OpenClaw Memory Backup最近05:20:01Z,均Ready/enabled/0;三个轻量任务实际承载四套备份,共享任务先Claude后OpenClaw,两段都会尝试并传播首个非零。Codex会话另有21:15日任务,最近04:15Z结果0;PCConfig冷备另行负责。调度时刻按America/Los_Angeles,运行结果时间按UTC。
- H 冷盘与数据边界
- 2026-09-24T04:50Z 只读 H current(当前状态) 与所选 manifest(清单):仍为 20260923T041507Z-44b79c2e,1,928 文件、8,772,433,265 字节,H 指针于 9 月 23 日 06:49:40Z 发布并标注 cold_readback_verified=true。冷盘当前比 G 少一个捕获点;旧 H 点的回读不证明 9 月 24 日 G 点已复制到 H,本轮未同步介质或实做恢复。
完整执行流程
- 1先认工具、材料与恢复目标
确定是Codex配置/会话、Gemini可读工作成果、Claude项目记忆,还是OpenClaw配置/工作区/官方状态。读取各自来源配置和选定版本,不用统一整目录镜像。
- 2先形成可核验的本地结果
轻量当前源复制成本地/G 快照;会话先写对象、点清单和闭包,引用对象校验完成才更新 G 指针。
- 3分别收口私有云与冷盘
轻量仓库保留历史后 fetch 检查分支,再 commit/push 并 ls-remote 回读;冷盘由现有 PCConfig 任务复制和 H 独立校验,离线则跳过。
- 4需要时恢复文件副本
指定 PointId 与空 DestinationRoot;先完整校验点,再还原文件并回读。当前应用不被替换。
- 5按各自方式回填并验应用
Codex会话与OpenClaw官方归档先恢复独立副本;其余小文件按原相对路径选择性回填。先保留当前文件,再核对项目路径、依赖、官方登录、配置加载和一次真实工作结果。
本页用到的名词
需要核对专业含义时,可以在这里查看它在 AI 工作区备份与恢复 项目中的具体用法。
- VSS(卷影复制服务)
- 从一个数据卷的时间点副本读取正在变化的文件,减少跨文件复制时点不一致。
- vss_crash_consistent(崩溃一致性)
- 捕获标记描述类似异常停机时可见的磁盘状态;不代表应用已完成所有事务,恢复后仍可能需要数据库自身恢复和应用验收。
- CAS(内容寻址存储)
- 按文件内容的 SHA-256 定位对象,相同内容复用,不同内容保留新对象。
- 小文件不覆盖大文件
- 桌面无profile路径仅对私有仓库memories/raw_memories.md实施大小保留;次机配置档保存当前选中版本。这不是所有文件、备份层的通用完整性保证。
- fail-closed(失败关闭)
- Git 远端状态不满足同步条件或点校验失败时停止相应动作,不强推或发布未经核验的指针。
- BitLocker(Windows 驱动器加密技术)
- 本项目要求 G 是已登记、已解锁且完整加密的备份卷;磁盘加密与文件是否备份成功分别核验。
系统里实际有什么
下面是当前产品组件,不是概念分类。每一项都对应真实文件、入口或验证链。
轻量白名单、历史保留与私有 Git 同步
Resolve-CodexMemorySource 解析物理根;Copy-SelectedFiles 的 ProtectHistory 只用于仓库副本;Get-GitMainSyncState 检查 behind/diverged(本地与远端双向分叉),Sync-GitMain 推送已超前提交并 ls-remote 回读。
当前小文件快照与 G 回读
Publish-GHotSnapshot计算清单与SHA-256,复用相同快照并更新ai-memory.g-hot-current.v1指针;桌面保留30份,次机配置档保留当前及前一份。先完成并核对本地热快照,再尝试云端同步。
会话快照、对象池、点校验和文件恢复
以 8MB 缓冲区读取对象;VSS 精确绑定登记 E 卷;Write-AtomicBytes 写穿并原子替换元数据,Test-CodexConversationPoint 校验清单、闭包、每个独有对象。
会话日任务计划、安装和规格回读
Plan/Inspect 暴露实际规格;会话任务每日 21:15、Highest,经 wscript.exe 隐藏启动。轻量日任务每日 20:05/22:05 以普通权限运行。
本地回归验证
覆盖轻量源清单、G 快照、Git 超前/落后/分叉/拒推/远端回退,以及三个人工点的去重与恢复、任务计划;不执行生产重备份。
读取三套现役消费者的本机路径配置
openclaw_gateway.private_backup_settings.v1;gemini_memory与claude_memory各5个键,openclaw有6个键,共16个必填路径键。OPENCLAW_PRIVATE_BACKUP_SETTINGS可覆盖本机配置位置,缺键或路径形态不成立就失败,不输出实际私有值。
三套轻量消费者的G内容回读与私有Git同步
G保存ai-memory.g-hot-snapshot.v1,逐文件长度/SHA-256核对,相同内容复用,最多30份。Git先检查main是否落后或分叉,正常push后ls-remote回读;网络/TLS错误按30/120/300/900秒有限退避,认证或状态错误不按网络重试。它与Codex独立实现同类目标,不宣称两份脚本完全相同。
当前数据合同与写读边界
sourceRoot / totalSizeBytes / files
tools/backup-codex-memory.ps1:DryRun 清单描述当次源文件;仓库 MANIFEST(清单) 描述备份仓库小文件集合。文件数和大小是观察结果,没有 2.5MB 固定上限。
ai-memory.g-hot-snapshot.v1 / ai-memory.g-hot-current.v1
tools/g-hot-snapshot.ps1:独立重新读取并核验复制结果后发布;与 Git 推送分开收口。
codex.conversation-backup.manifest.v1 / codex.conversation-backup.closure.v1
tools/Invoke-CodexConversationBackup.ps1:files 包含相对路径、length 和 sha256;闭包绑定 manifest_sha256、file_count 和 total_size_bytes,当前源 Inspect 不能代替点校验。
codex.conversation-backup.pointer.v1
G:/80_Backup/ControlPlane/AIMemory/CodexConversations/current.json:point_id、closure_sha256、published_utc、capture_semantics;9月12日05:41Z G/H均指向20260912T041508Z-8cec9794,两盘实际闭包SHA-256同为5c91d9e48222258aae5fd54d8adcdf4f37ad697fc63d21ef2710f57bb1fc7acc,清单哈希也逐盘匹配。
codex.conversation-backup.validation.v1 / codex.conversation-backup.receipt.v1 / codex.conversation-backup.progress.v1
Invoke-CodexConversationBackup.ps1:Validate读取并哈希指定Hot或Cold点;加-ReadOnly不写进度且无需提权。Restore需要-Execute与显式空目录,拒绝活动根、备份/状态根及其子目录和reparse point(重解析点);旧主机身份不是只读核验和隔离恢复的前提。
cold-payload + H current.json + cold-last.json
PCConfig AIRecoveryColdSync-Daily / 本项目 FinalizeCold:已有冷任务负责增量复制;H 上闭包与对象校验通过才发布 H 指针,不直接复制 G 指针。H 不可用不等于最新冷备完成。
codex.memory-backup.profile.v1 / codex.conversation-backup.profile.v1
backup-codex-memory.ps1 / Invoke-CodexConversationBackup.ps1;机器绑定由PCConfig管理:显式-ConfigPath绑定主机、用户、物理Codex根、独立hot/cold/state路径与卷唯一ID。轻量云支路必须为backup/<profile_id>并保持纯数据;会话profile不能同时覆盖CodexHome/HotRoot/ColdRoot/StateRoot/PCConfigManifestPath。
codex.safe-config-projection.v1 / codex.memory-backup.manifest.v1 / codex.memory-backup.receipt.v1
project-safe-codex-config.py / backup-codex-memory.ps1:Python3.11+标准库解析TOML,只保留已允许字段,未知内容仅列omitted_key_paths;残余疑似秘密使投影失败。清单保留原/备份相对路径、restore_mode、length及sha256;完整成功回执须本地热快照已核验且新读远端引用等于HEAD。
codex.conversation-backup.receipt.v1;mode=prune
Invoke-CodexConversationBackup.ps1:显式Prune需profile及-Execute,KeepPoints范围2–1000、默认2;桌面Hot在已有互斥锁内自动保留2点,不另选KeepPoints。先核验当前和保留点、标准目录形态与未变指针,再删除过期点及未引用对象;与Hot/SyncCold互斥。回执给删除点/对象数与字节,不重写current(当前状态)指针。
openclaw_gateway.private_backup_settings.v1
OpenClawGateway/tools/private-backup-settings.ps1:只定义source_root或config_root/workspace_root、snapshot_root、hot_snapshot_root、cloud_repo、log_file;真实值留在本机,不建立一个新的中央配置源。
openclaw_backup_result.v1 / openclaw_restore_stage_result.v1
OpenClawGateway/tools/backup-config.ps1 / restore-config.ps1:include_workspace=false;创建须官方verified,恢复先verify并且目标尚不存在,activation_performed=false、activation_required=true。
5 层证据分别证明什么
能证明:2026-09-24 已回读 Codex PRIVATE(私有) main=4934cada2be8b4baa6b395dc14a0e589eaa312f2,本地同值且干净;本次新提交仅更新白名单配置、记忆与清单载荷,未改备份脚本。9 月 12 日次机配置档与 9 月 14 日离线冷盘解析仍是历史实现证据;其他三套脚本保留原观察。
不能证明:源码和文档不证明本轮又执行过生产备份或应用恢复。
能证明:Codex9月7日G快照、Git分支、3点去重/隔离恢复与任务规格测试保留为历史;本轮未重跑。OpenClaw现有Gemini选择、G回读、Git同步、配置/恢复和共享启动器测试可独立复现。
不能证明:源码与合成恢复不证明四套工具已在新电脑登录、加载并继续工作。
能证明:9月9日22:07—22:08Z的3个轻量任务及Codex会话任务Ready/enabled/0、四套G元数据及当时H不可用均保留为历史。9月12日05:41Z曾补充当时桌面G/H同点7167文件;2026-09-14新回读原生回执为同点20260913T112054Z-1d51dc2b、7279文件、51104813027字节,Hot/Cold保留均complete;其他三套任务、Git引用及备份观察日期不更新,未读正文。当前指针与清单另见9月24日局部观察;未重验旧任务或全量载荷。
不能证明:未重新哈希全部生产对象,也未检测应用打开恢复内容的结果。
能证明:9月14日只读H原生cold-last:9月13日23:57:45Z complete/readback_verified=true、7279文件/51104813027字节,current(当前状态)与G同为20260913T112054Z-1d51dc2b,H有效点保留2份。9月12日05:41Z介质在场与7167文件旧点只证明当时结果;该次同点由各盘原生回执证明,不从PCConfig总回执推断。当前指针与清单另见9月24日局部观察;未重验旧任务或全量载荷。
不能证明:完整对象校验由所属时点原生冷回执报告;网页本轮只回读指针和小元数据,没有重读全部对象,也不证明新机器登录、应用恢复或新回合续作。
能证明:OpenClaw旧官方归档已校验且曾恢复到新暂存目录;Codex旧合成点可隔离还原。
不能证明:未完成本轮OpenClaw离线激活或四套工具的新机应用验收;登录、真实消息和原会话续接不由文件存在推断。
维护入口
按 README.md 的 Restore 说明,将选定私有仓库版本中的小文件按原相对路径复制到实际 CODEX_HOME(当前 E:\Data\AppData\Codex);排除 .git、tools、.local-snapshots、logs恢复轻量配置、记忆和技能:例如 config.toml 回运行根、memories 回同名子目录、skills 回同名子目录。它是手工文件复制路径,不调用会话 -Mode Restore,没有那个入口的活动根拒绝规则;会改变目标文件,应先核对当前内容和版本,再核对登录、配置加载和技能是否实际可用。
pwsh -NoProfile -File .\tools\backup-codex-memory.ps1 -DryRun轻量清单预检:只列当次白名单源文件;加 -ManifestPath 可把清单写到选定位置,不提交或推送。
pwsh -NoProfile -File .\tools\backup-codex-memory.ps1轻量备份:当前源写本地/G 快照,仓库历史保留后按 Git 状态正常推送并远端回读。
pwsh -NoProfile -File .\tools\Invoke-CodexConversationBackup.ps1 -Mode Inspect -Json源盘点与点指针检查:只读输出当前源文件数/字节数、当前 G 点标识与 H 是否可用;不验证 G 对象完整性。
pwsh -NoProfile -File .\tools\Install-CodexConversationBackupTask.ps1 -Mode Inspect -Json会话任务规格:只读检查实际任务是否匹配计划及最近返回码。
pwsh -NoProfile -File .\tools\Invoke-CodexConversationBackup.ps1 -Mode Hot -Execute -Json会话热备(管理员):实际创建登记 E 卷 VSS,写入 G 点并核验;有真实磁盘与管理员副作用。
pwsh -NoProfile -File .\tools\Invoke-CodexConversationBackup.ps1 -Mode Validate -Json完整核验最新 G 点:逐一读取指定点的哈希对象;默认写本地validate-progress.json,加-ReadOnly则不写进度。可用-PayloadStore Cold选择冷副本,不因指针存在就跳过完整核验。
pwsh -NoProfile -File .\tools\Invoke-CodexConversationBackup.ps1 -Mode Restore -PointId latest -DestinationRoot <专用空目录> -Execute -Json恢复到空目录:核验点后恢复原目录与文件名,再校验结果;不切换活动应用。
pwsh -NoProfile -File .\tools\backup-codex-memory.ps1 -ConfigPath <memory-profile.json> -ReceiptPath <receipt.json>次机安全文本备份:使用机器负责人已绑定的配置档,先形成本地已验快照,再更新独立安全云支路;这是实际备份入口,网页刷新不执行。
pwsh -NoProfile -File .\tools\Invoke-CodexConversationBackup.ps1 -ConfigPath <conversation-profile.json> -Mode Validate -PayloadStore Cold -ReadOnly -Json只读核验指定冷点:逐对象哈希核对完整冷点,不写进度。恢复时可换为-Mode Restore并指定新的空目录与-Execute;不要求旧主机身份,仍须先识别真实介质路径。
在既有PCConfig入口使用SyncCold;需要明确清理时调用-Mode Prune -PayloadStore Hot|Cold -KeepPoints 2 -Execute并提供同一-ConfigPath次机冷复制与有界保留:SyncCold复制并核验G有效保留点,发布H指针并收敛H独有点/对象,最后才报告完整成功;Prune仅清理过期点和保留点不再引用的对象。两者都是实际写入,由已有机器Owner调度或精确调用,不因网页检查自动执行。
在OpenClawGateway运行pwsh -NoProfile -File tools/backup-gemini-memory.ps1 -DryRunGemini选择预检:只生成所选清单;本轮未运行该入口或读取清单中的私人文件名。
从选定本地/G快照或私有Git版本按原相对路径复制到对应来源根Gemini、Claude小文件恢复:Gemini回填选定配置和可读成果;Claude按project/memory匹配项目,非Markdown从本地/G取回。保留现有目标后再操作,登录与应用另验。
在OpenClawGateway运行pwsh -NoProfile -File tools/backup-config.ps1 -JsonOpenClaw官方归档:真实写私人归档;显式不含工作区,本轮没有执行。
在OpenClawGateway运行pwsh -NoProfile -File tools/restore-config.ps1 -From <归档> -Target <尚不存在的新目录> -JsonOpenClaw新目录暂存恢复:官方验证后只恢复暂存副本,不停止网关或自动激活。
快照怎样更新
2026-09-24只读回读:桌面G为9月24日点,H仍为9月23日点,恢复选择应按实际介质和点;当前没有执行冷同步或恢复。桌面bc574f8的Hot自动两点保留、eeb2158的H有效点收敛是较早实现,本轮轻量Git 4934cada仅更新白名单载荷。旧次机、其他三套工具、测试与恢复证据保留原日期;源文档开头的additive/no-GC旧叙述不覆盖已发布实现。
