Codex使用第三方API實現(xiàn)跨平臺對話同步

發(fā)布時間：2026-07-24 10:18:23 作者：grlime

本文使用CodexSync實現(xiàn)跨平臺對話同步,輕松在Windows與macOS間自動轉(zhuǎn)換項目路徑,只需一鍵push即可同步,另一臺設(shè)備pull后即可無縫續(xù)寫,告別重復(fù)工作,立即提升你的協(xié)作效率

Codex Sync

通過 GitHub 實現(xiàn) Codex 跨平臺對話同步（使用第三方API）。在一臺設(shè)備上 push，另一臺設(shè)備上 pull — Windows 與 macOS 之間的項目路徑自動轉(zhuǎn)換。如果安裝有問題可以問問LLM。

使用第三方API的參考資料：https://www.bilibili.com/video/BV1TvR2B7EiR/?spm_id_from=333.337.search-card.all.click
參考的github庫：https://github.com/BenedictKing/ccx、https://github.com/farion1231/cc-switch
同步代碼所在github URL：https://github.com/GrLime909/codex-3p-sync-tools/tree/main

工作原理

  Windows                         macOS
┌──────────┐                  ┌──────────┐
│ ~/.codex │ ── push ──> GitHub <── pull ── │ ~/.codex │
│ sessions │                  │ sessions │
│ rules/   │                  │ rules/   │
│ skills/  │                  │ skills/  │
│ ...      │                  │ ...      │
└──────────┘                  └──────────┘

同步 .gitignore 未排除的所有內(nèi)容（sessions、rules、skills、plugins 等）。敏感文件（auth.json、config.toml）和大文件（*.sqlite）永遠(yuǎn)不會被同步。

路徑轉(zhuǎn)換：通過 pathmap.conf，會話文件中的項目路徑在 Windows（D:\working）和 macOS（/Users/.../working）之間自動轉(zhuǎn)換。

快速開始

1. 環(huán)境要求

Python 3.8+
Git
pip install pathspec（如使用后臺監(jiān)控還需 pip install watchdog）
一個用于存儲同步數(shù)據(jù)的 GitHub 私有倉庫（創(chuàng)建 codex-sync）

2. 一次性配置（兩臺設(shè)備都需要）

# 將本倉庫克隆到 ~/.codex/
cd ~/.codex
git clone https://github.com/YOUR_USERNAME/codex-sync-tools.git tools
# 或直接復(fù)制以下文件：
#   sync.py, codex-watch.py, pathmap.conf.example, home.gitignore

# 復(fù)制并配置 gitignore,修改為你需要的屏蔽的文件或文件夾
.gitignore

# 配置路徑映射
cp pathmap.conf.example pathmap.conf
# 編輯 pathmap.conf，填入你的項目路徑

# 編輯 sync.py：將 SYNC_REPO 改為你的私有同步倉庫地址

3. 首次 Push

關(guān)閉 Codex，然后：

python ~/.codex/sync.py push

腳本會自動初始化同步倉庫并推送你的會話數(shù)據(jù)。

4. 在另一臺設(shè)備上 Pull

python ~/.codex/sync.py pull

命令

命令	作用
push	將會話和文件復(fù)制到 GitHub（自動路徑轉(zhuǎn)換）
pull	從 GitHub 拉取到本地 ~/.codex/
status	查看本地與遠(yuǎn)程會話數(shù)量對比

后臺監(jiān)控（可選）

codex-watch.py 在后臺運行，自動完成：

Codex 啟動時自動 pull
會話文件變更后閑置 60 秒自動 push

pip install watchdog
python ~/.codex/codex-watch.py

Windows：將 codex-watch.vbs（先修改內(nèi)部路徑）放入 shell:startup。

macOS：通過 launchd 運行。

文件說明

文件	用途
sync.py	主同步腳本（push/pull/status）
codex-watch.py	后臺自動同步監(jiān)控（可選）
codex-watch.vbs	Windows 靜默啟動器
pathmap.conf.example	跨平臺路徑映射模板
home.gitignore	~/.codex/ 的 .gitignore 模板

路徑映射

pathmap.conf 定義 Windows 與 macOS 之間的項目路徑對應(yīng)關(guān)系：

# name = WindowsPath | macOSPath
working = D:\\working | /Users/name/working
learning = C:\\learning | /Users/name/learning

只有在此列出的項目才會進行路徑轉(zhuǎn)換，項目無關(guān)的對話不受影響。

注意事項

push/pull 前關(guān)閉 Codex — 避免文件鎖定沖突，本地使用時候，打開期間也不影響使用，只不過不能同時進行對話，否則會導(dǎo)致對話記錄被刪除。
注意需要安裝好watchdog、pathspec等py文件中必要的庫，否則代碼無法正常執(zhí)行
同步倉庫應(yīng)為私有 — 你的對話數(shù)據(jù)僅屬于你自己。
auth.json、config.toml 及 SQLite 數(shù)據(jù)庫已被 .gitignore 排除。

到此這篇關(guān)于Codex使用第三方API實現(xiàn)跨平臺對話同步的文章就介紹到這了,更多相關(guān)Codex 跨平臺對話同步內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！