{"repo":"LinYiXin123/codex-history-sync-tool","free":true,"listed":false,"github":"https://github.com/LinYiXin123/codex-history-sync-tool","clone":"git clone https://github.com/LinYiXin123/codex-history-sync-tool.git","description":"Recover missing local Codex Desktop conversations after switching provider, auth mode, or API key.","language":"PowerShell","stars":17,"topics":["chat-history","codex","codex-desktop","desktop-tool","powershell","python","sqlite","windows"],"license":"MIT","category":"databases-storage","readme_excerpt":"Codex History Sync Tool 一个面向 Windows 的 Codex Desktop 本地历史修复工具。 当你切换 API Key / provider / 登录方式 / model provider 之后，Codex Desktop 有时会出现一种很常见但很烦的问题: 本地对话历史实际上还在 /.codex 里，但左侧历史列表却突然空了。这个项目就是为了解决这个问题而写的。 它会读取当前 Codex 配置，分析本机历史数据库里的 threads 分布，然后把旧 provider 下的线程统一同步到当前正在使用的 provider ，同时自动备份，避免误操作。 这个项目解决什么问题 - 切换登录方式后，旧历史看不见 - 更换 model provider 后，侧边栏对话列表丢失 - 本地数据库仍在，但 UI 不再显示旧线程 - 想在同步前先看清当前历史分布，再决定是否执行修复 效果预览 Windows 图形界面 工作流程 核心能力 - 自动识别当前 Codex 配置中的 model provider - 统计本机历史线程属于哪些 provider - 一键同步旧 provider 的线程到当前 provider - 在同步前自动创建 SQLite 备份 - 支持从最新备份或指定备份恢复 - 同时提供 GUI 和 CLI 两种使用方式 适用场景 - 你切换了不同 API Key - 你切换了不同 provider - 你把登录方式从账号模式改成 API 模式，或反过来 - 你确认 /.codex 目录和本地数据库都还在 - 你只是“历史不显示”，而不是“历史已经被删” 不适用的场景 - 不同电脑之间迁移聊天记录 - 云端账号之间互相同步对话 - 本地 state 5.sqlite 已经被删除或损坏 - 你希望把多台机器的历史合并成一个仓库 技术实现概览 模块 作用 --- --- sync backend.py 读取配置、分析 SQLite、执行同步、备份与恢复 launch ui.ps1 提供 Windows WinForms 图形界面 assets/ 图标与界面配套素材 后端逻辑会优先从 config.toml 中读取 model provider ，必要时再结合 auth.json 与最近线程进行推断；数据库操作则通过 Python 的 SQLite 接口完成，并使用 SQLite 原生 backup 流程生成安全备份。 运行环境 - Windows 10 / 11 - PowerShell 5.1 或更高版本 - 已安装 Python，且可以通过 py -3 调用 - 本机存在 Codex Desktop 本地数据目录，通常为 %USERPROFILE%\\\\.codex 快速开始 方式一: 直接打开图形界面 适合第一次使用，界面会集中展示: - 当前 provider - 当前 model - 可移动线程数量 - provider 分布 - 备份列表 方式二: 创建桌面快捷方式 执行后会在桌面创建 Codex 对话同步工具.lnk ，以后双击即可使用。 方式三: 命令行模式 查看当前状态 执行同步 手动创建备份 从最新备份恢复 从指定备份恢复 典型使用步骤 1. 先关闭 Codex Desktop。 2. 运行 status 或打开图形界面，确认当前 provider 与历史分布。 3. 如果确认只是 provider 不一致，执行 sync 。 4. 重新打开 Codex Desktop 检查左侧历史是否恢复。 5. ","default_branch":null,"files":null,"tree":[],"storefront":"/r/LinYiXin123","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/LinYiXin123/codex-history-sync-tool/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."}