DeepSeek Harness (DSH) 的插件機制允許開發者按需擴展功能。在處理多模型路由時，直接爲 ChatGPT Codex 添加認證能力有時需要額外的模型適配器。@sipi/dsh-openai-codex-auth 插件旨在解決這一場景，它通過提供 OAuth 存儲和交互式認證控制器，在不引入額外模型適配器的情況下，爲 pi-ai 路由增加設備代碼登錄支持。
插件介紹¶
該插件由 z331225718 維護，是一個獨立版本化的安裝包。它主要負責存儲 OAuth 憑證並註冊 openai-codex 交互式認證控制器，使得用戶可以在 Models 頁面直接使用 ChatGPT 的設備代碼登錄方式。
核心功能¶
插件提供以下能力：
* 提供 OAuth 存儲。
* 提供 openai-codex 交互式認證控制器。
* 在 Models 頁面支持 ChatGPT 設備代碼登錄。
* OAuth 請求在 DSH Node 進程中運行。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add @sipi/dsh-openai-codex-auth
安裝成功後，插件會插入一個 openai-codex-auth 配置行。若要卸載該插件及其憑證貢獻，不改變基礎適配器，可執行：
dsh plugin --profile web remove @sipi/dsh-openai-codex-auth
典型用法¶
安裝後，Models 頁面會提供 ChatGPT 設備代碼登錄入口。OAuth 請求在 DSH Node 進程中執行。
在 Node 24 環境中，如果需要使用代理環境變量，需設置以下環境變量：
NODE_USE_ENV_PROXY=1
若需自定義 OAuth 存儲位置，可配置 path 或 dshHome。例如：
- id: openai-codex-auth
name: '@sipi/dsh-openai-codex-auth'
config:
dshHome: ~/.dsh
適用場景與注意¶
該插件僅支持 OpenAI 的設備授權方式。它依賴 @deepseek-ai/dsh-llm-pi-ai 目錄暴露 openai-codex OAuth，否則激活會失敗。
在使用過程中需注意以下事項：
* Node 版本依賴：在 Node 24 中，OAuth 代理環境變量需要 NODE_USE_ENV_PROXY=1（或 --use-env-proxy）。
* 文件權限：POSIX 文件以 0600 模式原子替換；Windows 用戶需保護 DSH_HOME 的 ACL。
* 數據隔離：瀏覽器 RPC 狀態不包含令牌或原始提供者響應。
* 啓動依賴：開發或使用時需確保 pi-ai 目錄已暴露 openai-codex OAuth。
總結¶
該插件爲 DSH 用戶在不增加模型適配器的情況下，提供了一套完整的 OpenAI Codex 設備登錄解決方案。相關源碼與目錄信息請訪問：
