在 DeepSeek Harness (DSH) 的插件生態中，處理子代理任務通常採用一次性委託模式。如果需要與 Codex 保持長期上下文，或者希望 DSH 僅作爲透傳層而不介入中間推理，dsh-subagent-codex-plus 提供了基於“真網關”的直連方案。
插件定位¶
這是一個由 february2015 維護的插件，基於官方 @deepseek-ai/dsh-subagent-codex 派生。它保留了官方的一鍵委託能力，並在此基礎上增加了一個持久化的直連網關層。在這個模式下，DSH 不再運行中間模型，而是直接將字節流在用戶與 Codex 會話之間透傳。
與其兄弟插件 dsh-subagent-pi 類似，兩者共享相同的底層架構，僅直連對象不同（Codex 與 Pi），因此功能映射一一對應。
核心功能¶
1. 真網關直連¶
通過本地命令將當前 DSH 會話 1:1 綁定到一個持久的 Codex 線程。
* 命令：/codex-lock
* 特性：DSH 僅作爲透傳層。綁定後輸入直達 Codex。
* 持久化：關閉或重啓 DSH 後，重新打開會話會自動重連到同一個 Codex 線程，無需手動操作。
* 限制：一個 Codex 線程只能綁定到一個 DSH 會話。
2. 持續對話：隊列與直接插入¶
- 自動排隊：當 Codex 正在處理時，新消息會自動進入隊列。
- 原生管理：隊列消息會立即出現在原生編輯器的隊列條帶中，支持查看、編輯、刪除和引導。
- 執行順序：當前回合結束後，隊列中的消息按順序執行。
- 直接插入：通過浮動面板可以直接插入消息，使其在下一個回合優先執行。
3. 實時中間輸出¶
Codex 的執行進度（推理摘要、消息增量、工具調用、狀態事件）會以近乎實時的方式顯示在 DSH 會話中，而不僅僅是最終答案。默認爲只讀顯示，不會進入 DSH 的模型上下文。
* 心跳機制：長工具調用會顯示心跳（例如 正在執行 <tool>），並在運行超過 1 分鐘後顯示已運行時長，避免界面看起來像卡死。
4. 狀態顯示¶
綁定成功後，會話頭部會出現 CDX-xxxx 標識（包含狀態色點與線程 ID 前綴），編輯器停靠欄會顯示“Codex 直連 · …”。未綁定時界面保持整潔。
5. 圖片/附件透傳¶
支持直接粘貼或上傳圖片給 Codex。如果 Codex 模型本身具備視覺能力，它會正常處理；若遇回退情況，由 TeamAI 技能 ocgw-vision 處理。
6. 委託與網關共存¶
一個 DSH 對話中可以同時包含多次模型觸發的“一次性委託”運行，以及最多一個用戶附加的網關會話。兩者可以自由切換。
安裝與啓用¶
在確認路徑正確後，使用以下命令安裝插件並啓動對應 Profile：
dsh plugin --profile <name> add /path/to/dsh-subagent-codex-plus
dsh --profile <name>
典型用法¶
- 打開任意一個 DSH 會話（當前目錄即爲項目目錄）。
- 輸入
/codex-lock。綁定成功後，頭部會出現CDX-xxxx標識，輸入框的內容會直接發送給 Codex。 - 當 Codex 正在處理時，新消息會自動進入隊列，顯示在原生的消息隊列條帶中，支持編輯、刪除和引導。當前回合結束後按順序執行。
- 輸入
/codex-unlock斷開連接。Codex 線程會被保留，隨時可以重新綁定。
適用場景與注意事項¶
- 適用場景：適合需要與 Codex 保持長對話上下文、需要精細控制對話流程（通過隊列引導）的開發者。
- 版本依賴：插件依賴 DeepSeek Harness 的客戶端運行時與連接組件（
dsh-client-*）。 - 權限：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
總結¶
dsh-subagent-codex-plus 爲 DSH 用戶提供了與 Codex 建立持久化、可控對話的能力。如果你習慣於 Pi 的直連體驗但需要使用 Codex 模型，或者需要 DSH 充當純透傳網關，該插件提供了直接的解決方案。
