linux.do

来回切 Mac 和 Windows 太痛苦，我做了个 Codex 线程迁移助手

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

● 我的帖子已经打上 开源推广 标签： 是
● 我的开源项目完整开源，无未开源部分： 是
● 我的开源项目已链接认可 LINUX DO 社区： 是
● 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
● 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

----------------------

我受不了手改 Codex session 了，干脆做了个迁移助手

这几天一直在折腾 Codex，最大的痛点不是别的，是换机器之后线程不好接着用。

典型场景大概是这样：

● 在 Mac 上聊了一堆，工作区路径是 /Users/xxx/...
● 回到 Windows 机器，想把线程接上继续跑
● 结果里面带着原来的 cwd、model_provider，还有一些历史上下文
● 直接拷过去，经常不是不能用，就是得自己手改 .jsonl

这种事偶尔搞一次还行，搞多了真的很烦。

所以我干脆自己做了个工具：

Codex Session Migration Assistant

仓库地址：
https://github.com/lich13/codex-session-migration-assistant

一句话介绍：

把另一台机器上的 Codex 线程迁移到当前机器，并自动改写成当前环境能继续用的状态。

不是简单复制文件，而是尽量把那些会卡住你的环境字段一起处理掉。

----------------------

这工具主要能干嘛

1. 跨平台迁移 Codex 线程

支持把线程从：

● macOS -> Windows
● Windows -> macOS
● 或者同平台不同机器之间

迁移到当前机器。

它会自动处理一些关键字段，比如：

● session_meta.payload.cwd
● turn_context.payload.cwd
● session_meta.payload.model_provider

也就是说，如果你原来线程是在 Mac 上开的，路径是 /Users/...，迁到 Windows 时就可以改成你当前机器的工作区。

2. 拖进去就能导入

GUI 支持直接拖：

● 单个 .jsonl
● 整个文件夹

不用自己一条条命令慢慢敲。

3. 历史参数也能一起补

除了基础路径和 provider 之外，还支持按需处理历史里的：

● model
● effort

如果线程历史里的 function_call.arguments 里有结构化路径字段，也可以选择一起改。

这点对“看起来导进来了，实际一跑还在引用旧路径”的情况挺有用。

4. 可选重生线程 ID

如果你担心和本机已经存在的线程冲突，可以直接让它重新生成线程 ID。

这就比手动改保险得多。

5. 直接写进本机 Codex

导入不是导到一个临时目录里看看就完了，而是可以直接写进当前机器的：

● ~/.codex/sessions
● session_index.jsonl

目标就是尽量做到：导完就能接着用。

----------------------

我顺手还加了几个自己很需要的功能

6. 一键清理归档线程

很多人 .codex/archived_sessions 里会堆一堆旧线程文件，时间长了越来越乱。

现在可以直接一键清理。

7. 一键备份整个 .codex

这个我自己用得很频繁。

可以把整个 ~/.codex 直接备份到当前程序目录下，不用你另外找路径。

8. 一键恢复 .codex

恢复时也不是硬覆盖，恢复前会先自动打一个安全快照，避免手一抖把当前环境干没了。

9. 一键切换配置

这个功能是我后来越做越觉得真香的。

现在支持：

● 扫描本地已有备份
● 用下拉菜单选目标配置
● 一键切换过去

如果切换时检测到你当前配置下有新增线程，还会自动把这些线程改写成目标配置也能直接用的状态，再一起迁过去。

10. 备份命名尽量做得人类可读

如果识别到是 OpenAI 原版配置，会尽量按账号 / 套餐命名备份；
如果是自定义配置，就归成 custom。

这样切换时不会看到一堆自己都分不清的 zip。

----------------------

这个工具适合谁

我觉得比较适合这几类人：

● 平时在 Mac 和 Windows 来回切的人
● 有多套 Codex 配置的人
● 想把旧线程、旧上下文继续利用起来的人
● 不想手改 session 文件的人
● 想把 .codex 整体做备份和切换的人

如果你压根只在一台机器上用一个配置，那你可能暂时用不上。

但只要你开始跨设备、跨账号、跨 provider 折腾，这东西就会开始变得顺手。

----------------------

现在已经能用到什么程度

目前我已经整理好了：

● Windows 可执行版
● macOS DMG
● 源码
● 打包脚本
● Release 说明和校验文件

仓库在这：
https://github.com/lich13/codex-session-migration-assistant

有兴趣的话可以直接看源码，也可以直接下发布包。

----------------------

为什么我会做这个

本质上就是自己被这个问题烦到了。

一开始只是想做个小脚本，后来发现真要想“迁过去就能继续用”，不是简单改一个字段就完事了，还得考虑：

● 工作区路径
● model_provider
● 历史 model / effort
● 线程 ID 冲突
● 多套配置切换
● .codex 整体备份恢复

于是越补越多，最后干脆做成了个 GUI 工具。

----------------------

如果你也有类似需求

欢迎试用，也欢迎提 issue。

11 views08:55