DeepSeek Harness — OpenAI Codex 插件

DeepSeek Harness（DSH）採用插件化架構。該插件允許將 ChatGPT Plus 或 Pro 訂閱作爲 LLM 提供商接入 DeepSeek Harness，解決在本地環境中通過 Web 界面或命令行使用 ChatGPT Codex 模型的需求。

核心功能¶

該插件提供以下能力：

設備碼登錄：通過 Web 設置界面添加設備碼 OAuth 登錄流程。
Slash 命令：在 Harness 中添加交互式的 /codex 斜槓命令。
無本地服務：不運行瀏覽器回調服務器或 localhost 監聽器。
模型集成：使 Codex 模型與其他提供商並列顯示。
自動刷新：令牌在過期前自動刷新。
用量展示：在 Codex 用量彈窗中顯示 5 小時和每週的用量限制。

安裝¶

DSH 按配置文件（Profile）管理插件。需要在啓用該插件或 /codex 命令的每個配置文件中安裝。以下示例以 web 配置文件爲例：

dsh plugin --profile web add -w @syncended/dsh-codex

安裝或升級後，需要重啓對應的配置文件。

若要移除插件：

dsh plugin --profile web remove @syncended/dsh-codex

使用方法¶

Web 界面登錄¶

打開 Settings（設置） → OpenAI Codex。
點擊 Sign in。插件會在另一個標籤頁打開 OpenAI 的設備登錄頁面。
返回 DSH，複製顯示的一次性代碼，並粘貼到 OpenAI 頁面中。
授權訪問並返回 DSH。設置頁面會自動更新爲 Connected。
在標準模型選擇器中選擇一個 openai-codex/... 模型，併發送測試提示詞。
使用 Settings 上方的 Codex limits 檢查歸一化後的 5 小時和每週餘額。

CLI 交互命令¶

/codex 是 Harness 的斜槓命令，而非 shell 可執行文件。需在安裝了該插件且處於交互模式的配置文件中運行：

命令	描述
`/codex login`	啓動設備碼流程，打印驗證 URL 和代碼。
`/codex status`	顯示令牌狀態和過期時間。
`/codex logout`	刪除存儲的令牌文件並取消發佈活躍憑證。

配置與存儲¶

插件默認將令牌存儲在 $DSH_HOME/openai-codex.json 文件中。它僅將活躍的訪問令牌發佈到 DSH 憑證服務中，環境變量名爲 OPENAI_CODEX_TOKEN。

插件註冊了 openai-codex 路由並自動映射憑證，因此通常無需執行 dsh settings set 命令。若需修改默認配置，可以編輯對應配置文件目錄下的 cordis.patch.yml 文件：

- id: openai-codex
  config:
    # clientId: app_EMoamEEZ…hrann
    credentialRef: OPENAI_CODEX_TOKEN
    deviceCodeTimeoutSeconds: 900
    refreshWindowMs: 300000
    # dshHome: /absolute/path/to/dsh-home
    # tokenFile: /absolute/private/path/openai-codex.json

環境要求與注意事項¶

訂閱要求：需要擁有 Codex 訪問權限的 ChatGPT Plus 或 Pro 訂閱。
DSH 版本：DeepSeek Harness 0.1.0-rc.6 或兼容版本。
運行環境：Node.js 18 或更新版本；dsh plugin 命令需可用 pnpm。
網絡訪問：需要出站 HTTPS 訪問 auth.openai.com 和 chatgpt.com。
Web 登錄限制：Web 登錄受限於迴環/同源 Host 會話。對於遠程 Host，請使用經過身份驗證的 SSH/本地隧道連接其迴環 Web UI，而非公開暴露憑證操作。
用量限制接口：用量視圖使用 OpenAI 未記錄的 Codex 用量端點，其可用性和響應格式可能會在沒有通知的情況下發生變化。
安全提示：$DSH_HOME 目錄包含敏感的本地憑證狀態。請確保該目錄權限安全。/codex logout 會刪除該文件並清除發佈的憑證。

總結¶

該插件通過設備碼 OAuth 和 Slash 命令，將 ChatGPT Codex 模型無縫集成到 DeepSeek Harness 生態中，支持自動令牌刷新和用量監控，適合需要在本地 DSH 環境中調用 Codex 模型的開發者。

更多詳情與源碼，請訪問：GitHub 倉庫