前言¶
DeepSeek Harness (DSH) 採用模塊化插件架構，允許開發者擴展其功能。對於從 Codex 平臺遷移的開發者而言，如何延續對話歷史是一個具體需求。session-import-codex 旨在解決將 Codex App Server 對話記錄導入 DSH 的問題，確保歷史對話在新的環境中得以無縫銜接。
插件定位¶
這是一個 DeepSeek Harness 插件，由 xing01l 維護。它通過讀取 Codex App Server 的穩定歷史方法，將已完成的對話輪次轉換爲經過驗證的 DSH 會話事件。插件提供了 CLI 工具和 Harness 聊天命令兩種操作方式，支持一次性遷移和確定性 ID 生成。
核心功能¶
- 對話歷史導入：將 Codex 非歸檔交互會話導入 DeepSeek Harness。
- CLI 工具：提供命令行工具進行一次性遷移。
- 聊天命令回退：提供
/import-codex聊天命令作爲開發或針對性回退手段。 - 推理摘要處理：默認僅導入推理摘要，不導入原始推理內容。
- 確定性 ID：生成如
codex-<thread-id>的確定性目標 ID。 - 冪等性：支持冪等的 workspace 附加，重複運行不會重複創建會話。
- 環境要求：需要 Node.js
^22.19或>=24，pnpm 10，以及路徑中的codex命令。
安裝與啓用¶
通過 Harness 安裝插件，以更新目標 profile 的依賴和打包層：
dsh plugin --profile web add dsh-session-import-codex
典型用法¶
命令行遷移¶
插件提供了 CLI 工具進行遷移。支持 Dry Run 模式先驗證源歷史和目標衝突：
pnpm --dir "$env:USERPROFILE\.dsh\profiles\web" exec dsh-import-codex --profile web --dry-run
執行實際遷移：
pnpm --dir "$env:USERPROFILE\.dsh\profiles\web" exec dsh-import-codex --profile web
聊天命令¶
在 DSH 聊天界面中，可以使用 /import-codex 命令：
- /import-codex <thread-id>：導入指定會話 ID。
- /import-codex --all：導入所有符合條件的會話。
注意事項¶
- 離線寫入工作流：插件不支持直接寫入 Harness 持久化文件。支持的寫入工作流是離線的，需要先停止
dsh --profile web進程，執行遷移後，再重啓 Web profile。 - 隱私安全：插件不會讀取 Codex 滾動文件、桌面狀態、SQLite 數據庫或私有 JSONL 文件。它也從不直接寫入 Harness 持久化文件。
- 許可證：插件遵循 MIT 許可證。
總結¶
該插件爲開發者提供了從 Codex 遷移對話歷史到 DeepSeek Harness 的能力。通過 CLI 工具和聊天命令，開發者可以方便地將歷史會話導入 DSH，並利用確定性 ID 和冪等性設計確保遷移過程的安全與可重複。
