Codex ReHome

中文 | English | 下载 ReHome Desktop

把 Codex Desktop 里你选择的项目、对话、Skills、Plugins 和生成内容，从一台电脑离线搬到另一台电脑。

从「Codex 搬家 Skill」的视频过来的？

之前需要把 Skill 发给 Codex，让 Agent 帮你执行迁移。现在这套流程已经做成 ReHome Desktop：普通用户直接使用 App 即可。旧 Skill 仍然保留，适合自动化和故障处理。

下载 ReHome Desktop · 前往 Codex ReHome Skill

三步完成迁移

1. 原电脑：打开 ReHome Desktop，选择要带走的项目、对话和其他内容，生成一个 .rehome 文件。
2. 传输：通过网盘、私人聊天工具、局域网或移动硬盘，把 .rehome 文件传到新电脑。
3. 新电脑：先安装并登录一次 Codex，然后完全退出 Codex。打开 ReHome Desktop，导入文件并确认恢复；完成后重新打开 Codex。

安装程序和迁移文件不是同一件东西：EXE 或 DMG 用来安装 ReHome Desktop；.rehome 用来携带你的数据。

从 0.1.36 起，Desktop 导出会保留新版 Codex 的项目名称、工作区目录与所选对话的项目归属，在支持该项目模型的目标 Codex 中一起恢复；嵌套项目优先匹配最深目录，归类使用当前数据库路径。重复导入会复用迁入项目，并保留目标端已修改的项目名称；现有对话若已归到另一个项目，会停止导入并保留现有归属。旧版 Codex 继续使用原有路径恢复方式，不会被强加新版数据库结构。需要保留新版项目分类时，请在源电脑更新 Desktop 后重新导出，旧包中未保存的分类无法凭空补回。此项不包含独立 Skill 的更新，也不改变项目文件的选取和排除规则。

从 0.1.34 起，ReHome 可以发现并导出 Codex 的 .jsonl.zst 压缩会话。导出时流式解压为迁移包内的普通 .jsonl，保留原会话 ID、历史格式和消息，不修改原文件；普通会话和旧迁移包仍然可用。损坏或身份不一致的会话会明确提示，不会生成不完整的成功包，也不会覆盖已有输出。源电脑若出现压缩会话，请先更新 ReHome 后重新导出。

0.1.34 同时修复了原生 SQLite WAL 数据库在导入成功后立即回滚时的误报冲突。回滚仍会保护导入后的外部修改；遇到真实冲突时请保留备份，不要手动删除 WAL 或改数据库模式。

从 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 检查对话。

从 0.1.31 起，导入会改写对话保存的工作区根目录，包括后续设置快照中的 runtime_workspace_roots，避免跨系统恢复时出现 cannot restore workspace root ... path is not absolute。选中项目及其子目录会映射到对应的新目录；没有随包迁移的额外工作区根目录会从列表移除，不会猜测新位置。聊天正文不受影响。旧包也可使用：在目标电脑更新 ReHome，关闭 Codex 后重新预览、导入原包；若现有对话内容已变化，保留现有对话并检查新导入的副本。

可以迁移什么

导入时可以更换项目位置。在「项目保存位置」选择新电脑上的上级文件夹，ReHome 会在其中为每个项目建立目录并调整关联对话的项目路径。请在预览里确认完整目标路径；当前不提供逐项目任意改名或单独指定目录。迁移包需要包含项目，才能同步映射它的关联对话。

从 0.1.33 起，导出的完整暂存副本优先放在迁移包保存位置所在的磁盘，并在导出成功或失败后清理；Windows 暂存目录沿用本机私有缓存的访问权限，macOS 使用私有目录权限。若保存位置位于选中的源内容内，或磁盘不支持私有目录权限，则继续使用本机缓存暂存。请为暂存副本和迁移包同时留出空间。勾选项目会包含其项目文件，只减少对话数量不一定会明显缩小包。磁盘写满时会显示实际暂存位置和保存位置，不再误报为迁移包无效。

• 选定项目及其项目文件
• 选定对话，以及对话在 Codex 中重新出现所需的本地索引
• Skills（包括 .codex/skills 与跨 Agent 共用的 .agents/skills）、Plugins 和生成图片
• 与选中内容相关的本地状态和路径映射

项目文件和对话历史是两类内容。只选对话时，项目源码不会自动被带走；选中项目时，默认会连同其子对话一起选择，但仍可以手动取消某条对话。

支持的场景

分叉对话可能引用原对话的历史，而不是保存完整副本。导出页会列出需要一起迁移的原对话，只有你明确勾选后才会打包；缺少源记录或依赖循环时会阻止创建不完整的包。分批迁移时，每个包含这类分叉的包也需要带上相应原对话。旧包已缺失的历史无法凭空恢复，请保留旧电脑数据并重新导出。

Codex 版本可能影响历史读取方式，不需要为了迁移一律升级到最新版。本机验收的 Codex CLI 0.163.0-alpha.11 在全新历史索引中直接读取分叉时可能返回空列表；先打开原对话，再返回分叉可以重建可读历史，重启后仍可读回。此项限制单独记录，不把文件校验通过等同于实际续聊通过。

• Windows → Windows
• Windows → macOS
• macOS → Windows
• macOS → macOS
• 同一台电脑重装系统前后的备份与恢复

ReHome Desktop 当前处于 Beta。各方向的实际验收与已知边界见 验证状态。

隐私与系统影响

ReHome Desktop 的迁移过程保持离线：不需要额外账号，不上传迁移数据，不安装系统服务，不设置开机启动，也不需要管理员权限。应用启动时会连接 GitHub Releases 检查新版本；检查失败不会影响迁移，下载和安装更新也必须由用户确认。

迁移包默认排除登录令牌、Cookies、.env、私钥、.git、node_modules、虚拟环境和运行时锁文件。不要把个人 .rehome 文件上传到 GitHub、公开帖子或任何公共下载链接。

需要知道的限制

这不是官方云同步，也不会让两台电脑每天自动保持一致。跨系统后，旧对话通常仍可作为历史上下文，但它原来绑定的工作目录可能不能继续直接使用。恢复完成后请重新打开项目；需要继续工作时，在恢复后的项目里开一个新任务最稳妥。

迁移包、普通项目文件和单条 Codex 对话不再设固定的总大小上限。项目文件采用分块复制，对话正文保存在临时文件中，路径改写与恢复校验逐条处理。请为迁移包、临时文件和恢复备份留足磁盘空间；内容较多时也可以分批选择对话。同一项目分批迁移时，每批保留项目勾选，并导入到同一个项目保存位置；未变化的项目文件会跳过，目标文件发生变化时仍需处理冲突。

解析保护仍然保留：最多 100,000 个归档条目、4 MiB 的清单、64 MiB 的校验列表、合计 64 MiB 的规划摘要与对话桥接元数据，以及 64 MiB 的单条会话 JSON 记录。这些限制用于控制解析的内存占用，不是迁移包或整个对话的容量上限。若某条记录超过解析限制，ReHome 会明确报告错误，不会截断或删除对话内容。目标 Codex 对超大对话的打开能力仍取决于其版本和电脑资源。

如果恢复完成后项目中看不到旧对话，还应核对两台电脑使用的 model_provider（模型服务提供方标识）。部分 Codex 版本的默认对话列表会按当前提供方筛选；迁移包保留的旧标识与目标配置不同时，对话文件、索引和项目路径即使都已恢复，也可能不显示。ReHome 的恢复校验目前不检查这项列表可见性。若出现 Model provider ... not found，请先确认目标电脑已配置对应服务；登录凭据需要在目标电脑自行设置。请保留原包和本地备份，并提供版本及隐藏个人信息的报错截图排查，不要直接批量改写会话或数据库，也不要公开配置文件、密钥或迁移包。

登录状态、浏览器会话、正在运行的终端、未保存内容和系统原生依赖不会完整迁移。使用不同账号或 workspace 时，外部服务可能需要重新登录或授权。

仍然想用 Skill？

Codex ReHome Skill 保留了原来的 Agent 工作流、脚本、Red Skill、批量自动化和故障处理能力。它适合熟悉 Codex/终端的用户；普通迁移请优先使用本仓库的 Desktop App。

安装与帮助

遇到导出、包检查或导入错误时，会直接显示 Codex 求助方案并生成可检查的排查内容。导入结果和迁移记录里也有“项目或对话找不到、打不开？获取帮助”。

• 复制到 Codex：先预览，再复制到这台电脑的 Codex 新对话。说明包含产品背景、本次现场位置和安全要求，不需要安装 Skill；Agent 排查指南 也随程序内置。
• 到 GitHub 提交问题：预览独立生成的公开摘要，再打开 GitHub，由你确认提交。不会自动上传诊断文件或迁移包。
• 重新检查数据：只读检查本次基础文件和部分索引，不打开数据库、不自动修复。实际打开原对话并续聊仍需单独确认。

本机诊断可能包含完整路径和错误摘录；复制到 Codex 后会交给你配置的模型服务处理，请在发送前检查。公开摘要不包含本机路径、原始错误或补充描述。诊断在 ReHome 本机应用数据目录单独保存，最多 50 份；保存失败仍可复制内存摘要。旧记录缺少的证据会明确标为未验证。不要让运行中的 Codex 直接改自己的会话数据库。

从 v0.1.4 起，ReHome Desktop 支持应用内检查、验签和安装更新。v0.1.3 及更早版本需要最后手动安装一次新版，之后即可在应用内更新。这里的更新签名用于防止升级包被篡改，不等同于 Apple 或 Windows 的付费开发者签名，因此系统仍可能显示“未知开发者”提示。

界面默认显示中文，可在右上角“更多选项”菜单中点击 English；语言选择会保存在本机。迁移记录、帮助和“设置与关于”也在这个菜单里。导出和导入按步骤展开，文件检查通过不等于旧对话已经能用；实际打开和继续旧对话后，再确认使用结果。

• 中文安装说明
• English installation guide
• 验证状态
• 安全说明

开发与许可证

ReHome Desktop 由本仓库的 desktop/ 提供，ReHome Core 与 Codex Bridge 已内置，不需要额外安装。采用 MIT License。