前言¶
DeepSeek Harness (DSH) 的插件化架構允許開發者將外部能力集成到工作流中。對於需要複用 ChatGPT Codex 訂閱（Plus / Pro / Business / Edu）的開發者，直接在 DSH 中調用需要解決認證與上下文管理的問題。該插件通過 OAuth 流程接入 ChatGPT 訂閱，並將上下文壓縮邏輯替換爲 Codex 原生機制，解決了多輪對話的上下文溢出與壓縮效率問題。
這是什麼¶
這是一個爲 DeepSeek Harness (DSH) 提供的插件，由 thaning0 維護。它將 ChatGPT Codex 訂閱暴露爲 DSH 的 codex-oauth 模型提供方，同時集成了原生壓縮和圖片輸入能力。
核心功能¶
- 訂閱模型接入：將 OpenAI Codex 的 provider 註冊爲
codex-oauth，暴露gpt-5.3-codex-spark等模型。 - OAuth 設備碼登錄：使用
auth.openai.com進行設備碼登錄，無需本地回調服務器。 - 憑據安全：Refresh / Access Token 僅存儲在 DSH 憑據庫
$DSH_HOME/.credentials.yaml（權限 0600），不進配置文件、不進會話日誌，也不進插件倉庫。 - 登錄與訂閱用量：支持登錄、登出，並在設置頁及對話中通過命令查看剩餘用量百分比。
- 多輪對話：完整保留 provider 原生回放元數據，支持跨輪次多輪請求。
- 瞬時錯誤恢復：將 WebSocket、DNS、限流及服務不可用等錯誤歸入 DSH 的
TRANSPORT、RATE_LIMIT或SERVER退避重試。 - 多模態圖片輸入：支持對聲明 image capability 的模型進行圖片輸入。
- 原生壓縮：提供手動
/compact命令以及 80% 壓力觸發的自動壓縮，使用 opaque native checkpoint。
安裝¶
安裝必須使用 file: 前綴，否則依賴加載會失敗。
dsh plugin --profile web add file:/path/to/dsh-llm-codex-auth-native-compact-image
安裝後需重啓 DSH Web 使新 bundle 生效。安裝前請確認已安裝 pnpm（dsh plugin 轉發依賴）或使用提供的腳本進行跨平臺安裝。
典型用法¶
- 登錄：重啓 dsh 後打開設置頁，側欄選擇「Codex 訂閱 (ChatGPT)」並登錄。登錄後可在設置頁查看 5 小時與 7 天窗口的剩餘用量百分比。
- 創建會話：新建會話時選擇
Codex Nativeagent preset，並在 Models 設置頁選擇codex-oauth下的模型。 - 手動壓縮：在對話中輸入
/compact進行手動壓縮。 - 狀態查詢：在對話中輸入
/codex-status查看登錄狀態，輸入/codex-usage查看剩餘用量，輸入/codex-logout登出。
適用場景與注意¶
- 兼容性：原版 OAuth 插件與本插件不得同時加載，否則會重複註冊同一 provider。
- 安全與合規：本插件使用未公開的 ChatGPT 後端接口（
chatgpt.com/backend-api），違反 OpenAI 服務條款的風險真實存在，可能導致賬號受限。請自行評估後使用。 - 插件維護：倉庫內不包含任何祕密，推送到 GitHub 前請確認
.gitignore生效，永遠不要提交$DSH_HOME/.credentials.yaml。 - 限制：自動 native compaction 只處理
codex-oauth；其他 provider 不會回退到compaction-basic。
結語¶
該插件爲 DSH 用戶提供了直接調用 Codex 訂閱的途徑，並優化了上下文壓縮流程。對於需要處理大量上下文或需要多模態能力的開發者，這是一個可行的接入方案。
