前言¶
DeepSeek Harness (DSH) 負責聊天界面，Codex CLI 負責任務執行與原生歷史。傳統的橋接方案往往需要引入第二個 AI 來轉述或模擬上下文，導致延遲增加且歷史記錄不完整。本插件實現了 DSH 與 Codex CLI 的直連：DSH 僅作爲客戶端展示層，Codex CLI 作爲宿主層，消息直接進入 Codex 的原生 turn，界面渲染的每一個字都由 Codex 自己推送的協議幀生成。
核心功能¶
- 打開舊對話：支持查詢線程列表、讀取歷史並恢復會話。
- 新建任務：創建原生 Codex 線程，可指定工作目錄、模型和權限策略。
- 發送消息：消息直接進入 Codex 的
turn/start，無中間轉發。 - 流式輸出：實時接收並渲染 Codex 的協議幀。
- 工具展示：顯示命令執行、文件變更、工具調用等通知。
- 停止任務：通過
turn/interrupt真正中斷執行。 - 審批與提問：界面接收服務端請求，用戶選擇後回傳。
- 刷新與重啓：支持斷線重連和關聯持久化。
安裝與啓用¶
前置條件：
* DeepSeek Harness（帶 Web GUI：桌面端或 dsh web）。
* Codex CLI（已登錄態）。
* Node.js 18+。
安裝步驟：
1. 執行安裝命令：
dsh plugin --profile desktop add git+https://github.com/447662/dsh-native-codex-cli.git
- 必須重啓 DSH。profile 的 bundle 列表不會熱加載，安裝後需重啓才能激活插件。
典型用法¶
插件提供多種交互入口：
- 會話綁定：在 DSH 會話中輸入
@Codex <任務>，或點擊輸入框右側的 Codex 按鈕。 - 接管輸入：綁定後，該會話的輸入框被 Codex 接管，後續消息無需再寫
@Codex，全部直接進 Codex。 - 獨立工作臺：點擊側邊欄的 Codex 圖標，進入獨立的線程列表、新建任務、對話流和輸入管理界面。
配置與排查¶
配置文件：~/.dsh/storages/dsh-native-codex-cli/config.json
插件不導出 Config schema 以避免 Cordis 驗證錯誤，若配置文件缺失或損壞，會自動使用代碼默認值。
排查建議：
* 插件日誌位於 ~/.dsh/logs/dsh-native-codex-cli.log。
* Codex CLI 不強制依賴 PATH，會自動在常見路徑（如 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin）查找。
* 若安裝後未生效，檢查日誌中是否有 [boot] module imported、[host] ... loaded 等標記。
適用場景¶
適合需要在 DSH 中通過熟悉的聊天界面直接驅動 Codex CLI 的開發者。插件以當前 DSH 進程權限運行，使用前建議檢查源碼與許可證（MIT）。
總結¶
該插件通過直連協議，讓 DSH 的聊天界面成爲 Codex CLI 的操作面板，實現了“界面由 DSH 管理，執行由 Codex 負責”的架構，避免了二次 AI 的開銷。
資源：
* GitHub: https://github.com/447662/dsh-native-codex-cli
* 生態目錄: https://www.skillhub.cn/plugins/447662/dsh-native-codex-cli
