前言¶

DSH 的插件體系裏，模型調用通常走 DSH 自己配置的 provider。如果團隊或個人已經在用 OpenAI 的 Codex 訂閱，多一套賬號、多一處配額查詢入口，是很實際的負擔：登錄狀態散在瀏覽器裏，額度用完也不知道什麼時候恢復。下面介紹的插件把 ChatGPT 登錄、訂閱配額顯示和搜索能力接進 DSH Web，目標是讓每個用戶用自己的賬號，在統一的界面裏完成模型選擇和配額確認。

這是什麼¶

dsh-codex-workbench 是一個面向 DeepSeek Harness Web 界面的插件（DSH bundle），由 Vlad1108 維護，分類屬於「模型推理」。它處理三件事：

1. 在 DSH Web 裏完成 ChatGPT 登錄（openai-codex provider 的 OAuth 流程）。
2. 在對話窗口旁邊顯示當前 Codex 訂閱的五小時 / 周配額、剩餘額度和刷新時間。
3. 註冊並選用 openai-codex 作爲 web_search 的 provider，用 Codex 做聯網搜索。

插件複用 DSH 0.2.1-rc.5 已有的 openai-codex provider，不在通信兩側再造一套模型接入，登錄憑據仍保存在 DSH 的憑據存儲中，不會下發到瀏覽器。

核心功能¶

1、ChatGPT 登錄¶

插件沒有自己實現登錄頁，而是沿用 DSH 的 openai-codex provider：在 Settings → Models 裏添加該 provider 後選 Sign in with ChatGPT，在彈開的瀏覽器裏完成登錄，再應用 provider 設置。每個用戶用自己的賬號登錄，不做共享憑據。

2、配額顯示與手動刷新¶

登錄後，編輯器（composer）會在當前使用的 Codex 模型旁邊顯示剩餘五小時配額；如果賬號沒有五小時窗口，則顯示周配額。把鼠標懸停或點按該卡片，可以看到可用窗口和重置時間，點擊本身也會刷新數值。

3、手動重置 saved resets¶

當 OpenAI 報告賬號裏存在 saved resets 時，配額卡片會顯示還剩幾個。確認重置會請求 OpenAI 消耗一個 saved reset，並恢復符合條件的五小時與周配額，對應的恢復時間也可能變化。如果這次請求的響應丟失，應在使用另一個 saved reset 之前，先從卡片重試同一個請求。可用性和資格由 OpenAI 決定，插件只是轉發操作。

4、用 Codex 做 Web 搜索¶

插件註冊並選用 openai-codex 作爲搜索 provider，同時把頁面抓取方式選爲 http。登錄完成後，只要給 agent 啓用了 web_search 工具，就會走 Codex 搜索。該選擇對整個 profile 生效，即使當前活動的是其他模型也一樣；取消安裝插件會移除這套選擇。

路由優先級上有兩條規則需要注意：

1. profile 裏或用戶主目錄 cordis.patch.yml 中已有的 web 條目優先級高於 bundle，後續安裝的 bundle 也可能覆蓋它。
2. 想改用其他 provider，要在同一個 web 條目裏同時設置 searchProvider 和 fetchProvider，DSH 會整段替換該條目的配置。

5、搜索相關的可配置項¶

bundle 的配置提供以下字段：

• searchModel：搜索使用的模型。
• searchMode：取值爲 cached、indexed 或 live。
• searchContextSize：上下文體量。
• searchMaxOutputTokens：搜索輸出 token 上限。
• quotaTimeoutMs：配額查詢超時。

安裝與啓用¶

插件目前版本爲 0.1.6，目標版本是 DSH 0.2.1-rc.5 的 Web 界面。安裝命令取自 README：

dsh plugin --profile web add dsh-codex-workbench

也可以直接從 GitHub 安裝：

dsh plugin --profile web add github:Vlad1108/dsh-codex-workbench

安裝後需要重啓 DSH Web，然後按下面的步驟啓用 provider：

1. 打開 Settings → Models，添加 openai-codex provider。
2. 選擇 Sign in with ChatGPT，在瀏覽器裏完成登錄。
3. 應用 provider 設置。模型選擇器使用 DSH 提供的模型目錄。

如果目錄裏缺少需要的模型，可以通過 DSH 的模型設置自行添加。

隱私、兼容性與邊界¶

README 明確了三條邊界：

• 憑據只留在 DSH 的憑據存儲中，不會發到瀏覽器；登錄、模型請求、配額查詢和搜索都走 OpenAI 端點。
• 配額與搜索依賴的端點可能獨立於本插件變更。
• 插件不添加任何遙測。

許可證爲 MIT，包內提取出來的 DSH 代碼保留原有許可證。需要注意兩點運行約束：

1. 同一份 profile 裏只應存在一個 Codex 集成，若另一個插件註冊了同一個搜索 provider，會衝突。
2. 插件以當前 dsh 進程權限運行，安裝前應自行檢查源碼與許可證，只從信任的來源加插件。

開發與驗證¶

倉庫提供了完整的構建與測試命令；lib/ 目錄已隨包發佈，因此 DSH 從 GitHub 安裝時無需構建步驟：

pnpm install --ignore-workspace
node build.mjs
node node_modules/typescript/bin/tsc --noEmit
node node_modules/vitest/vitest.mjs run --config vitest.config.ts

適用範圍¶

適合下面幾類情況：

1. 已經在用 OpenAI Codex 訂閱、希望直接在 DSH Web 裏按賬號登錄的開發者。
2. 需要清楚知道五小時窗口和周配額什麼時候重置的人。
3. 希望 agent 的 web_search 走 Codex 搜索鏈路，而不是另配一套搜索 provider 的團隊。

如果只想用 DSH 原生 provider、或者已有自建搜索路由（即 profile 或用戶主目錄裏的 web 條目），插件的自動選中會被現有配置覆蓋，此時需要手動同時設置 searchProvider 與 fetchProvider。

小結¶

dsh-codex-workbench 的價值集中在一處：把 ChatGPT 登錄、訂閱配額展示和 Codex 搜索統一收進 DSH Web 的現有 provider 體系，減少賬號和配額管理的切換成本。它依賴 DSH 0.2.1-rc.5 的 openai-codex provider，適用面明確，同時需要留意搜索路由優先級和同 profile 內單實例的約束。

目錄頁：https://www.skillhub.cn/plugins/Vlad1108/dsh-codex-workbench
倉庫：https://github.com/Vlad1108/dsh-codex-workbench