前言¶

在 DeepSeek Harness 裏同時用 Codex 時，額度往往要切到 ChatGPT 網頁或別的工具裏查 5 小時窗口和每週上限，打斷工作流。社區插件 dsh-codex-usage（維護者 sodaa-l，分類：聯網工具）把這兩類剩餘額度直接嵌進 DSH 側欄與底欄，並顯示重置時間；接口不可用時不做估算。下面介紹它的能力、安裝方式與使用注意點。

這是什麼¶

dsh-codex-usage 是 DSH 用量類插件：在側欄與底欄展示 ChatGPT Codex 賬戶的 5 小時與每週額度。卡片背景透明，顯示剩餘比例和重置時間，字體與主題色與 DSH 一致。源碼與說明見 GitHub，目錄頁見 SkillHub。當前 package 版本爲 0.1.1，採用 MIT 許可。

核心功能¶

側欄與底欄共用一次請求、同一份用量快照與刷新時刻；多個會話或遲掛載的底欄也會同步。

1. 額度展示：顯示當前可用的 5 小時和每週額度。套餐沒有 5 小時窗口時只顯示每週額度；接口失敗或沒有可識別額度窗口時顯示不可用狀態，不估算額度。
2. 側欄：設置頁提供側欄總開關；5 小時與每週爲縮進子開關。關閉總開關後子開關禁用，原選擇保留。關閉總開關會隱藏卡片。
3. 底欄：在其他底欄控件之後排列 Codex 標誌 5h ▰ X%・1 周 ▰ X%，百分比爲剩餘額度，不顯示重置時間；短粗進度條沿用主題色。點擊底欄控件可在上方展開與側欄共用的完整用量卡片；再次點擊、點外部、失焦或按 Esc 收起。底欄有獨立總開關及子開關，默認開啓，不受側欄開關影響；關閉總開關或兩項子開關會隱藏控件，彈出卡片仍展示套餐支持的兩種額度。
4. 刷新：自動刷新間隔可選 1、5、15 或 30 分鐘，默認 1 分鐘。顯示選項與刷新間隔保存在當前瀏覽器，不跨瀏覽器同步。兩個額度窗口到達重置時間後會強制刷新。至少一個側欄或底欄入口可見時繼續共享自動刷新；全部隱藏或卸載後停止自動刷新，設置頁仍可手動刷新。

Host 向 https://chatgpt.com/backend-api/wham/usage 請求額度（經 @earendil-works/pi-ai 的 OpenAI Codex OAuth 提供器）。該接口不是公開穩定 API，字段與套餐支持可能變化；部分套餐或組織賬戶不會返回 5 小時窗口。成功結果默認緩存 60 秒，失敗結果最多緩存 10 秒。

Bundle 可選配置：

安裝與啓用¶

運行要求：DSH >=0.2.0-rc.1，Node.js >=22.19.0。

DSH Web¶

在運行 Web profile 的主機上執行：

dsh plugin --profile web add dsh-codex-usage

DSH Desktop¶

打開 Desktop 工作區，側欄進入「插件」，選擇「添加插件」，輸入 dsh-codex-usage 並安裝，完成後選擇「立即啓用」。

插件以當前 DSH 進程權限運行；安裝前建議閱讀源碼與 LICENSE。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

登錄與典型用法¶

啓用後，在 DSH 設置中打開「Codex 額度顯示」，點擊「登錄」，用系統瀏覽器完成 OpenAI 授權。瀏覽器未自動打開時可點設置頁登錄鏈接；本機回調未完成時可粘貼瀏覽器跳轉後的完整地址。等待授權時可取消，也可隨時退出賬戶。

憑據由 DSH 憑據服務保存爲 dsh-codex-usage/openai-codex；令牌刷新由憑據服務串行寫入，訪問令牌留在 Host，不會傳給側欄 Client。使用本插件不需要 Codex CLI。

典型流程：安裝並啓用 → 設置裏登錄 → 按需調整側欄/底欄開關與刷新間隔 → 在側欄看完整卡片，或在底欄看簡要百分比並點擊展開詳情。

適用場景與注意¶

適合在 DSH Web 或 Desktop 中長期使用 Codex、需要隨時對照 5 小時與每週剩餘額度的開發者。底欄彈層依賴原生 Popover 與現代瀏覽器；樣式綁定當前 DSH 插槽（側欄 sidebar.footer.action、底欄 conversation.composer.dock），若 DSH 調整插槽佈局，插件可能需要複覈。

本地開發驗收時，可用 dsh-codex-usage@file:<項目目錄> 安裝，Loader entry 名稱須與 package.json 的 name 一致；克隆或 npm ci 不會自動把插件裝入 DSH，安裝與登錄需分別完成。

結尾¶

dsh-codex-usage 把 Codex 5 小時與每週額度收進 DSH 界面，減少切換查額度的成本。更多信息見 SkillHub 目錄頁 與 GitHub 倉庫。