DeepSeek Harness (DSH) 提供了插件化的運行時環境。當開發者需要在 DSH 的上下文中直接利用 ChatGPT Codex 進行代碼生成、圖像創作或網絡檢索時，通常需要維護額外的 CLI 進程或處理複雜的跨進程通信。DSH Codex Adapter 插件通過適配器模式，將 ChatGPT 的能力直接集成到 DSH 的工作流中，提供統一的賬號管理與界面入口。
這是一個由 baixianger 維護的 DSH 插件，屬於模型推理類別。它的核心價值在於複用 ChatGPT 的 Codex 後端，支持流式回覆、圖像上下文傳遞，並提供了賬號登錄、用量監控和本地化設置界面，使開發者無需脫離 DSH 環境即可使用 ChatGPT 的能力。
核心功能¶
- 編碼對話：提供
openai-codex模型路由，支持流式回覆以及圖片上下文輸入。 - 賬號與用量管理：支持 ChatGPT 賬號登錄、CLI 登錄導入、取消操作及登出功能。支持查看計劃和用量窗口（當服務返回數據時）。
- 圖像生成：集成
imagegen工具，支持生成過程中的內聯預覽、尺寸設置、下載以及保存至工作區的狀態顯示。 - 參考圖像編輯：支持基於工作區中的圖片或最近的圖像附件進行編輯。
- Web 搜索：提供 Codex 搜索提供者，支持緩存、索引和實時三種搜索模式。
- 原生設置：提供完整的 Codex 設置頁面、緊湊的插件卡片，並支持亮/暗主題切換及中/英文標籤。
安裝與啓用¶
在安裝前，請確保你的環境滿足以下要求：
* DSH 版本 0.1.5 及以上（適配器接口版本）。
* Node.js 版本 22.19+ 或 24+。
如果環境中已安裝 dsh-codex 插件，由於兩者均佔用 openai-codex 路由，安裝前需要先移除舊插件：
dsh plugin --profile web remove dsh-codex
安裝新插件並啓動 Web 界面：
dsh plugin --profile web add dsh-codex-adapter@latest
dsh web
安裝完成後，打開 Settings → Codex 進行登錄配置。你可以通過瀏覽器或設備登錄 ChatGPT，也可以導入現有的 CLI 登錄憑證。登錄狀態由 DSH 的憑證服務統一管理。
典型用法¶
圖像生成
在對話中輸入提示詞，插件會通過 imagegen 工具處理請求。例如：
Generate one watercolor illustration of an orange cat by a sunny window, with a small green plant and no text. Save it as window-cat.png.
生成結果會以圖片卡片形式展示，包含尺寸、大小、下載按鈕及工作區保存狀態。生成的圖片作爲持久化附件，支持後續對話中的上下文引用。
Web 搜索配置
在 DSH 的配置文件中指定 Codex 作爲搜索提供者（DSH 的抓取提供者仍由 DSH 自身管理）：
# ~/.dsh/profiles/web/cordis.patch.yml
- id: web
config:
searchProvider: openai-codex
fetchProvider: http
狀態查詢
使用 CLI 命令查看插件狀態或導入憑證：
dsh plugin --profile web exec dsh-codex-adapter status
dsh plugin --profile web exec dsh-codex-adapter import
適用場景與注意¶
該插件適合需要將 ChatGPT 的編碼、繪圖和搜索能力嵌入到 DSH 工作流中的開發者。插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。
需要注意的是，該插件不實現快速模式、原生壓縮或 /codex 終端命令。生成的圖片僅在提供二進制寫入權限的遠程文件系統中支持保存至工作區，否則將作爲附件保留。
總結¶
DSH Codex Adapter 通過複用 pi-ai 庫的認證流和 DSH 的 PiAiAdapter 契約，實現了對 ChatGPT Codex 能力的無縫集成。它不僅提供了功能接口，還完善了賬號管理與設置界面，降低了在 DSH 中調用 ChatGPT 能力的門檻。更多詳情與反饋，請參考 GitHub 倉庫。
