前言¶

用 DSH 開發或日常跑智能體時，一個常見的訴求是隨時知道賬戶還剩多少、當前這一檔單價是多少、今天花了多少。常見做法是切到「設置 → 賬號與餘額」或者另開一個計費工具，每次都要離開當前上下文。dsh-simple-balance 把這件事壓縮到側欄一行，不用切頁面，餘光就能看到。

下面介紹它的定位、安裝方式，以及它實際讀取的數據口徑。

這是什麼¶

dsh-simple-balance（中文名「簡便餘額」）由 ZKY172 維護，分類屬於客戶端。它解決的問題很窄：在 DSH 側欄面板列表裏增加一行，顯示賬戶餘額、當前時段的輸入單價和今日已用金額；點開這一行再看明細。

這一行的擺放位置是「新建會話」下方、「工作區」上方，與「插件」「插件市場」同一列。

核心功能¶

側欄那一行是兩行小字，格式如下：

餘額 ¥23.02 · 今日用量 ¥0.03
谷價 ¥1.00/M —峯價 09:00

• 第一行：賬戶餘額、今日已用金額。
• 第二行：當前時段的輸入單價（谷價綠色 / 峯價紅色），以及下次峯谷切換的時刻。

點開這一行進入明細頁，能看到賬戶餘額、今日用量、當前時段與單價，以及緩存命中 / 未命中 / 輸出三項的價目表，頁內還有一個手動刷新按鈕。

刷新策略是每 30 秒一次；窗口重新獲得焦點時也會立刻刷新一次。

安裝與啓用¶

用 dsh 的插件命令安裝，指定 web profile：

dsh plugin --profile web add dsh-simple-balance

如果需要從指定倉庫安裝，用 GitHub 源形式：

dsh plugin --profile web add github:<owner>/dsh-simple-balance

這裏的 <owner> 替換爲實際倉庫所有者，對應本插件爲 ZKY172。

數據來源與價格口徑¶

插件有三處來源，分別對應餘額、用量和單價。

餘額優先讀 dsh 的 deepseekAccount 服務，與「設置 → 賬號與餘額」同源。這個服務是可選的：宿主沒有時插件會自動回退到底層的賬本文件，不會因此加載失敗。

今日已用讀 ~/.dsh/.dshw-usage.json。該文件由另一插件 dsh-cost-meter 維護，實時落盤。

單價採用官方人民幣價目。谷時每百萬 token：緩存命中 ¥0.02、未命中 ¥1.00、輸出 ¥4.00；峯時翻倍。

峯谷規則按北京時間：週一至週五 09:00–12:00、14:00–18:00 爲峯時，其餘時間（含週末與法定節假日）爲谷時。2026 年的法定節假日已經內置，之後每年國務院公佈次年安排後需要更新一次。

權限與隱私¶

插件聲明的能力如下：

• 讀文件：~/.dsh/.dshw-usage.json
• 調用宿主服務：deepseekAccount（可選）
• 註冊一條只讀 HTTP 路由：GET /plugins/dsh-simple-balance/summary
• 無 shell、無網絡出站、無憑據訪問

也就是說，它只讀本機賬本文件和宿主提供的餘額接口，不髮網絡請求，不上報數據，不讀取憑據。宿主的餘額接口由 dsh 自己鑑權，插件只是調用它。

卸載¶

dsh plugin --profile web remove dsh-simple-balance

適用場景與注意¶

適合這類情況：主要使用 DSH Web 客戶端、希望隨時看到餘額和時段單價，但又不想切到賬號頁面或外部計費工具。它只做展示和彙總，不負責扣費，也不控制模型調用。

需要注意三點。一是插件以當前 dsh 進程權限運行，安裝前應先查看源碼和許可證（本插件爲 MIT）。二是餘額和用量分別依賴宿主的 deepseekAccount 服務與 dsh-cost-meter 的賬本，這兩個來源都不存在時，明細頁相應位置可能拿不到數據。三是單價裏的節假日表只內置了 2026 年，之後需要手動更新。

結語¶

dsh-simple-balance 的價值在於把餘額、時段價和今日用量壓進側欄一行，代價是一個很小的客戶端插件，不增加網絡出站。源碼與安裝說明見 GitHub，社區目錄頁也有收錄。

• GitHub：https://github.com/ZKY172/dsh-simple-balance
• 社區目錄：https://www.skillhub.cn/plugins/ZKY172/dsh-simple-balance