前言¶

在 OpenAI Codex 裏做項目，往往會積累三類資產：按工作區組織的對話歷史、放在 ~/.codex/skills 下的自定義 Skills，以及寫在 ~/.codex/config.toml 裏的 MCP 工具鏈。切換到 DeepSeek Harness（DSH）時，常見問題是會話格式不兼容、Skills 和 MCP 要在兩邊各配一遍，遷移腳本多半隻能單向拷貝，DSH 裏續寫的對話也很難再帶回 Codex。

dsh-codex-sync（維護者 Walvez，GitHub 倉庫 Walvez/dsh-codex-sync）定位不是一次性遷移工具，而是 Codex 與 DSH 之間的持續雙向橋接。它在 DSH 插件市場分類爲「工作流」，當前 npm 包版本爲 1.5.7，MIT 許可證，要求 Node.js >= 20。

這是什麼¶

一句話：dsh-codex-sync 在 Codex 與 DSH 之間提供項目級對話的雙向導入導出、將 ~/.codex/skills 即時掛載到 DSH Skills 目錄、自動鏡像 mcp_servers 配置，並可在 Codex 側安裝反向 MCP 以檢索和安裝 DSH 插件。

核心功能¶

雙向項目對話同步¶

從 Codex 導入 DSH

• 按工作區文件夾分組瀏覽 Codex 會話；
• 保留用戶提示、助手輸出、推理軌跡和工具調用記錄；
• 導入後自動關聯到匹配的 DSH 工作區，便於繼續對話；
• 支持增量重導入：Codex 側有新回合時標記爲 updated，只追加新內容，不重複建會話。

從 DSH 導出到 Codex

• 將 DSH 原生對話或續寫導回 Codex；
• 自動匹配 Codex 工作區目錄，未知目錄會鎖定以避免孤立線程；
• 以 history_mode: legacy 創建獨立 Codex rollout 和 SQLite 索引，不覆蓋原有 Codex 歷史；
• 重啓 Codex 應用後即可查看和繼續。

子 Agent 線程

• 默認隱藏內部子 Agent 線程，保持列表簡潔；
• 可按需展開，將子 Agent 嵌套在父線程下單獨導出。

即時 Skills 掛載¶

• 將 ~/.codex/skills/*/SKILL.md 直接註冊到 DSH 原生 Skills 目錄；
• 支持嵌套目錄和多文件 Skill 包；
• 磁盤上修改 Skill 文件後，下一輪對話即可生效，無需重啓。

MCP 雙向鏡像¶

• Codex → DSH：監聽 ~/.codex/config.toml，動態鏡像 [mcp_servers.*] 到 DSH，帶衝突規避和 stderr 靜默；
• DSH → Codex：通過 npx dsh-codex-sync codex-install 在 Codex 側註冊 [mcp_servers.dsh-plugins]，讓 Codex Agent 能搜索、查看和安裝 DSH 插件。

DSH 內原生 UI¶

• 工作區標題旁提供 Codex 快捷入口（側欄展開/收起時自適應位置）；
• 居中設置面板，含操作卡片、開關狀態和中英文切換；
• 樣式使用 DSH 設計令牌（--dsw-alias-*）。

內置 Agent Skill¶

插件自帶 codex-sync Skill，DSH Agent 可代爲執行同步任務，例如：

• 試運行導入：/import-codex --dry-run
• 查看 MCP 鏡像狀態：/mcp-status
• 開啓自動導入：/auto-import on

安裝與啓用¶

推薦通過 DSH 插件市場安裝：

dsh plugin --profile web add dsh-codex-sync

也可在 profile 的 cordis.patch.yml 中手動插入：

- insert:
    - id: codex-sync
      name: dsh-codex-sync
      config:
        maxSkills: 30
        mcpMirrorDeny:
          - node_repl
        mcpMirrorSilent:
          - exa

可選：在 Codex 側配置反向 MCP 橋接。

# 在 ~/.codex/config.toml 註冊 [mcp_servers.dsh-plugins]
npx dsh-codex-sync codex-install

# 運行健康檢查
dsh-codex-sync doctor

典型用法¶

安裝後，點擊側欄 Codex 圖標 打開同步設置面板。常用操作與配置項如下：

下面是一個常見工作流：

1. 安裝插件並打開側欄 Codex 設置，開啓 enableSkills 和 mcpMirror；
2. 執行 /import-all，按項目選擇要遷入 DSH 的 Codex 會話；
3. 在 DSH 中繼續開發；需要回 Codex 時執行 /export-codex；
4. 若要在 Codex 裏管理 DSH 插件，運行 npx dsh-codex-sync codex-install 完成反向橋接。

適用場景與注意¶

適合誰

• 同時在 Codex 和 DSH 之間切換，需要保留對話上下文；
• 已在 Codex 配置好 Skills 和 MCP，不想在 DSH 裏重複維護；
• 希望 DSH 續寫的內容能安全導回 Codex，而不是覆蓋原歷史。

使用前注意

• 插件以當前 DSH 進程的權限運行，會讀取 ~/.codex/ 下的配置、Skills 和會話數據；安裝前應閱讀 GitHub 源碼 並確認 MIT 許可證條款。
• 社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」理念，本插件屬於其中的工作流類擴展。
• 導出到 Codex 會創建新的 rollout 副本，不會修改原有 Codex 會話；導入支持增量更新，但首次使用前建議用 /import-codex --dry-run 預覽。

小結¶

dsh-codex-sync 把 Codex 與 DSH 之間的斷層收成一條可持續維護的通路：對話可雙向搬運，Skills 和 MCP 可隨磁盤配置即時同步，Codex 側還能通過反向 MCP 檢索 DSH 插件。若你正在評估從 Codex 遷到 DSH，或需要在兩個環境間來回切換，可以從插件市場安裝後，先用設置面板裏的導入試運行確認效果。

• 社區目錄：https://www.skillhub.cn/plugins/Walvez/dsh-codex-sync
• GitHub：https://github.com/Walvez/dsh-codex-sync