前言¶
DSH 的理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對同時使用 OpenAI Codex CLI 和 DSH 的開發者，常見需求是把 Codex CLI 的歷史對話導入 DSH，使其可瀏覽、可搜索、可繼續。dsh-codex-import 提供這一導入路徑。
這是什麼¶
dsh-codex-import 是一個 DSH 插件，倉庫爲 G1en-114/dsh-codex-import，許可證爲 MIT。
它把 OpenAI Codex CLI 的歷史對話導入 DeepSeek Harness (DSH)，成爲可瀏覽、可搜索、可繼續的 DSH 會話，並出現在對應 workspace 側邊欄。
它提供兩種形態：
- 宿主插件命令
- 獨立 CLI
核心能力¶
下面介紹已覈實的能力。
- 支持在 DSH 中執行
/codex-import <session-id>，把 Codex CLI 歷史會話導入爲 DSH 會話。 - 導入時保留用戶消息、助手回覆（
commentary+final_answer）、工具調用與輸出、turn/step結構和會話標題。 - 零運行時依賴，使用 Node >=22.20 內置
node:zlib的 zstd 支持寫入 DSH 標準會話文件。 - 寫入後進行自校驗：雙幀 zstd、header 單獨一幀、
seq連續、帶 checksum。 - 超大會話可自動壓縮最老 turn 爲摘要檢查點，也支持
--max-turns純截斷。 - Codex rollout 不保存
web_search_call輸出，導入時省略。
安裝與啓用¶
作爲 DSH 插件安裝時，使用下面命令：
dsh plugin --profile web add git+https://github.com/G1en-114/dsh-codex-import.git
這條命令會把插件加入 web profile。
git 安裝時，pnpm 會攔截 prepare 腳本；需要按報錯提示把包名加入下面配置文件的 allowBuilds，然後重跑安裝命令：
~/.dsh/profiles/web/pnpm-workspace.yaml
安裝完成後，重啓 dsh web 或刷新頁面。
作爲獨立 CLI 運行時，Node 版本要求如下：
Node >=22.20
插件命令形態運行在 DSH 進程內，README 稱無此限制。
典型用法¶
在 DSH 會話中，可用 session-id 導入：
/codex-import 019feec0-f565-7900-b985-1d6ba3b63a56
如果已有 rollout 文件，也可導入並指定會話 id 與 workspace 上下文：
/codex-import ~/rollout.jsonl --session-id session-my-import --cwd /mnt/e/cell
如果只想保留最近的 turn，可使用：
/codex-import 019feec0-... --max-turns 80
獨立 CLI 示例如下。--dry-run 用於試跑，--compact 用於在超預算時壓縮最老 turn：
dsh-codex-import --dry-run 019feec0-...
dsh-codex-import --compact 019feec0-...
dsh-codex-import ~/backup/rollout-2026-08-11.jsonl --cwd /mnt/e/cell
--compact 需要 DEEPSEEK_API_KEY 環境變量或下面憑據文件：
~/.dsh/.credentials.yaml
超大會話處理¶
導入完成後，之後每次對話會按完整歷史計費輸入 token；自動壓縮會把最老 turn 壓縮成摘要檢查點，這會消耗一次性 token。
如果只需要保留最近可繼續的部分，可優先使用 --max-turns 做純截斷；確實需要早期上下文時，再考慮自動壓縮。
適用場景與注意¶
- 適合有 Codex CLI 歷史會話，並希望繼續在 DSH 中瀏覽、搜索、繼續對話的開發者。
- 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。當前許可證爲 MIT。
- 重複導入同一個 Codex 會話會生成新的 session id；指定相同
--session-id會報錯。 package.json聲明 peerDependencies：
@deepseek-ai/cordis
@deepseek-ai/dsh-commands
@deepseek-ai/dsh-session-persistence
- 安裝後需重啓
dsh web或刷新頁面。
結尾¶
經過上面的步驟，dsh-codex-import 可以把 Codex CLI 歷史會話轉成 DSH 可繼續使用的會話，並保留消息、工具調用、turn/step 等結構。
GitHub 倉庫：
https://github.com/G1en-114/dsh-codex-import
目錄頁鏈接未在所提供資料中確認；可在 DSH 社區目錄中按名稱 dsh-codex-import 查找。
