前言¶
用 DSH 調用 DeepSeek 模型時，餘額、累計消耗和具體用量之間，往往缺少一張能直接看成本的視圖。dsh-usage-dashboard 是 Cassius0924 維護的 DSH Web 插件，MIT 許可，用來展示賬戶餘額、今日/本月/累計消耗及環比、模型與會話成本、緩存節省，以及 2026-08-17 峯谷定價後的賬單預估。
DSH 的擴展方式可以理解爲“一切皆插件”；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。下面介紹這個插件的能力、安裝方式和注意事項。
這是什麼¶
dsh-usage-dashboard 在 DSH Web GUI 中增加懸浮額度窗和頂部「額度」tab，把額度與用量視圖放進現有 Web 會話界面裏。
能看什麼¶
- 賬戶餘額，以及今日、本月、累計消耗和環比。
- 按近 7 個自然日的日均消耗估算餘額還能撐幾天；不足 3 天時轉紅。
- 2026-08-17 峯谷定價下的高峯/閒時用量分佈與賬單預估。
- 前綴緩存命中帶來的節省金額。
- 按費用降序的模型成本排行，並拆分輸入、輸出和緩存。
- 會話成本排行，用於定位最貴的會話。
- 近 30 天逐天、0–23 點逐小時用量分佈，以及近 12 周熱力圖。
界面與提醒¶
界面支持中文與 English，並跟隨 DSH Settings → Language 設置。懸浮額度窗常駐右下角，可拖動、吸附四角、可收起，狀態會記住。樣式使用 DSH 的 --dsw-alias-* CSS 變量，跟隨宿主主題。
插件支持餘額預警線設置。跌破預警線時，儀表盤和懸浮額度窗都會顯示警示。
費用估算¶
插件展示的費用是估算，不是賬單。費用估算規則與單價表公開，未識別模型按 deepseek-v4-pro 計價。估算不含 DeepSeek 側折扣、贈金消耗順序等因素，最終應以官方賬單爲準。
安裝與啓用¶
先確認兩個前提：
- 已配置
DEEPSEEK_API_KEY，餘額接口會使用該憑據。 - 本機有
pnpm，因爲dsh plugin是pnpm的轉發器。
從 npm 安裝：
dsh plugin --profile web add @cassius0924/dsh-usage-dashboard
或從 GitHub 安裝：
dsh plugin --profile web add github:Cassius0924/dsh-usage-dashboard
安裝後重啓 dsh：
dsh --profile web
典型用法¶
1、打開 GUI 並進入任意一個會話。「額度」 tab 掛在 conversation.view 上，New Session 首頁沒有 tab 欄，所以需要先進入會話。
2、在頂部查看 Chat / Trajectory / 額度。
3、在設置中配置餘額預警線，默認 ¥10，填 0 關閉。
4、在「額度」tab 中查看計價說明、峯谷定價預估、緩存節省、模型/會話排行和用量分佈圖表。
5、右下角的懸浮額度窗支持拖動、收起和 ↻ 手動刷新，用於常駐查看額度信息。
數據範圍與性能¶
用量數據來自本機 DSH 會話日誌，不含其它機器或賬戶的用量。首次加載用量需要重放全部會話日誌，本機實測約 5 秒，並啓用 5 分鐘服務端記憶化。
適用場景與注意¶
適合需要在本機 DSH 中查看 DeepSeek 額度、用量和成本分佈的用戶，尤其是想對比模型、會話、峯谷時段和緩存節省的人。
需要注意：插件會讀取本機 DSH 會話日誌，並以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證；許可證爲 MIT。
