在構建或遷移智能體工作流時，積累的配置（MCP 服務器、技能、全局指令）往往難以直接複用。DeepSeek Harness (DSH) 作爲一個插件化架構，需要將舊有環境（如 OpenAI Codex CLI / Desktop）的資產適配進來。直接手動遷移不僅繁瑣，還容易遺漏細節。
codex2dsh 是一個 DSH 插件，由 BigBlueBaby 維護。它將 Codex 的 MCP 服務器、技能、全局配置、記憶以適配 DSH 的形式遷移進來。
核心功能¶
- 可視化遷移面板：提供圖形化界面，用於查看狀態、選擇遷移項和執行操作。
- MCP 鏡像生成：解析 Codex 的 MCP 服務器配置，生成可合併的 YAML 文件。
- 技能轉換：將 Codex 的技能文件轉換爲 DSH 格式。
- 全局指令適配：適配
AGENTS.md等全局指令文件。 - 記憶遷移與導入：遷移 Codex 記憶，並支持導入至
dsh-mnemon引擎。 - 會話導入與標題回填：導入會話歷史，並修復可能丟失的標題信息。
- 工作區歸組：整理非工作區會話，統一歸組。
- 遷移體檢：檢查遷移狀態和資產完整性。
安裝¶
安裝插件：
dsh plugin --profile desktop add codex2dsh
安裝後重啓 DSH，即可在「設置 → 插件」中找到「Codex 遷移」面板。
典型用法¶
可視化操作¶
- 打開 設置 → 插件。
- 找到 「Codex 遷移」 標籤頁。
- 通過面板進行可視化操作，查看狀態、預覽或執行遷移。
命令行操作¶
codex2dsh preview # 預覽可遷移資產
codex2dsh mcp --apply # 執行 MCP 遷移
codex2dsh doctor # 檢查遷移狀態
注意事項¶
- 源碼安全：源碼只讀，不修改 Codex 配置。
- 密鑰處理：密鑰默認原樣遷移（可脫敏），請勿提交公開倉庫。
- 執行策略：默認 dry-run 預覽，確認後執行。
- 配置合併：MCP 服務器配置需手動合併進 profile。
- 環境要求：僅支持 Node.js >= 22.13。
總結¶
該插件提供了從 Codex 到 DSH 的無縫資產遷移路徑，適合需要保留舊有配置的開發者。
