3.0 KiB
3.0 KiB
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.json与provider_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/迁移说明.mdscripts/codex_backup_restore.py --help