Files
karuo-ai/01_卡资(金)/金仓_存储备份/Codex账号备份恢复/SKILL.md
2026-08-09 23:23:08 +08:00

3.0 KiB
Raw Blame History

name, description, member, group, version, updated
name description member group version updated
Codex账号备份恢复 备份当前 Codex 的配置、skills、对话索引和本地状态并在切换账号后恢复。触发词Codex备份、Codex恢复、账号切换恢复、Codex迁移、Codex材料恢复、Codex记录恢复。 金仓 1.0 2026-06-07

Codex账号备份恢复

把当前机器里的 Codex 关键材料导出成一份可恢复快照,方便切换其他 Codex 账号后继续沿用旧的本地配置、skills、记录索引和状态文件。

适用范围

  • 同一台 Mac 上切换不同 Codex 账号
  • 重装 Codex 后恢复本地工作环境
  • 迁移 ~/.codex 中的高价值材料
  • 保留一份脱离账号的本地恢复包

默认备份内容

  • ~/.codex/config.toml
  • ~/.codex/auth.jsonprovider_secrets.toml(仅显式要求时恢复)
  • ~/.codex/AGENTS.md
  • ~/.codex/skills/
  • ~/.codex/memories/
  • ~/.codex/sessions/archived_sessions/shell_snapshots/
  • ~/.codex/session_index.jsonl
  • ~/.codex/*.sqlite*
  • ~/.codex/.codex-global-state.json*
  • ~/.codex/process_manager/chat_processes.json

不默认备份

  • cache/
  • tmp/
  • vendor_imports/
  • 插件缓存和浏览器临时缓存

这些内容可重新生成,保留它们通常只会让包变大。

使用方法

1. 创建备份

python3 "01_卡资/金仓_存储备份/CodexAccountBackupRestore/scripts/codex_backup_restore.py" backup

输出目录默认在:

~/Documents/CodexBackups/最新时间戳/

2. 恢复到当前账号

python3 "01_卡资/金仓_存储备份/CodexAccountBackupRestore/scripts/codex_backup_restore.py" restore \
  --snapshot "~/Documents/CodexBackups/20260607-xxxxxx"

默认行为:

  • 先给现有 ~/.codex 做时间戳备份
  • 恢复配置、skills、状态库、索引
  • 不恢复密钥文件

3. 连密钥一起恢复

python3 "01_卡资/金仓_存储备份/CodexAccountBackupRestore/scripts/codex_backup_restore.py" restore \
  --snapshot "~/Documents/CodexBackups/20260607-xxxxxx" \
  --include-secrets

仅在你明确要沿用旧账号或旧网关密钥时使用。

4. 安装到 Codex skills

bash "01_卡资/金仓_存储备份/CodexAccountBackupRestore/scripts/install_to_codex_skills.sh"

这样以后即使切换账号,~/.codex/skills/codex-account-backup/ 里也会有一份同内容 skill。

交付物

每次备份会生成:

  • manifest.json:备份清单
  • restore-notes.md:恢复说明
  • sidebar-index.md:项目目录与聊天会话对照表(恢复后侧边栏验收用)
  • payload/:实际文件

恢复铁律

  • 先退出 Codex App 再恢复
  • 恢复后重新打开 Codex
  • 若只想恢复工作流和记录,不要--include-secrets
  • 若恢复后异常,可用脚本生成的 ~/.codex.before-restore-* 目录回滚

相关说明

更多细节见:

  • references/迁移说明.md
  • scripts/codex_backup_restore.py --help