Codex Sync

在同一局域网的多台电脑之间同步 Codex 聊天记录和配置。提供命令行与内置 Web 界面。

快速开始

cargo build --release
./target/release/codex-sync init

编辑 ~/.config/codex-sync/config.toml，把 shared_key 改成一个随机长字符串；每台电脑使用相同密钥。随后运行：

./target/release/codex-sync serve

打开 http://localhost:8787。也可以使用命令行：

codex-sync peers
codex-sync pull 192.168.1.20:8787
codex-sync status

U 盘离线中转

在电脑 A 上导出（macOS 示例）：

codex-sync usb export /Volumes/MYUSB

把 U 盘插到电脑 B，查看并导入：

codex-sync usb list /Volumes/MYUSB
codex-sync usb import /Volumes/MYUSB

如果 U 盘中有多台电脑的快照，usb list 会显示每个快照的具体目录，导入时指定该目录即可。导入会验证 BLAKE3 哈希；同名但内容不同的文件默认保存为冲突副本。需要明确覆盖时使用 usb import PATH --overwrite。

SMB 服务器中转

Codex Sync 使用操作系统已经挂载的 SMB 目录，不保存服务器用户名或密码。先通过系统连接共享：

macOS：访达 → 前往 → 连接服务器，输入 smb://服务器/codex-sync，通常挂载到 /Volumes/codex-sync。
Windows：在资源管理器映射网络驱动器，例如 Z:。
Linux：用桌面文件管理器挂载，或将共享挂载到 /mnt/codex-sync。

电脑 A 推送快照：

codex-sync smb push /Volumes/codex-sync

电脑 B 查看并拉取：

codex-sync smb list /Volumes/codex-sync
codex-sync smb pull /Volumes/codex-sync

Windows 示例：

codex-sync.exe smb push Z:\
codex-sync.exe smb pull Z:\

共享中有多个设备快照时，先通过 smb list 找到目标快照的完整路径，再将它传给 smb pull。默认保留冲突副本；明确覆盖时添加 --overwrite。SMB 快照和 U 盘快照使用相同的开放目录格式，可以相互复制。

其他中转方式

relay 支持任何在操作系统中表现为普通目录的中转服务，包括：

NFS、AFP 或 NAS 挂载目录
WebDAV 挂载盘
Syncthing、Resilio Sync 等点对点同步目录
Dropbox、OneDrive、iCloud Drive、Google Drive 等桌面同步目录
虚拟机共享目录、远程开发共享目录

通用用法：

# 电脑 A 发布快照
codex-sync relay push /path/to/shared-folder

# 电脑 B 查看及获取
codex-sync relay list /path/to/shared-folder
codex-sync relay pull /path/to/shared-folder

例如使用 Syncthing：先让两台电脑同步同一个 CodexRelay 文件夹，再分别运行：

codex-sync relay push ~/Sync/CodexRelay
codex-sync relay pull ~/Sync/CodexRelay

例如使用 Windows OneDrive：

codex-sync.exe relay push "$env:OneDrive\CodexRelay"
codex-sync.exe relay pull "$env:OneDrive\CodexRelay"

使用云同步目录时，请等待云盘客户端完成上传或下载后再执行 pull。清单采用最后写入的原子替换方式，未完成的快照不会被识别为可导入快照。

合并 CC-Switch 多账号记录

Codex Sync 可以把本机 CC-Switch 不同供应商产生的历史记录统一归入当前登录的 Codex 账号。先预览：

codex-sync cc-switch status
codex-sync cc-switch merge

确认数量后，关闭 Codex 和 CC-Switch，再执行：

codex-sync cc-switch merge --apply

合并会同时更新会话 JSONL 的 model_provider 和 state_5.sqlite 的记录桶。执行前自动备份到 ~/.codex/codex-sync-backups/cc-switch-merge-时间戳，该目录默认不会参与设备同步。此操作不读取、复制或修改 API Key、Token、auth.json 和供应商认证配置。

同步策略与安全

默认同步 ~/.codex，排除 auth.json、凭据、日志、缓存和临时文件。
API 使用共享密钥认证；密钥不会经节点发现广播或写入 U 盘快照。
SMB 账号和密码由操作系统管理，不会写入 Codex Sync 配置或快照。
默认只拉取。遇到同名但内容不同的文件时，远端版本保存为 .conflict-节点名，不会覆盖本地内容。
pull --overwrite 会覆盖不同内容的本地文件，使用前请自行备份。
服务默认监听 0.0.0.0:8787，请只在可信局域网使用，并通过系统防火墙限制访问。

当前范围

这是可用的 MVP：文件清单、哈希比较、节点发现、手动拉取和 Web 管理均已实现。自动后台双向同步、设备审批、TLS、冲突合并与系统服务安装可作为后续版本加入。

许可证

本项目采用 MIT License 开源。

codex-sync 0.1.0