前言¶
在 DeepSeek Harness（DSH）裏接入 Codex，常見做法是準備 OpenAI API Key，或額外安裝 Codex CLI 做中轉。如果你本身已有 ChatGPT/Codex 訂閱，更希望額度、搜索和圖片能力都留在 DSH 會話裏完成，就需要一條不依賴 API Key 的接入路徑。
下面介紹社區插件 dsh-codex-subscription（維護者 WSL043，GitHub 倉庫 WSL043/dsh-codex-subscription）。它在 DSH 內完成獨立 OAuth 登錄，把訂閱模型、真實額度、搜索路由和圖片生成接到同一套界面裏，無需 OpenAI API Key，也無需 Codex CLI。
這是什麼¶
dsh-codex-subscription 是 DeepSeek Harness 的模型推理類插件，npm 包名同爲 dsh-codex-subscription，當前版本 v1.9.0，採用 MIT 許可證。插件在 SkillHub 社區目錄 歸類爲「模型推理」；截至撰寫時，GitHub 顯示 22 stars、3 forks。
它的定位很直接：用你已有的 ChatGPT 賬號（需當前具備 Codex 訪問權限）在 DSH 裏登錄，隨後像選普通模型一樣選用 Codex 系列，並在設置頁查看額度、選擇搜索來源、切換 Fast 模式等。訂閱路由失敗時會顯式報錯，不會靜默切到其他付費通道。
官方 README 寫明，插件兼容 DeepSeek Harness 0.1.1-rc.2 及此前版本範圍；使用前請確認本機 DSH 版本與插件 compatibility.json 一致。
核心功能¶
以下能力均來自倉庫 README 與 package.json 描述，按使用路徑歸納。
訂閱登錄與模型¶
- 通過 ChatGPT OAuth 在宿主機本地保存憑據，設置頁提供瀏覽器登錄，無需粘貼 token，也無需 Codex CLI。
- 登錄後可在對話中選擇 Codex 訂閱模型；支持 Standard / Fast 模式切換（在 composer 內操作）。
- 上下文窗口可按模型目錄默認值、各模型支持的 Extended 窗口，或爲每個模型單獨填寫完整數值 token 上限；Custom 模式會校驗模型容量，並接入 DSH 原生的 agent compaction 策略。
額度與重置¶
- 展示後端返回的真實額度，標準 Codex、Codex-Spark、Credits 等限額分開顯示。
- 可查看下次到期時間與重置次數；如需提前重置，需經確認與冷卻，不會自動重試。
- Composer 內可選緊湊百分比、進度條或不顯示額度（默認關閉）。
搜索與圖片¶
- 全局搜索路由可在「DSH 默認搜索」與「已登錄的 Codex 訂閱搜索」之間顯式選擇，對所有模型和會話生效，不隨當前選中模型變化。
- 支持 Codex 圖片生成與編輯（Beta）：可無參考圖生成，或選定一張圖片做區域標註後編輯；支持預覽、縮放、下載原圖，並在同一 composer 繼續對話。
診斷與支持¶
- 登錄狀態會自動對賬；設置頁可生成不含憑據或賬號標識的支持報告，包含有界請求階段、HTTP/傳輸類型、耗時區間和路由來源等信息，便於排查訂閱路由問題。
安裝與啓用¶
安裝前請自行閱讀倉庫源碼與 MIT 許可證。DSH 插件以當前 dsh 進程權限運行，安裝命令會修改 profile 下的插件列表。
已有 dsh 命令¶
若本機已配置全局 dsh（含 DSH-Portable 的標準插件命令），執行：
dsh plugin --profile web add dsh-codex-subscription
驗證是否安裝成功：
dsh plugin --profile web list dsh-codex-subscription --depth 0
dsh --profile web --dump-config
插件列表應出現一條 dsh-codex-subscription，配置中應有 codex-subscription 條目。
官方 npm 路線（已安裝 Node.js）¶
若通過 npx @deepseek-ai/dsh web 啓動且沒有全局 dsh 命令，需保留完整 npx 前綴，並鎖定與插件兼容的 DSH 版本：
npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add dsh-codex-subscription
npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web list dsh-codex-subscription --depth 0
npx -y @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
Windows 一鍵腳本¶
在 Windows 上，也可在 PowerShell 中運行官方發佈腳本，腳本會檢測當前目錄、系統命令、常見安裝位置以及正在運行的官方 DSH 或 DSH-Portable，並在多個候選目標時詢問後再安裝：
irm 'https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1' | iex
安裝後啓用¶
安裝完成後需手動重啓 DSH，然後按 README 的三步流程操作：
- 打開 Settings → Codex。
- 使用具備 Codex 訪問權限的 ChatGPT 賬號完成瀏覽器登錄。
- 選擇搜索來源，並在模型列表中選中一個 Codex 模型。
若希望由 Agent 代爲安裝、更新或卸載，倉庫提供 AGENTS.md 指引，其中包含校驗步驟，並要求保留現有 DSH profile、登錄狀態與其他插件。
不想自行配置 Node.js 時，README 建議可考慮社區便攜發行版 DSH-Portable；走官方路線則參考 DeepSeek Harness 運行指南。
典型用法¶
完成安裝與登錄後，日常流程與使用 DSH 內置模型類似，差異主要在 Codex 相關設置。
選擇模型與模式。 在 composer 的模型選擇器裏挑選 Codex 訂閱模型；對支持的模型可在 Standard 與 Fast 之間切換。
配置搜索。 在 Settings → Codex 中決定全局搜索走 DSH 默認搜索還是 Codex 訂閱搜索。該選項作用於所有會話，不隨單次對話的模型選擇改變。
查看與管理額度。 在同一設置頁查看各獨立限額與到期時間；需要時可按界面提示嘗試額度重置（帶確認與冷卻）。若希望在對話界面看到額度，可在設置裏開啓百分比或進度條顯示。
圖片生成與編輯（Beta）。 在支持該能力的 Codex 模型下，可直接發起無參考圖生成，或選中一張圖片、標註區域後繼續編輯，並在同一 composer 裏銜接後續對話。
排查問題。 若登錄或路由異常，可在設置頁導出支持報告，對照其中的請求階段與路由來源類型定位問題，或通過 README 中的反饋鏈接提交 issue。
適用場景與注意¶
適合誰
- 已有 ChatGPT/Codex 訂閱，希望在 DSH 智能體工作流裏直接使用訂閱額度，而不想維護 OpenAI API Key。
- 需要在 DSH 內區分標準 Codex、Spark、Credits 等限額，並希望在界面裏看到真實後端額度而非估算值。
- 希望搜索、圖片、Fast 模式與模型上下文設置都留在 DSH 同一套 UI 中完成。
使用前注意
- 賬號需當前具備 Codex 訪問權限；插件不會替你開通訂閱。
- 插件與 DSH 版本有對應關係，README 以
0.1.1-rc.2爲兼容基準，升級任一側前建議覈對compatibility.json。 - 安裝、更新、卸載會改動 web profile 下的插件配置；多人共用機器時請確認 profile 路徑。
- SkillHub 是獨立於 DeepSeek / 幻方的社區插件目錄，並非官方應用商店；插件質量與維護節奏以倉庫與維護者爲準。
結尾¶
dsh-codex-subscription 把 ChatGPT/Codex 訂閱接到 DSH 的 OAuth、模型選擇、額度展示、搜索路由和圖片能力上，省去 API Key 與 Codex CLI 的額外配置。若你正在 DSH 生態裏尋找訂閱型 Codex 接入方案，可從社區目錄頁或 GitHub 倉庫閱讀完整文檔後安裝試用。
