DeepSeek Harness 插件：dsh-chatgpt-codex

前言¶

DeepSeek Harness (DSH) 採用插件化架構。目前，DSH 的主模型路由並不包含 ChatGPT/Codex OAuth 支持。dsh-chatgpt-codex 插件填補了這一空白。它允許在 DSH 中直接使用 ChatGPT 賬戶和 Codex 模型，支持瀏覽器回調和設備碼登錄，且不依賴 pi-ai 適配器。

核心功能¶

該插件負責管理 ChatGPT 認證的生命週期，並將 Codex 響應流式傳輸到 DSH 原生協議中。

認證方式：支持瀏覽器回調（PKCE，嚴格狀態檢查，localhost 回調）和設備碼登錄（適合 SSH、容器或無頭環境）。
憑證管理：自動刷新訪問令牌，支持進程內和跨進程鎖防止併發衝突；憑證以原子方式存儲在 $DSH_HOME 下，權限受限。
模型支持：註冊爲原生的 openai-codex DSH 模型提供者，無需 pi-ai。支持 GPT-5.6 (Luna, Terra, Sol) 及 GPT-5.5/5.4 等模型。
流式傳輸與回放：支持文本、推理摘要、函數調用、圖片、Usage 及 Finish Reasons 的流式傳輸。使用加密推理項目回放，確保多輪對話的正確性。

安裝與啓用¶

1. 登錄¶

在安裝插件前，需先完成認證。根據環境選擇方式：

桌面瀏覽器回調（推薦）：

    dsh-chatgpt-codex login

設備碼登錄（推薦用於 SSH 或容器）：

    dsh-chatgpt-codex login --device

認證文件默認存儲在 `$DSH_HOME/chatgpt-codex/auth.json`。

2. 添加插件¶

使用官方安裝命令將插件註冊到指定 profile：

dsh plugin --profile codex add github:sudipnext/dsh-chatgpt-codex#v0.1.0

3. 運行 Harness¶

切換到插件定義的 profile 啓動：

dsh --profile codex

該 profile 會註冊 openai-codex 提供者，並將 gpt-5.6-luna 設爲默認模型。

使用方法¶

安裝並登錄後，可使用以下命令管理憑證：

查看狀態（安全輸出，不打印令牌）：

    dsh-chatgpt-codex status

查看 JSON 狀態：

    dsh-chatgpt-codex status --json

手動刷新令牌：

    dsh-chatgpt-codex refresh

登出（僅移除本地憑證，不遠程撤銷會話）：

    dsh-chatgpt-codex logout

注意事項¶

獨立項目：這是一個獨立的社區插件，並非 OpenAI 或 DeepSeek 的官方項目。
模型可用性：模型目錄僅作參考，實際可用性取決於您的 ChatGPT 訂閱計劃、工作區策略、區域以及 OpenAI 的當前發佈進度。
安全提示：logout 命令僅刪除本地存儲的憑證文件，不會遠程註銷 OpenAI 會話。請確保在不再使用時妥善保管憑證文件。