Codex Session Sync

同一台 Mac 上，Codex 官方账号登录端与 API/自定义端的本地任务记录默认互不相通——新建的任务"消失"、改名不同步、归档状态错乱、历史任务绑死退役模型。

codex-session-sync 解决这个问题：本地、可审计、先备份后写入的双向同步。

不是 OpenAI 官方项目。依赖 Codex Desktop 当前的本地 SQLite/JSONL 结构，Codex 升级后请先跑测试再操作真实数据。

它做什么

同步器以完整回合为最小单位，只复制用户可见且可跨 provider 使用的内容：

允许：用户消息、最终助手消息、task_started、完整可冷恢复的 turn_context、健康的 task_complete
排除：reasoning、工具调用、工具输出、压缩上下文、加密状态、provider 专属字段
失败即停：带 task_complete.error 的回合留在原端并标记异常——缺失的模型回答不会被 commentary 冒充，不会伪造助手内容
冲突不猜：两端同时独有改动时隔离该任务继续同步其他任务

# 要求：macOS + Codex Desktop + Node.js 18+ + Python 3
python3 codex_same.py

npm test                    # 单元
npm run test:integration    # 用本机真实 schema 的隔离闭环（临时目录，自动清理）

手动单机同步，不是实时/云端/跨设备；双端真实内容冲突需人工决定；整文件重写操作须先退出 Codex（app-server 运行时工具会拒绝并提示）。完整边界与原理见源 README 与 SECURITY.md。

Name		Name	Last commit message	Last commit date
docs		docs
.gitignore		.gitignore
AGENTS.md		AGENTS.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
anyrouter_auth_helper.py		anyrouter_auth_helper.py
anyrouter_auth_helper_test.py		anyrouter_auth_helper_test.py
anyrouter_compat_proxy.py		anyrouter_compat_proxy.py
anyrouter_compat_proxy_test.py		anyrouter_compat_proxy_test.py
closed_loop_test.js		closed_loop_test.js
codex_same.py		codex_same.py
core_logic_test.js		core_logic_test.js
install_anyrouter_compat.py		install_anyrouter_compat.py
install_anyrouter_compat_test.py		install_anyrouter_compat_test.py
lifecycle_health.js		lifecycle_health.js
lifecycle_health_test.js		lifecycle_health_test.js
new_counterpart_incomplete_test.js		new_counterpart_incomplete_test.js
package.json		package.json
sidebar_visibility_test.js		sidebar_visibility_test.js
sync_codex_sessions.js		sync_codex_sessions.js
test_runner.js		test_runner.js
visible_history_migration_test.js		visible_history_migration_test.js
同步Codex两边会话.command		同步Codex两边会话.command