{"repo":"gmkrxb/codex-history-sync","free":true,"listed":false,"github":"https://github.com/gmkrxb/codex-history-sync","clone":"git clone https://github.com/gmkrxb/codex-history-sync.git","description":"Codex Desktop 本地历史同步与恢复工具，支持 provider 迁移、SQLite/JSONL 备份恢复和多平台桌面打包。","language":"Python","stars":33,"topics":["backup-restore","codex","codex-desktop","desktop-app","electron","sqlite","vue3"],"license":"MIT","category":"databases-storage","readme_excerpt":"Codex History Sync 修复 Codex Desktop 本地历史不可见、同步不完整、数据库索引异常和备份恢复问题。 English · 下载 · 3.0 更新内容 · 命令行 · 发布 3.0.0 简介 Codex History Sync 是一个用于修复 Codex Desktop 本地历史显示问题的桌面工具。常见场景是：切换账号、API Key、认证方式或 model provider 后，历史对话仍然保存在 /.codex ，但 Codex Desktop 左侧历史列表不再显示或只显示一部分。 3.0.0 版本在 2.0 GUI 的基础上重点修复了同步不完整、JSONL 元数据只改一部分、写入失败误判成功、恢复备份不完整等问题，并新增数据库诊断/修复、同步前环境预检、失败后管理员权限重试、GitHub Release 更新检测。 项目地址：gmkrxb/codex-history-sync 3.0 更新内容 - 同步前完整预检：检查 Codex 进程、SQLite schema、 PRAGMA quick check 、备份目录写入权限、数据库锁、JSONL 文件读写权限。 - 修复同步不完整：完整扫描 JSONL 中所有 session meta ，不再只扫描文件开头，也不再漏掉同文件里的多条元数据。 - 写后校验和回滚：同步后再次检查 DB 与 JSONL 是否全部归到当前 provider；失败时尝试恢复 SQLite 与 JSONL 备份。 - 数据库诊断：检测数据库完整性、缺失 threads 索引、空标题/预览、缺失 JSONL、provider 不一致和 JSONL 解析异常。 - 数据库修复：从 sessions/ 与 archived sessions/ 的 JSONL 重建缺失的 threads 记录，补空标题/预览，修正 provider 元数据。修复策略默认“只补不删”。 - 管理员权限重试：同步、恢复、修复失败后，可在界面点击获取管理员权限继续；Windows 使用 UAC，macOS 使用管理员授权，Linux 优先使用 pkexec 。 - 更新检测：应用启动后有网络就检查 GitHub Releases，不强制更新；有新版本时显示小点提示，用户点击后可查看更新说明并跳转 Release 页面。 - UI 文案修复：恢复中文界面与 README 编码，补齐 GitHub 链接、操作日志和修复结果展示。 适用场景 适合这些情况： - 切换账号、API Key、认证方式或 provider 后，Codex Desktop 历史突然不可见。 - 同步后只恢复了一部分历史，或者 JSONL 与 SQLite provider 不一致。 - 本地 /.codex/state 5.sqlite 仍存在，但历史索引记录缺失、标题为空、预览为空。 - 使用过不稳定版本，担心数据库索引或历史元数据被写坏。 - 需要先看到同步/修复会改什么，再决定是否执行。 不适合这些情况： - 多台电脑之间合并历史。 - 云端账号之间同步对话。 - SQLite 数据库文件已经完全删除且没有任何备份或 JSONL 历史。 - PRAGMA quick check 已确认数据库底层损坏时直接强行写入；这种情况应先从备份恢复。 下载 Release 页面：https://github.com/gmkrxb/codex-history-sync/releases 系统 架构 类型 下载 --- --- --- --- Windows ","default_branch":null,"files":null,"tree":[],"storefront":"/r/gmkrxb","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/gmkrxb/codex-history-sync/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}