中文 | English | 下载 ReHome Desktop
把 Codex Desktop 里你选择的项目、对话、Skills、Plugins 和生成内容，从一台电脑离线搬到另一台电脑。
从「Codex 搬家 Skill」的视频过来的？
之前需要把 Skill 发给 Codex，让 Agent 帮你执行迁移。现在这套流程已经做成 ReHome Desktop：普通用户直接使用 App 即可。旧 Skill 仍然保留，适合自动化和故障处理。
下载 ReHome Desktop · 前往 Codex ReHome Skill
- 原电脑：打开 ReHome Desktop，选择要带走的项目、对话和其他内容，生成一个
.rehome文件。 - 传输：通过网盘、私人聊天工具、局域网或移动硬盘，把
.rehome文件传到新电脑。 - 新电脑：先安装并登录一次 Codex，然后完全退出 Codex。打开 ReHome Desktop，导入文件并确认恢复；完成后重新打开 Codex。
安装程序和迁移文件不是同一件东西：EXE 或 DMG 用来安装 ReHome Desktop；.rehome 用来携带你的数据。
从 0.1.26 起，同一个迁移包里的同名项目会自动恢复到带不同标识后缀的独立目录，对话路径和项目登记会同步指向各自目录。仅大小写不同或 Unicode 写法等价的名称也会处理；没有重名的项目保持原目录名。遇到旧版 multiple package projects map to the same target directory 报错时，在新电脑更新 ReHome 后重新导入原包即可。
从 0.1.27 起，导入时会保留 Codex 新版对话的历史格式标记，也能从旧迁移包中的对话文件补回这个标记，修复因标记丢失导致的 list_turns is not supported yet。已导入但打不开对话时，在目标电脑更新 ReHome，关闭 Codex 后重新导入原包，再打开 Codex 检查对话。
- 选定项目及其项目文件
- 选定对话，以及对话在 Codex 中重新出现所需的本地索引
- Skills（包括
.codex/skills与跨 Agent 共用的.agents/skills）、Plugins 和生成图片 - 与选中内容相关的本地状态和路径映射
项目文件和对话历史是两类内容。只选对话时，项目源码不会自动被带走；选中项目时，默认会连同其子对话一起选择，但仍可以手动取消某条对话。
- Windows → Windows
- Windows → macOS
- macOS → Windows
- macOS → macOS
- 同一台电脑重装系统前后的备份与恢复
ReHome Desktop 当前处于 Beta。各方向的实际验收与已知边界见 验证状态。
ReHome Desktop 的迁移过程保持离线：不需要额外账号，不上传迁移数据，不安装系统服务，不设置开机启动，也不需要管理员权限。应用启动时会连接 GitHub Releases 检查新版本；检查失败不会影响迁移，下载和安装更新也必须由用户确认。
迁移包默认排除登录令牌、Cookies、.env、私钥、.git、node_modules、虚拟环境和运行时锁文件。不要把个人 .rehome 文件上传到 GitHub、公开帖子或任何公共下载链接。
这不是官方云同步，也不会让两台电脑每天自动保持一致。跨系统后，旧对话通常仍可作为历史上下文，但它原来绑定的工作目录可能不能继续直接使用。恢复完成后请重新打开项目；需要继续工作时，在恢复后的项目里开一个新任务最稳妥。
当前单个 .rehome 包、单个文件及单条 Codex 对话最多支持 16 GiB；大文件在创建、检查和恢复时采用流式处理。如果超过这个上限，请拆分对话或暂不选择对应文件。
如果恢复完成后项目中看不到旧对话，还应核对两台电脑使用的 model_provider（模型服务提供方标识）。部分 Codex 版本的默认对话列表会按当前提供方筛选；迁移包保留的旧标识与目标配置不同时，对话文件、索引和项目路径即使都已恢复，也可能不显示。ReHome 的恢复校验目前不检查这项列表可见性。若出现 Model provider ... not found，请先确认目标电脑已配置对应服务；登录凭据需要在目标电脑自行设置。请保留原包和本地备份，并提供版本及隐藏个人信息的报错截图排查，不要直接批量改写会话或数据库，也不要公开配置文件、密钥或迁移包。
登录状态、浏览器会话、正在运行的终端、未保存内容和系统原生依赖不会完整迁移。使用不同账号或 workspace 时，外部服务可能需要重新登录或授权。
Codex ReHome Skill 保留了原来的 Agent 工作流、脚本、Red Skill、批量自动化和故障处理能力。它适合熟悉 Codex/终端的用户；普通迁移请优先使用本仓库的 Desktop App。
遇到导出、包检查或导入错误时，可展开“需要帮助？”。导入结果和迁移记录里也有“会话打不开？获取帮助”。
- 复制到 Codex：先预览，再复制到这台电脑的 Codex 新对话。说明包含产品背景、本次现场位置和安全要求，不需要安装 Skill；Agent 排查指南 也随程序内置。
- 到 GitHub 提交问题：预览独立生成的公开摘要，再打开 GitHub，由你确认提交。不会自动上传诊断文件或迁移包。
- 重新检查数据：只读检查本次基础文件和部分索引，不打开数据库、不自动修复。实际打开原对话并续聊仍需单独确认。
本机诊断可能包含完整路径和错误摘录；复制到 Codex 后会交给你配置的模型服务处理，请在发送前检查。公开摘要不包含本机路径、原始错误或补充描述。诊断在 ReHome 本机应用数据目录单独保存，最多 50 份；保存失败仍可复制内存摘要。旧记录缺少的证据会明确标为未验证。不要让运行中的 Codex 直接改自己的会话数据库。
从 v0.1.4 起，ReHome Desktop 支持应用内检查、验签和安装更新。v0.1.3 及更早版本需要最后手动安装一次新版，之后即可在应用内更新。这里的更新签名用于防止升级包被篡改，不等同于 Apple 或 Windows 的付费开发者签名，因此系统仍可能显示“未知开发者”提示。
界面默认显示中文，可在左侧栏点击 English；语言选择会保存在本机。
ReHome Desktop 由本仓库的 desktop/ 提供，ReHome Core 与 Codex Bridge 已内置，不需要额外安装。采用 MIT License。