前言¶
用 DSH 跑智能體，有兩種成本是事後纔看得見的：餘額還剩多少，以及這一輪用量落在峯價還是谷價。前者要切到網頁登錄翻，後者要自己記價格窗口。bingomu 維護的客戶端插件 dsh-usage-printer 把這兩件事壓進了側欄底部：靜止時是一塊點陣數字屏，鼠標懸停纔出紙顯示明細。
下面介紹它的能力邊界、數據來源和安裝方式，最後說清它適合誰、有什麼坑。
這是什麼¶
一句話：dsh-usage-printer 是裝在 DSH 側欄底部的用量卡，只負責顯示兩件事——餘額水位，和當前用量在峯谷價格窗口裏的位置。
它由 bingomu 維護，分類在客戶端，許可證 MIT。解決的問題很具體：開發者不想在寫代碼和看日誌之間反覆切到瀏覽器查餘額。
核心功能¶
靜止態和懸停態是它唯一的交互模型，共三層信息：
- 靜止態：點陣拼出餘額金額，元位大、角分位小，位數多時自動縮一檔；下方是一條峯谷臺階帶，淡黃表示谷價、淡紅表示峯價；底紋點陣按用量亮起。
- 懸停態：紙從槽口升出來，列出餘額、已充值、時段、倒計時、可用天數、今日與本月花費、單價，並帶一個直達官方充值頁的入口。點一下可以固定，Esc 或點外部收起。
- 主題：深淺色跟隨 DSH 主題（
--dsw-alias-*），窄欄時自動收成一個點陣小方塊。
數據從哪來¶
三個顯示字段對應三個來源，README 裏列得很清楚：
- 餘額：DeepSeek
GET /user/balance，憑證用 DSH 賬號登錄留下的 grant 記錄（deepseek-account-platform/default，請求頭x-dsh-auth-token）。 - 峯谷：按官方價格表的窗口判定，北京時間工作日 09–12、14–18 爲峯價。
- 單價：官方 2026-09-10 價格快照（元 / 百萬 token），表裏沒有的模型顯示
--。
插件分 Host 和 Client 兩半：Host 半隻註冊一個本機路由 GET /api/usage-printer，30 秒緩存；Client 半 30 秒拉一次。README 明確寫了「餘額不出本機」——路由只接受 localhost 和綁定主機名，響應不帶任何跨域頭。
安裝與啓用¶
安裝走官方命令，不要憑名稱拼接。README 給了三種方式，推薦第一種：
# GitHub（推薦，和你其它插件一致）
dsh plugin add github:bingomu/dsh-usage-printer#v1.0.3
# npm（可選）
npm i -g @bingomu/dsh-usage-printer
本地目錄方式走 plugin_manager → install_bundle，target 指向插件目錄。
版本要求有兩條：
- 適配 DSH
0.2.1-rc.5（engines.dsh已聲明）。 - 必須裝 v1.0.2 及以上。v1.0.0 / v1.0.1 的客戶端模塊 id 寫錯，裝上後側欄不顯示卡片。
典型用法¶
這個插件沒有配置文件，裝完即用，實際使用就是三步：
- 用上面的命令安裝，確認版本在 v1.0.2 以上。
- 啓動 DSH，側欄底部出現點陣數字屏，鼠標懸停即出小票。
- 需要充值時點小票裏的入口，跳到官方充值頁。
如果小票裏金額和預期對不上，先覈對單價快照是否過期：官方調價後需要更新 index.js 裏的 PRICES。
適用場景與注意¶
適合兩類人：
- 想隨時看到餘額和當日花銷，但不想手動開網頁的 DSH 開發者。
- 想在同一側欄裏同時確認「還剩多少」和「現在算不算峯價」的人。
需要注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（MIT），不要安裝來路不明的分支。
- 節假日未接法定節假日表，調休日會算錯峯谷檔位。
- 「已充值」不是流水，而是插件第一次讀到的餘額；裝插件之前就有的餘額會讓這個數偏低，百分比偏高。
- 「可用天數 / 今日 / 本月花費」由余額採樣差分推出，間隔超過 30 分鐘的時段算「未觀測」，該天數字會帶
~前綴。 - 會話級花費尚未接會話日誌，當前不會按
assistant/message事件的usage計價。
結尾¶
這個插件的價值不在功能多，而在把餘額和峯谷壓進側欄，讓用量保持在視線內。它只做顯示，不做扣費判斷，餘額也不出本機。
- 目錄頁：https://www.skillhub.cn/plugins/bingomu/dsh-usage-printer
- GitHub：https://github.com/bingomu/dsh-usage-printer
