前言¶

DeepSeek Harness（dsh）採用「一切皆插件」的思路，模型提供方、設置頁、命令等都可以通過插件擴展。如果你已經有 ChatGPT / Codex 訂閱，並希望在 dsh 中調用訂閱額度，這個插件提供了一條直接路徑。

dsh-llm-codex-oauth 由 Player-MINEPIG 維護，採用 MIT 許可證。它的作用是把 pi-ai 內置的 openai-codex provider（openai-codex-responses 線上協議）註冊爲 dsh LLM seam 的 codex-oauth 提供方，讓 dsh 可以在模型設置裏選擇 codex-oauth 提供方下的模型進行對話。

核心功能¶

訂閱模型接入¶

插件會註冊一個名爲 codex-oauth 的模型提供方。模型目錄隨所裝 pi-ai 版本維護，例如：

• gpt-5.3-codex-spark
• gpt-5.4
• gpt-5.5
• gpt-5.6-*

安裝後，具體可用模型以你當前安裝的 pi-ai 模型目錄爲準。

圖片輸入¶

Web 端粘貼或拖放圖片時，走 dsh 耐久附件，支持：

• PNG
• JPEG
• WebP
• GIF

只有模型目錄中聲明支持 image 的模型會接收圖片。read_image 等工具結果裏的圖片也會轉發到下一輪。

看圖需要 profile 掛載 attachments；web profile 默認有該能力。純文本模型或未掛載附件服務時，圖片請求會被拒絕。

PDF / Office 等非圖片文件不會作爲多模態塊發送。需要處理時，可以放入工作區後用文件工具讀取。

OAuth 登錄與憑據¶

登錄走 auth.openai.com，使用與 Codex CLI 相同的 OAuth client，採用設備碼登錄流程。該流程 headless 友好，無需本地回調服務器。

憑據處理如下：

• refresh token / access token 只存在 dsh 憑據庫 $DSH_HOME/.credentials.yaml。
• 該文件權限爲 0600。
• token 不進配置、不進會話日誌、不進本倉庫。
• access token 過期時，由 pi-ai 在串行化的寫路徑裏自動用 refresh token 續期。
• 登錄狀態中的設備碼僅存於進程內存，重啓後以憑據庫爲準。

設置頁與命令¶

設置頁提供「Codex 訂閱 (ChatGPT)」區塊，包含登錄 / 登出按鈕與即時狀態。

對話側保留只讀命令：

• /codex-status
• /codex-logout

多輪對話¶

插件完整保留 provider 原生回放元數據，例如簽名等，支持跨輪次多輪請求。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add file:/path/to/dsh-llm-codex-oauth

這裏的 file: 前綴必須保留。直接傳目錄路徑時，pnpm 會以 link: 方式安裝，可能導致 Node 按真實路徑解析插件內部依賴時找不到 node_modules。

如果 pnpm 11 的 ignored-builds 提示導致 dsh plugin 報 pnpm failed，可以把 profile 目錄中 pnpm-workspace.yaml 的 allowBuilds: 佔位值改爲 false，然後重跑同一條安裝命令。

安裝完成後，運行下面的命令驗證：

dsh --profile web --dump-config

如果通過 npx 臨時使用 dsh，也可以使用：

npx @deepseek-ai/dsh --profile web --dump-config

輸出中應能看到 llm-codex-oauth 行。

典型用法¶

1、重啓 dsh 後打開設置頁，在側欄選擇「Codex 訂閱 (ChatGPT)」。

2、點擊「登錄 ChatGPT 賬號」，按提示打開驗證網址、輸入設備碼，並登錄你的 ChatGPT 賬號。

3、狀態變爲「已連接」後，進入 Models 設置頁，把模型切到 codex-oauth 提供方下的某個模型。

4、需要登出時，可以回設置頁點擊「登出」，或在對話裏輸入 /codex-logout。隨時可用 /codex-status 查看狀態。

適用場景與注意¶

這個插件適合已經在 dsh 中使用插件體系、並且擁有 ChatGPT / Codex 訂閱的使用者。它主要解決「把訂閱額度接入 dsh 對話」的問題，並不提供圖片生成能力。

使用前需要注意以下限制：

• Codex ChatGPT 後端不接受 temperature、maxTokens、stop。
• temperature / maxTokens 會被靜默忽略。
• stop 仍會被拒絕。
• reasoningEffort 與 sessionId 會繼續下發。
• 插件不做圖片生成。
• PDF / Office 等非圖片文件不會作爲多模態塊發送。
• 模型目錄跟隨所裝 pi-ai 版本。

安全風險也需要明確：該插件調用未公開、官方不支持的 ChatGPT 網頁版後端 chatgpt.com/backend-api，存在違反 OpenAI 服務條款、賬號受限的風險。是否使用需要自行評估。

倉庫內不包含祕密。如果你要推送倉庫，確認 .gitignore 生效，永遠不要提交 $DSH_HOME/.credentials.yaml 或其中內容。

安裝前建議檢查源碼，並確認 MIT 許可證符合你的使用要求。啓用後，插件運行在當前 dsh 進程權限下。

結尾¶

dsh-llm-codex-oauth 的核心價值，是把 ChatGPT / Codex 訂閱通過 OAuth 設備碼登錄接入 dsh 的 codex-oauth 提供方，同時保留憑據隔離、圖片輸入、多輪迴放等必要能力。

GitHub 倉庫：

https://github.com/Player-MINEPIG/dsh-llm-codex-oauth

社區目錄是獨立站點，不應把它理解成官方應用商店；當前資料未提供可確認的目錄頁地址。