前言¶

DSH（DeepSeek Harness）的界面裏沒有專門的額度面板。想看賬戶餘額，通常要打開 DeepSeek 控制台；想確認 OpenCode Go 的套餐窗口還剩多少，又得另開一個頁面。兩個數字分處兩地，長期跑 Agent 的人只能反覆切窗口確認，或者乾脆靠腳本查接口。

dsh-quota-overview 解決這個問題。它是 joyboy-yy 維護的 DSH Web 插件，在側邊欄底部、用戶頭像上方新增一整行「額度」入口，同時展示 DeepSeek 賬戶餘額與 OpenCode Go 的 5 小時 / 本週 / 本月用量；點擊入口彈出詳情彈窗，可以看明細與重置倒計時，缺失密鑰時還能直接在彈窗裏填入 API Key。下面介紹它的功能、安裝與用法。

它是做什麼的¶

一句話定位：給 DSH Web 客戶端補一個常駐側邊欄的額度入口，把 DeepSeek 賬戶餘額和 OpenCode Go 套餐用量聚合到一處。

倉庫地址：https://github.com/joyboy-yy/dsh-quota-overview 。許可證 MIT（© 2026 joyboy-yy），npm 上最新版本 1.0.1（2026-11-05 發佈）。GitHub 星標爲 0，屬於個人維護的早期項目。

它解決的是「查額度要離開 DSH」的麻煩：入口常駐側邊欄，鼠標一停就能看到摘要，點開就是詳情，不需要手工寫腳本輪詢。

核心功能¶

側邊欄入口¶

入口是一整行，分兩排展示摘要：

1. 第一排：DeepSeek ¥餘額；
2. 第二排：OpenCode Go 的 5 小時 / 本週 / 本月三檔用量徽章，顏色規則是 <60% 綠、60–85% 黃、≥85% 紅；
3. 懸停顯示完整摘要；側邊欄摺疊成窄欄時，入口自動變成圖標。

詳情彈窗¶

點擊入口打開彈窗，支持 Esc、點擊遮罩、右上角 ✕ 三種關閉方式。彈窗內分兩張卡片：

• DeepSeek 卡片：總額、充值餘額、贈金、可用狀態、數據來源；
• OpenCode Go 卡片：三條進度條（5 小時 / 本週 / 本月）、百分比、重置時刻，以及每秒跳動的倒計時。

右上角有刷新按鈕。需要繞過緩存時，插件提供 ?fresh=1 參數跳過 30 秒緩存，另有「全部刷新」按鈕一次刷新兩類數據。

密鑰解析順序¶

插件先讀憑據，通常零配置即可工作。解析順序如下：

1. DSH 憑據存儲：DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY（也覆蓋啓動環境變量提供的值）；
2. 同名進程環境變量；
3. OpenCode CLI 登錄文件 ~/.local/share/opencode/auth.json 中的 opencode-go 條目。

缺失即提示填入¶

兩類 Key 都沒找到，或上游返回 401 時，彈窗內對應卡片直接顯示密碼輸入框。保存會寫入 DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY 兩個 DSH 憑據，與 DSH 模型供應商共用同一份密鑰，保存後立即重新查詢。

插件還支持「更換密鑰」「清除」已保存的 Key（清除需要二次確認）。如果 Key 來自環境變量、屬於只讀，插件會拒絕操作並提示原因。

安裝與啓用¶

安裝命令來自 README：

# 從 npm 安裝（發佈後）
dsh plugin add dsh-quota-overview

# 或指定 profile
dsh plugin --profile desktop add dsh-quota-overview

也可以在 DSH 的「設置 → 插件」中，通過插件市場搜索 dsh-quota-overview 安裝（收錄後）。

插件包要求 Node >= 22.19.0（見 engines字段），屬於 Web 平臺客戶端。啓用後無需額外配置即可在側邊欄看到入口。

典型用法¶

安裝好之後，日常使用分三步：

1. 看摘要：側邊欄底部常駐的「額度」行顯示 DeepSeek 餘額和 OpenCode Go 三檔用量。5 小時窗口臨近耗盡時，徽章會從綠變黃再變紅，不需要點開也知道大概狀況。
2. 看詳情：點擊入口打開彈窗。5 小時窗口快用完時，進度條下方是逐秒跳動的倒計時，可以直接判斷是先等重置還是先換任務。需要新數據時點右上角刷新，或在需要繞緩存的場景下請求 ?fresh=1。
3. 補密鑰：首次使用時如果憑據和環境變量都沒有 Key，彈窗內會顯示密碼輸入框。填入 DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY 後保存，插件立即重新查詢，之後入口正常顯示數值。

密鑰只在 Host 進程內使用，不會返回瀏覽器；瀏覽器側只拿到餘額、百分比與來源描述。這樣即使彈窗渲染的是客戶端頁面，API Key 也不會暴露到瀏覽器上下文。

數據來源¶

插件查詢上游接口的方式如下：

• DeepSeek：GET https://api.deepseek.com/user/balance（Bearer DEEPSEEK_API_KEY）
• OpenCode Go：GET https://opencode.ai/zen/go/v1/usage（Bearer OPENCODE_GO_API_KEY）

憑據來源與這兩個接口均來自 README 的「數據來源」與「密鑰解析順序」兩節。

適用場景與注意¶

適合以下幾類人：

• 長期在 DSH 裏跑任務、需要頻繁確認 DeepSeek 餘額和 OpenCode Go 窗口的用戶；
• 希望查額度「不離開界面」而不是維護輪詢腳本的人；
• 想在同一個彈窗裏完成查明細、看重置倒計時、補 API Key 的操作的人。

需要注意三點：

• 插件以當前 dsh 進程權限運行。安裝前應先檢查源碼（index.js、client.js、cordis.patch.yml）與許可證（MIT），確認它的路由、憑據讀寫行爲與自身環境匹配；
• GitHub 星標爲 0，npm 發佈時間不長，依賴上游接口行爲，DeepSeek 或 OpenCode 調整接口時插件可能需要同步更新；
• 插件會讀寫 DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY 兩份 DSH 憑據，與模型供應商共用同一份 Key，如果這不符合你的密鑰管理習慣，需要自行評估。

結尾¶

dsh-quota-overview 的價值是把查額度這件事收回到 DSH 界面裏：一行入口承擔摘要，彈窗承擔明細和重置倒計時，缺失密鑰時用彈窗補進去。對同時使用 DeepSeek 和 OpenCode Go 的用戶來說，它減少的是反覆切窗口確認的代價。

目錄頁：https://www.skillhub.cn/plugins/joyboy-yy/dsh-quota-overview
GitHub：https://github.com/joyboy-yy/dsh-quota-overview