DeepSeek Harness 插件：dsh-llm-openai-codex

前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在本地模型推理或智能體開發中，調用 OpenAI Codex 是常見需求。現有的 DSH 插件通常依賴 API Key 進行鑑權，而 OpenAI Codex 後端基於 OAuth 機制，沒有 API Key 可用。dsh-llm-openai-codex 插件解決了這一衝突，它複用 pi-ai 的通用請求 machinery，將 ChatGPT 的 OAuth 訪問令牌作爲鑑權憑證，從而在 DSH 中使用 Codex 模型。

插件概覽¶

• 名稱：dsh-llm-openai-codex
• 類型：模型推理
• 維護者：auggie246
• 許可證：MIT
• 核心能力：
  • 爲 DSH 添加 openai-codex 路由。
  • 使用 OAuth 登錄，無需 OPENAI_API_KEY。
  • 支持自動令牌刷新。
  • 支持自動模型發現。
  • 提供 Web 登錄卡片（PKCE 或設備代碼）。

安裝與啓用¶

安裝前請確保環境滿足以下要求：
* DeepSeek Harness 版本爲 0.2.0-rc.2，且配置了 web profile（舊版 0.1.x 不支持）。
* Node.js 版本 >=22.19.0。
* 擁有包含 Codex 訪問權限的 ChatGPT 訂閱（Plus, Pro, Business 或 Enterprise）。
* 具備 DSH 管理的憑證或 Codex CLI 的共享登錄文件。

1. 安裝插件
使用以下命令安裝：

dsh plugin --profile web add dsh-llm-openai-codex

2. 激活插件
編輯 ~/.dsh/profiles/web/cordis.patch.yml，添加以下內容：

- insert:
    - id: llm-openai-codex
      name: 'dsh-llm-openai-codex'

保存文件後，重啓 dsh web 或 DSH 進程。

使用方法¶

插件激活後，在 DSH 的左側側邊欄進入 Plugins 頁面，找到 dsh-llm-openai-codex 插件條目。登錄卡片位於插件描述下方。

1. 憑證來源
登錄卡片支持兩種憑證來源：
* DSH 管理憑證（默認）：插件會在 $DSH_HOME/credentials/openai-codex.json 存儲令牌。
* 共享 Codex CLI：讀取 ~/.codex/auth.json 或 $CODEX_HOME/auth.json。

2. 登錄操作
* 點擊 Connect ChatGPT in browser：通過瀏覽器進行 PKCE OAuth 登錄，回調地址爲 http://localhost:1455/auth/callback。
* 點擊 Use device code：當回調端口被佔用或瀏覽器處於遠程環境時使用。

3. 選擇模型
登錄成功後，在 DSH 的模型選擇器中選擇 openai-codex/<model> 格式的模型。

配置項說明¶

在 cordis.patch.yml 的配置塊中，storage 是唯一會被 Web 界面寫入的鍵，用於指定憑證存儲路徑。其他配置項需重啓 DSH 生效。常用配置包括：
* storage: 指定憑證來源（dsh 或路徑）。
* modelDiscovery: auto: 自動從後端獲取最新模型列表。
* refreshMarginMs: 令牌刷新前的剩餘時間（默認 60000ms）。
* retryPolicy: 失敗重試策略。

注意事項¶

• 不支持 API Key 登錄：該插件不兼容僅使用 API Key 的 Codex CLI 登錄方式。
• 登錄卡片位置：登錄入口在側邊欄的 Plugins 頁面，而非 Settings 設置頁。
• 無需 API Key：安裝和運行過程中不需要設置 OPENAI_API_KEY 環境變量。

生態背景¶

該插件收錄於社區目錄。DSH 的插件生態由社區維護，旨在擴展框架的推理能力，與 DeepSeek 官方無直接從屬關係。

參考資料¶

• GitHub 倉庫
• 社區目錄