cc-backup-restore 配置备份恢复

定位

把 ~/.claude 下的配置与数据打包成一个自包含备份目录，换号 / 重装 / 换机后一键恢复。

对话里说「备份 cc 配置」「换号前先备份」「重装 claude code 前保存配置」「恢复 cc 配置」「换账号后配置没了」等都会触发。

职责边界（先分清，别用错）

cc-backup-restore 只搬「配置与数据」，不装软件、不改权限模式、不搬登录授权：

它刻意不做基线安装——一个「恢复备份」的动作不该顺手改你的 defaultMode、brew install 二进制、全局 npm i -g。那些是「初始化新环境」的语义，拆在 cc-bootstrap 里。（cc-auth-migrate / cc-bootstrap 属于 vft-ai，不在开源的 vft-kit 里。）

备份（换号 / 重装前）

bash "${CLAUDE_PLUGIN_ROOT}/skills/cc-backup-restore/scripts/cc-backup.sh"

产出 ~/cc-backups/cc-backup-<时间戳>/（可用 CC_BACKUP_ROOT 环境变量改目标目录）。这个目录自包含：内含 cc-restore.sh + README.md + MANIFEST.txt，整个拷到任何机器都能独立恢复，不依赖本插件。

备份内容：

• 顶层 md——CLAUDE.md 以及它 @ 引用的同级 md（如 RTK.md）。只拷 CLAUDE.md 会让 @RTK.md 引用悬空。
• settings.json / settings.local.json，备份时即剔除 env / oauthAccount / oauthToken——恢复本来就不用它们，留着只是把代理凭据 / OTEL 端点摊在磁盘上。
• 插件：installed_plugins.json + known_marketplaces.json。两者缺一不可——清单只记「装了哪些插件」，来源在 marketplace 里；少了来源，自建 / 私有 marketplace 的插件恢复时无从下载。另出一份人读的 plugin-list.txt。
• 各项目 memory/ / hooks/ / skills/ / agents/ / commands/。
• Playwright MCP 的 .mcp.json 留档（插件重装会覆盖它，留个档好把 --output-dir 手动补回）。

恢复（换号 / 重装 / 换机后）

新账号登录后，进备份目录跑恢复脚本：

cd ~/cc-backups/cc-backup-<时间戳>
bash cc-restore.sh          # 交互确认
bash cc-restore.sh -y       # 非交互

也可以不 cd，直接指定备份目录：

bash "${CLAUDE_PLUGIN_ROOT}/skills/cc-backup-restore/scripts/cc-restore.sh" ~/cc-backups/cc-backup-<时间戳> -y

恢复行为要点：

• settings.json 是合并不是覆盖：以当前 live 配置为底，用备份覆盖结构项，并再次剔除 env / oauthAccount / oauthToken 兜底——即使拿到老格式备份，也绝不把旧 token / 代理注回新号。
• 覆盖前留回滚点：每个被覆盖的文件另存 *.pre-restore-<时间戳>.bak。
• directory 型 marketplace 会做存在性校验：自建插件仓库（本地目录型）在 known_marketplaces.json 里是绝对路径引用，换机后路径不存在就装不回来。脚本会逐个查、缺的直接点名，而不是让你在启动时静默少几个插件。
• memory / hooks / skills / agents / commands 按原路径还原；插件在下次启动 CC 时自动重装。
• Playwright 的 --output-dir 需插件装好后手动补（脚本会提示）。

依赖 jq（macOS brew install jq）。没有 jq 时脚本不中断，但会跳过 settings 脱敏与合并并打印警告——此时备份里含敏感 env，注意下面的红线。

安全红线

• 备份默认不含登录态与 env。但 hooks/ / skills/ / memory/ 里可能有你自己写进去的敏感内容，仍不要提交进 git、不要贴聊天 / 截图。
• 备份默认落在 ~/cc-backups/（不在 iCloud 可能同步的 ~/Documents 下）。要改位置用 CC_BACKUP_ROOT，注意别放进会自动同步 / 上传的目录。
• 恢复会覆盖当前配置（有 .bak 可回滚）。-y 跳过确认前，请确认目标机是想被覆盖的那台。

相关

• 恢复后核对装齐了没 → cc-baseline
• 插件恢复后不生效 → plugin-refresh