用途与实际影响
这项功能怎样使用
为什么需要它
可读成果与原始会话不是同一类材料。把配置、笔记和工作输出保存为小文件,便于检查版本与选择性恢复;把全部应用目录当成已备份,会误以为登录和会话也能回来。
举个实际例子
我说“把Gemini和Antigravity里保存的项目说明、笔记与设置找回来”。先选本地/G快照或私有Git版本,按原目录关系复制到目标Gemini根,核对项目路径和应用加载;不会声称恢复了不在清单里的旧聊天。
最后我会得到什么
找回 Gemini 或 Antigravity 的项目清单、设置和可读笔记;回填后还要在当前应用里确认能看到。原始聊天和登录状态不在这份材料里。
正常时
选中的项目文件在本机/G 有可核对副本,私有云是否收到另算;恢复后应用确实能加载再说可用。
发现问题时
云端失败保留本机副本;保存期间来源又变化时说明几个副本并非同一时刻。
入口不可用或证据不足时
来源目录或选定私有仓库不存在时停这条线,不猜另一个账号。
从哪里开始
在已接入的 AI 对话中说要找回 Gemini 或 Antigravity 的项目说明、笔记和设置,并指定目标机器。
需要准备什么
- 应用和项目
- 本地/G 或私有 Git 版本
- 新机器目标目录
从开始到拿到结果
- 1
选可读成果
按登记清单找项目文件,说明原始聊天和媒体是否不在范围。
- 2
先恢复副本
挑一个已核验版本,保留新机现有文件后按相对目录回填。
- 3
确认能接着工作
核对项目引用、应用加载和官方登录;云上只有可读文件时不承诺整段会话回来。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
现役脚本、最近任务0和G元数据已读;本轮未做新机恢复关键规则与设计选择
只选当前脚本实现的路径与扩展名,不从“工作区备份”推断全量聊天。
本地与G各保留30份;私有Git提供提交历史,当前专用工作树会按本轮选择重建。
恢复是按原相对路径复制文件,当前没有Gemini专用自动还原器;先保留现有文件,之后重核安装、项目路径、登录与应用结果。
本模块用到的名词
- Antigravity brain(工作成果目录)
- 这里只收Markdown和metadata.json等可读成果,不把该目录名字当作完整会话库。
- MANIFEST(文件清单)
- 列出所选文件与总字节;它与G逐文件SHA-256回读及Git引用分别证明不同层。
专业定义
保留Gemini与Antigravity中可回填的配置和可读成果,原始会话与媒体不在这条链里。
解决什么
防止遗漏小型工作成果、把旧点当新状态,以及用文件备份冒充完整会话或登录恢复。
当前怎样实现
- backup-gemini-memory.ps1读取gemini_memory登记路径。db51ae7保留projects.json、config/**及Antigravity桌面状态,同时纳入antigravity-cli/settings.json、annotations/*.pbtxt,以及桌面/CLI(命令行工具)各自brain下的*.md和*.metadata.json。不复制整棵CLI(命令行工具)目录。
- 选择后排除.system_generated、scratch、tmp、history、原始conversations、db/sqlite/sqlite3/jsonl/log及媒体/二进制;CLI(命令行工具) cache、crashes、updater、builtin、bin、implicit、presence、knowledge排除。OAuth(账号授权协议)、credential/creds、token、secret、auth、google_accounts.json和.env类文件名也排除;这是有界选择规则,不是任意敏感内容识别器,真实载荷不进网页。
- 先Copy-SelectedFiles形成时间戳本地快照,再Publish-GHotSnapshot逐文件核对G;同内容可复用,最多30份。云阶段先检查main/远端状态,再清理专用工作树并从当前来源再次复制选中文件,写README和MANIFEST(清单)。
- Git按变更提交,仍会无条件核对或补推已有超前提交;最终远端OID一致才报告云完成。云失败抛出异常,已完成本地/G仍保留。
执行流程
- 1
读取这一套已登记路径,生成非空选择清单。
- 2
复制本地时间戳快照并核对G副本。
- 3
确认专用私有Git状态,重建本轮可读文件集合,提交并回读远端。
- 4
恢复时选择一个版本,保留当前目标文件后按相对路径回填。
- 5
重核项目引用、应用加载和官方登录;原始会话/媒体不在完成范围。
边界
- 不读或发布真实正文、账号和令牌;实际备份保持在原私有目标。
- Gemini 兼容任务沿用原名,只复制所选状态,不调用退役Gemini模型命令;文件备份不等于启动模型、恢复登录或重新运行旧产品。
- 源文件在本地/G完成后还可能变化,云阶段重新读源,不宣称原子跨介质快照。
- 新机自动登录、完整聊天恢复和应用兼容未在本轮验收。
失败与恢复
- 未选出文件或路径配置缺失
- 返回明确错误,不创建空备份冒充完成。
- 远端落后、分叉或认证错误
- 停止Git层;网络/TLS可有界退避,状态冲突不能靠重试或强推解决。
真实入口
E:\Projects\Tools\OpenClawGateway\tools\backup-gemini-memory.ps1实际选择、三层分发及恢复说明生成
tools/private-backup-settings.ps1 / g-hot-snapshot.ps1 / git-cloud-sync.ps1路径契约、G内容验证与私有Git回读
tools/test-gemini-memory-backup.ps1合成选择与排除回归
如何验证
- 9月9日22:07Z任务最近05:10:01Z为Ready/enabled/0;22:08Z G元数据127文件、181152字节与实际目录计数/字节一致,completed_utc=05:10:06Z。
- 私有Git本地/远端均为e3413caca7edbcf1ba9cf79d004ed26c080dbcbf;未读取正文、重新备份或还原。
- 2026-09-18只读已发布OpenClawGateway db51ae7与同次选择回归定义,确认CLI(命令行工具)新增范围和秘密/历史排除;本轮未运行新备份或恢复,不能把9月9日G元数据证明扩大到新增CLI(命令行工具)文件。
与其他模块的关系
这是Gemini自己的文件选择与恢复边界;与Codex会话库、Claude记忆和OpenClaw状态分别保存。
