DeepSeek Harness 插件：接入 OpenAI Codex (ChatGPT Plus/Pro OAuth)

前言¶

DeepSeek Harness (DSH) 採用插件架構。ddll8023/dsh-codex 是一個 DSH 插件，允許用戶通過 ChatGPT Plus/Pro OAuth 直接接入 OpenAI Codex 模型。它不依賴 DeepSeek API Key，解決了需要使用 Codex 模型但不想配置 DeepSeek Key 的場景。

核心功能¶

接入 Codex 模型：不依賴 DeepSeek API Key，通過 OAuth 登錄。
登錄方式：支持瀏覽器 OAuth 登錄和 Device Code 無瀏覽器登錄。
模型與輸入：模型選擇器自動發現 Codex 模型，支持文本流、工具調用和圖片輸入。
Fast 模式：聊天輸入框可按會話在 Standard 與 Fast 間切換。
原生網絡搜索：支持 Codex Native Web Search。
憑證與用量：憑證使用 DSH 自身憑證服務保存，自動刷新；用量顯示通過 /codex status 和 /codex usage。

安裝與啓用¶

適配目標爲 DSH Desktop 0.1.7-rc.2 包系列。
推薦使用 dsh plugin 安裝：

dsh plugin --profile web add github:ddll8023/dsh-codex

安裝後重啓 dsh web。驗證是否啓用：

dsh --profile web --dump-config | grep -A2 llm-codex

啓用後模型選擇器中會出現 OpenAI Codex Provider。

配置項¶

通過 Host 插件設置表單編輯，或放入 profile 中 llm-codex 條目的 config 對象。

baseURL: https://chatgpt.com/backend-api
modelCatalogClientVersion: "0.157.0"
transport: sse
cacheRetention: short
nativeWebSearch: true
webSearchMode: live
refreshLeadTimeMs: 300000
streamIdleTimeoutMs: 300000
retryPolicy:
  mode: normal
  maxRetries: 2

命令行使用¶

登錄相關：
* /codex login：瀏覽器 OAuth 登錄（Authorization Code + PKCE，回調 http://localhost:1455/auth/callback）。
* /codex login --device：無瀏覽器環境的 Device Code 流程（顯示設備碼與驗證 URL）。
* /codex logout：刪除本地 OAuth 憑證。
* /codex cancel：取消進行中的登錄。
用量與狀態：
* /codex status：登錄狀態、賬號 ID、token 有效期及當前配額用量。
* /codex usage：只查詢並顯示當前賬號配額用量（5h/每週/Spark 子額度，含重置倒計時）。
模式切換：
* /codex speed standard：將當前會話切回 Standard。
* /codex speed fast：將當前會話切換爲 Fast。

安全與注意事項¶

憑證安全：憑證保存在 DSH 自身憑證服務（ctx.credentials，即 $DSH_HOME/.credentials.yaml），文件權限 0600，熱加載、串行寫入。Token 永不進入日誌、session 事件、telemetry 或錯誤信息。
Key 分離：DeepSeek 的 API key 與 Codex token 互不干擾。
配置衝突：不要在 llm-pi-ai.providers 中添加 openai-codex，這會激活宿主的另一套適配器並與本插件衝突。
適配版本：適配目標爲 DSH Desktop 0.1.7-rc.2 包系列。

結尾¶

該插件通過 OAuth 接入 Codex，提供了原生 Fast 模式和網絡搜索能力，並解決了憑證管理與用量監控問題。更多細節可參考 GitHub 倉庫。