將本機 Codex 對話匯出成 .handoff.json 的 Windows x64 工具。
支援整個專案或一條無專案的獨立對話，提供彩色 Console、即時進度與原生資料夾選擇器。
這是非官方社群專案，並非 OpenAI 的產品，也未獲 OpenAI 背書。
- 無人值守的
--project-id ... --yes匯出，改為在寫入前複查本次專案的主對話、子代理、實體 Rollout、標題與專案身分；新增的目標對話／續接會拒絕使用舊掃描結果，避免無聲漏匯。 - 其他專案的 Rollout、標題、附件及 SQLite WAL 變更，不再單憑全域雜湊差異阻擋本專案匯出。實際由本次來源讀取的附件檔案仍會檢查前後一致。
- 若 Codex 尚未寫出可辨識的新 Session，匯出器無法預知它將出現；本次修正不宣稱能繞過 Codex 保存延遲，亦不會忽略本專案仍在更新的來源。
- 首頁獨立對話將以全域狀態中的
projectless-thread-ids與現行 SQLite Thread 索引交集判定顯示；資料庫中找不到或已封存的殘留 ID 不再列出，且不修改 Codex 原始狀態。明示--project-id／--thread-id的匯出路徑保持原有來源安全檢查。 - Windows 11 x64 已完成 174 項 Rust 單元測試、七組合成端到端測試及首頁對話清單實機核對；剛結束對話的即時匯出已有初步正常回報，仍受 Codex Session 寫入時序限制。
- 多段
history_base續接改依實體 Rollout ID 對應父檔，並在該父檔驗證相對位元組 Offset 與邏輯 Ordinal，不會錯把 Offset 套用到整條已合併歷史。 - 單次實際僅輸出一份 Handoff 時，允許目的地存在其他對話的 Handoff；既有輸出清理仍限本次目標。遇到同名異對話、損壞檔案、無法辨識的目標或不安全連結仍拒絕覆寫／清理。多份輸出情境維持原有保護。
- 本次兩項修正已先由 2.0.1 修正候選版通過 Windows 171 項 Rust 測試及七組合成 EXE 端到端測試；實際出錯的主對話也已由使用者回報成功匯出。正式 2.0.2 版本仍須以 2.0.2 自身的 CI、建置與發行驗收結果為準。
在本儲存庫的 Releases 下載 Windows x64 套件：
Codex-Conversation-Handoff-Exporter-2.0.3-windows-x64.zip
解壓後執行 Codex-Conversation-Handoff-Exporter.exe。
EXE 不依賴固定安裝目錄、捷徑的「開始位置」或相鄰資源檔，可以移至自己偏好的位置。
一般使用不需 Python、Rust、Windows SDK 或 .NET；C/C++ 執行階段及 Cargo 管理的 Zstandard 解碼器採靜態連結。
Windows 自帶的系統 DLL 仍為必要元件。重新散布時請保留套件內的授權聲明。
平台範圍：僅支援 Windows x64（x86-64／AMD64）。 2.0.0 已通過 Windows 11 x64 發行驗收；2.0.1 已完成 Windows x64 發行驗收。不發布 Windows 32 位元、ARM64、Linux 或 macOS 版本。 其他 Windows 版本尚未完成驗證。EXE、Codex 資料、系統暫存目錄與輸出位置仍受 Windows 存取權限限制。
- 沒有指定來源時，以數字選擇一個側邊欄專案或獨立對話，再按 Enter。
- 沒有指定目的地時，確認頁等待 3 秒，自動開啟一次資料夾選擇器。
- 選好資料夾後，輸入
E並按 Enter 才開始匯出；完成後輸入Q並按 Enter 離開。
| 指令 | 功能 |
|---|---|
| 數字＋Enter | 選擇清單項目 |
F＋Enter |
選擇／更換輸出資料夾 |
E＋Enter |
確認開始匯出 |
B＋Enter |
返回來源選單 |
Q＋Enter |
在選單、確認或結果頁離開 |
英文字母不區分大小寫。取消資料夾選擇不會開始匯出或反覆彈窗。
即使來源與目的地均由參數指定，預設仍須 E＋Enter。
匯出進行中不提供 Q 中止，以免產生不完整結果。
在 PowerShell 中，將範例的 ID 換成自己的 Codex ID；它不是專案名稱或目錄名稱。
# 來源、目的地已指定，仍保留人工確認。
.\Codex-Conversation-Handoff-Exporter.exe `
--project-id "YOUR_PROJECT_ID" `
--output-directory "C:\Exports\MyProject"
# 只指定一條獨立對話，目的地由資料夾選擇器取得。
.\Codex-Conversation-Handoff-Exporter.exe --thread-id "YOUR_THREAD_ID"
# 明確免確認。來源與目的地必須同時提供。
.\Codex-Conversation-Handoff-Exporter.exe `
--project-id "YOUR_PROJECT_ID" `
--output-directory "C:\Exports\MyProject" `
--yes
# 唯讀列出登錄的專案 ID（可能包含未出現在側邊欄的專案）。
.\Codex-Conversation-Handoff-Exporter.exe --developer-mode --list-projects
.\Codex-Conversation-Handoff-Exporter.exe --help
.\Codex-Conversation-Handoff-Exporter.exe --versionWindows 捷徑的「目標」可使用：
"C:\Tools\Codex-Conversation-Handoff-Exporter.exe" --project-id "YOUR_PROJECT_ID" --output-directory "C:\Exports\MyProject"
這些路徑只是範例。來源 ID 和目的地可以分別提供；缺少的資訊由互動介面取得。
--project-id 與 --thread-id 互斥，一次只能匯出一個目標。
--yes 不會略過來源、續接或輸出目錄的安全檢查。
非互動環境必須使用完整參數及 --yes，不會悄悄選用固定專案。
進階診斷以 --developer-mode --help 查看。
只有明示 --developer-mode 才啟用工程 CLI；正式寫入仍須明確來源與目的地。
一般模式會忽略已知的無害調校旗標，但對 --no-write、資料來源覆寫等具有行為影響的開發者旗標安全拒絕，不會忽略後意外改成正式寫入。
預設讀取目前使用者的 %USERPROFILE%\.codex；
有設定絕對路徑的 CODEX_HOME 時優先使用該位置，與 EXE 所在位置無關。
首頁選單只讀側邊欄狀態與必要標題，不預先解析整個專案；若有 Codex SQLite Thread 資料庫，首頁亦以輕量唯讀查詢排除已不在資料庫或已封存的獨立對話。沒有 SQLite 資料庫時沿用既有狀態清單相容模式。
按 E 後才驗證選定目標及讀取 Session。側邊欄狀態、索引或本機紀錄缺失時，
程式會明確失敗，不會猜測其他 ID、固定路徑或對話歸屬。
- 專案： 匯出該專案符合成員規則的全部主對話，不限於側邊欄當下展開的幾條。
- 獨立對話： 只匯出該邏輯主對話，不提供專案內任意單條對話的首頁選項。
- 支援
.jsonl、.jsonl.zst、Worktree，以及可驗證的history_base多檔續接。 - 真正子代理及可辨識附件沿用匯出器的整合規則；Guardian 不當成一般主對話。
- 不讀取封存目錄來擴大匯出範圍，不會把磁碟裡的所有殘留 Session 列為可選。
每條邏輯主對話產生一份 JSON，保留對話 ID、訊息及相關匯出資料。 Handoff 不是 Codex 原始資料夾備份，也不是可匯入 Codex 的官方格式。 它可能包含完整對話、工具輸出、附件內容及本機路徑，分享前請自行檢查。
專案檔名一律帶數字前綴，位數由本次主對話總數決定：1～9 份為 1.，
10～99 份為 01.，100～999 份為 001.。只有一條對話的專案仍保留 1.。
獨立對話不加編號。兩種模式均保留標題清理及 GMT+8 更新時間戳規則。
每次匯出會完整重寫本次目標的 Handoff，並整理屬於同一目標的過期輸出。 選擇的資料夾就是實際輸出位置，不會自動新增專案子資料夾。 若本次實際只會產生一份 Handoff（單一主對話的專案或獨立對話），允許資料夾內已有其他對話的有效 Handoff；它們不會因此被覆寫或清理。 若本次會產生多份 Handoff，仍要求資料夾內既有 Handoff 都屬於本次目標。 任何模式下，預定輸出的檔名若已被不同對話占用，或既有 Handoff 損壞、身分不明、檔案是不安全的連結／重新解析點，仍會在寫入前拒絕；沒有「強制覆寫所有檔案」選項。 不修改 Codex 原始來源資料。
請在 Windows x64 安裝 Rust 1.98.0 或更新版本的 MSVC 工具鏈， 以及 Visual Studio C++ Build Tools（MSVC x64 工具集與 Windows SDK）。 正式發行驗收使用 Rust 1.98.0；更新工具鏈仍須自行測試相容性， 並於重新散布前核對對應的標準函式庫授權聲明。
在含有 Cargo.toml 的專案根目錄執行：
cargo build --release --locked
cargo test --locked首次建置需要網路取得 Cargo.lock 鎖定的相依套件。Zstandard 原生 C 程式碼由 Cargo 的 zstd-sys 相依套件提供並靜態編譯，不需要本儲存庫內的 third_party/。
公開來源不包含 vendor/ 或 third_party/，也不需要本專案的內部 Python／BAT 驗收工具。
.cargo/config.toml 選定 x86_64-pc-windows-msvc 並啟用靜態 CRT，
不使用 target-cpu=native。不要移除這個設定後仍假定執行檔沒有 VC Runtime 相依。
產物位於：
target\x86_64-pc-windows-msvc\release\Codex-Conversation-Handoff-Exporter.exe
Codex 正在執行任務時能匯出嗎？ 不需要先關閉 Codex。 匯出結果對應本輪實際讀到且通過檢查的資料，不保證涵蓋匯出結束後才新增的訊息， 也不宣稱跨所有檔案具備單一時間點的原子備份。 資料改寫或來源身分衝突仍可能讓本輪安全停止。
為什麼選單有項目，匯出時卻失敗？ 選單是側邊欄候選清單； 原始紀錄可能尚未落盤、已缺失，或來源格式不相容，正式解析在確認開始後才執行。
程式很快關閉／自動化卡住？ 在 PowerShell 中執行可保留輸出。
無人值守使用 --yes 並明確提供來源與目的地；正常互動模式在結果頁等待 Q＋Enter。
執行時間超過 3 秒算失敗嗎？ 不算。一般模式顯示實際耗時； 成功為結束碼 0，參數錯誤或真正匯出錯誤為非零。
Codex 本機狀態檔不是本專案控制的穩定公開介面，未來版本改變可能需要更新解析器。 寫入途中遇到磁碟／權限錯誤時，不保證整批回滾，請依錯誤訊息檢查可能的部分輸出。 未簽章執行檔可能受到 Windows 安全性原則攔截；請確認下載來源及 SHA-256，不要關閉系統防護來繞過未知警告。
主程式：MIT。相依套件、Zstandard 與 Noto Emoji 圖示保留原授權， 詳見 THIRD_PARTY_NOTICES.md。