前言¶

在 DeepSeek Harness（DSH）裏跑智能體，模型、工具和網絡能力通常靠各自插件拼裝。若你已有 OpenAI 的 ChatGPT 或 Codex 訂閱，卻還要單獨配置 API Key、再爲 GPT 對話、圖片生成和聯網搜索分別找方案，集成成本會偏高。

下面介紹的 @wnjxyk/dsh-codex-oauth 走 OAuth 登錄訂閱賬號，把 GPT 模型、生圖、web_search 和配額查詢接到 DSH 原生界面裏。維護者爲 WNJXYK，在 SkillHub 社區目錄歸類爲「模型推理」；GitHub 倉庫 WNJXYK/dsh-codex-oauth 當前約 14 stars、4 forks，許可證爲 MIT。插件在 DSH 0.1.0-rc.6 上做過驗證，npm 包版本爲 0.4.2，運行環境要求 Node.js >= 20。

這是什麼¶

dsh-codex-oauth 是面向 DSH Web 側的統一 OpenAI Codex 訂閱插件。它通過 OAuth 綁定 ChatGPT / Codex 賬號，激活 DSH 內置的 openai-codex 模型提供方，並按賬號權限動態加載可用 GPT 模型；同時註冊生圖工具與聯網搜索能力，並在界面中展示訂閱計劃、剩餘配額與重置時間。

SkillHub 目錄頁：https://www.skillhub.cn/plugins/WNJXYK/dsh-codex-oauth。SkillHub 是面向 Skills / 插件的社區目錄，與 DeepSeek 或幻方無官方從屬關係；安裝與文檔以 GitHub README 爲準。

核心功能¶

GPT 模型¶

插件激活 DSH 內置 openai-codex provider，從訂閱賬號側發現可用 GPT 模型，並在 DSH 模型選擇器裏提供專用控件。聊天模型由 DSH 內置 llm-pi-ai 插件提供的 openai-codex 模型源動態加載，無需手工維護模型列表。

圖片生成¶

註冊 generate_image 工具，支持多種尺寸與質量檔位，生成結果在對話界面中預覽展示。生圖編排默認使用 Codex Power 模型 gpt-5.6-sol，實際渲染走託管 GPT Image（image_generation）工具。

聯網搜索¶

將 DSH 原生 web_search 路由到託管 GPT 搜索，返回答案文本及帶來源 URL 的結構化引用。默認搜索模型同爲 gpt-5.6-sol，與 README 中 Codex Power 配置對齊。

訂閱配額與 OAuth¶

界面可查看計劃類型、剩餘配額、重置時間，以及 5 小時、每週等窗口限制（數據來自 https://chatgpt.com/backend-api/wham/usage）。OAuth 支持瀏覽器登錄與無頭設備碼授權，含自動續期、狀態刷新與登出；憑證默認寫入 $DSH_HOME/codex-oauth.json。

界面集成¶

插件注入 DSH 客戶端運行時與設置、對話、工具等 UI 模塊，跟隨 DSH 中英文與 Light / Dark / System 主題，符合 DSH 熱插拔插件設計。

安裝與啓用¶

DSH 生態遵循「一切皆插件」；Web 側安裝需帶 --profile web 與 -w 參數。任選 npm 或 GitHub 源之一即可。

從 npm 安裝最新版：

dsh plugin --profile web add -w @wnjxyk/dsh-codex-oauth@latest

從 GitHub 安裝：

dsh plugin --profile web add -w github:WNJXYK/dsh-codex-oauth

卸載（npm 與 GitHub 安裝方式相同）：

dsh plugin --profile web remove -w @wnjxyk/dsh-codex-oauth

安裝完成後，在 DSH 設置或插件提供的控制入口完成 OAuth 登錄；無圖形環境時可使用設備碼流程（README 中有 headless 登錄示意）。

典型用法與配置¶

默認使用¶

多數場景無需額外配置。登錄成功後，在模型選擇器裏挑選賬號可用的 GPT 模型即可對話；需要生圖或聯網時，通過 DSH 對話中的工具調用觸發 generate_image 與 web_search。

模型可見性與功能開關保存在 $DSH_HOME/codex-oauth-preferences.json，可在插件界面調整。

高級 Cordis 配置¶

若需自定義憑證路徑、OAuth issuer 或本地回調端口，可在 Cordis 中插入插件並傳入 config。下列示例來自 README，展示自定義 DSH 主目錄、憑證文件路徑及 Web 搜索模型：

- insert:
    - id: dsh-codex-oauth
      name: "@wnjxyk/dsh-codex-oauth"
      config:
        dshHome: /data/dsh
        path: /secure/codex-oauth.json
        preferencesPath: /secure/codex-oauth-preferences.json
        issuer: https://auth.openai.com
        usageUrl: https://chatgpt.com/backend-api/wham/usage
        controlPort: 1456
        redirectPort: 1455

    - id: codex-web-search
      name: "@wnjxyk/dsh-codex-oauth/web-search"
      config:
        model: gpt-5.6-sol

常用配置項說明：

適用場景與注意事項¶

適合誰¶

• 已有 ChatGPT / Codex 訂閱，希望在 DSH Web 界面內統一使用 GPT 對話、生圖與聯網搜索；
• 需要在 DSH 裏查看訂閱配額與重置窗口，避免超額使用；
• 希望在無瀏覽器的服務器側通過設備碼完成 OAuth，再在 DSH 中調用同一套能力。

風險與權限¶

README 明確說明：項目基於開源軟件構建，並依賴非公開的 ChatGPT Codex 後端接口。OpenAI 協議變更可能導致功能暫時不可用，需等待插件更新；另存在較低的賬號受限風險，使用前請自行評估。

插件以當前 DSH 進程權限運行，OAuth 憑證寫入宿主機文件。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認憑證路徑、迴環端口（默認 1455 / 1456）與部署環境相符。

結尾¶

@wnjxyk/dsh-codex-oauth 把 OpenAI 訂閱側的 GPT 模型、生圖、聯網搜索和配額查詢收攏到 DSH 一條 OAuth 鏈路裏，適合已訂閱且希望在 Harness 內原生使用 Codex 能力的開發者。目錄與源碼：

• SkillHub：https://www.skillhub.cn/plugins/WNJXYK/dsh-codex-oauth
• GitHub：https://github.com/WNJXYK/dsh-codex-oauth