[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2111":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},2111,"codex-history-sync-tool","GODGOD126\u002Fcodex-history-sync-tool","GODGOD126","Sync local Codex Desktop conversation history back to the current provider",null,"Python",333,32,126,5,0,21,45,149,63,94.56,"MIT License",false,"main",true,[],"2026-06-12 04:00:13","# Codex History Sync Tool\n\n一个用于恢复 Codex Desktop 本地历史对话显示的小工具。\n\n当你切换 API、provider、模型或登录方式之后，Codex Desktop 有时会出现“本地历史明明还在，但侧边栏看不到”的情况。这个工具会检查本机的本地历史数据库、会话文件和侧边栏索引，并把旧线程重新挂到当前正在使用的 `model_provider` \u002F `model` 下面。\n\n## 这个工具能做什么\n\n- 查看当前本机 Codex 历史线程属于哪些 provider\n- 查看当前本机 Codex 历史线程属于哪些 model\n- 一键把旧 provider \u002F model 下的线程、会话元数据和侧边栏索引同步到当前设置\n- Codex Desktop 正在运行时也可以同步；如果本地数据库正在写入，工具会等待空闲后继续\n- 在同步前自动备份数据库、侧边栏索引和会话元数据\n- 从备份恢复数据库\n- 提供一个可直接点击的 Windows 图形界面\n\n## 适用场景\n\n- 你切换了不同 API\n- 你切换了不同 provider\n- 你切换了不同模型\n- 你切换了登录方式\n- 你确认本地历史文件还在，但 Codex Desktop 左侧历史列表变空了\n\n## 不适用的场景\n\n- 云端账号之间的聊天记录互相同步\n- 本地历史文件已经被删除\n- 不同电脑之间迁移聊天记录\n\n## 运行环境\n\n- Windows\n- PowerShell 5.1 或更高版本\n- 已安装 Python 3.10 或更高版本，并可通过 `py -3` 调用\n- 本机存在 Codex Desktop 本地数据目录，通常是 `%USERPROFILE%\\\\.codex`\n\n## 快速使用\n\n### 图形界面\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\launch_ui.ps1\n```\n\n### 创建桌面快捷方式\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\launch_ui.ps1 -InstallShortcutOnly\n```\n\n### 查看当前状态\n\n```powershell\npy -3 .\\sync_backend.py --json status\n```\n\n### 执行同步\n\n```powershell\npy -3 .\\sync_backend.py --json sync\n```\n\n### 手动创建备份\n\n```powershell\npy -3 .\\sync_backend.py --json backup\n```\n\n### 从最新备份恢复\n\n```powershell\npy -3 .\\sync_backend.py --json restore\n```\n\n### 运行测试\n\n```powershell\npy -3 -m unittest discover -s tests -v\n```\n\n## 备份说明\n\n- 每次同步前都会自动创建一份备份\n- 每次恢复前也会先创建一份安全备份\n- 备份默认保存在 `%USERPROFILE%\\\\.codex\\\\history_sync_backups`\n- 新版备份会同时保存 `session_index.jsonl` 和会话文件首行元数据，恢复时会一起还原\n\n## 使用建议\n\n- Codex Desktop 开着也可以同步；如果它正在生成回复或保存历史，工具可能会等待几秒\n- 恢复备份会覆盖当前状态，最稳妥的做法仍然是在恢复前暂停正在运行的 Codex 任务\n- 如果同步完成后历史列表没有立刻刷新，重开一次 Codex Desktop 即可\n- 新版 Codex 可能还会按当前项目目录显示历史。如果同步后仍然看不到旧对话，先确认是否打开了旧对话原来的项目目录；本工具默认不会批量改写线程的 `cwd` 项目归属。\n\n## 项目文件\n\n- `sync_backend.py`：后端同步、备份、恢复逻辑\n- `launch_ui.ps1`：Windows 图形界面\n\n## 免责声明\n\n这个工具直接操作本机 Codex 的本地状态数据库。虽然已经做了自动备份，但仍建议你在使用前先理解它的作用，并自行确认本地数据目录状态。\n","Codex History Sync Tool 是一个用于恢复 Codex Desktop 本地历史对话显示的小工具。它能够检查并同步本机的本地历史数据库、会话文件和侧边栏索引，确保旧线程重新挂载到当前使用的 `model_provider` \u002F `model` 下。该工具支持查看当前本机 Codex 历史线程的 provider 和 model，并提供一键同步功能，即使在 Codex Desktop 运行时也能安全操作。此外，它还具备自动备份与恢复功能以及一个可直接点击的 Windows 图形界面。此工具适用于用户切换 API、provider、模型或登录方式后，发现 Codex Desktop 左侧历史列表为空的情况，但不适用于云端账号间的聊天记录同步或不同电脑间迁移聊天记录。",2,"2026-06-11 02:48:10","CREATED_QUERY"]