前言¶
使用 DSH 網頁界面接入 DeepSeek API 時，餘額、累計消費和 Token 用量通常分散在不同位置：有的要看平臺控制檯，有的要從會話日誌裏統計。對經常切換項目、需要快速確認額度的人來說，來回切頁面會增加不少成本。
dsh-liquid-glass-balance-card 是一個給 DeepSeek Harness（DSH）網頁界面使用的插件。它把 DeepSeek API 餘額、累計消費和 Token 用量放進同一個可拖動的液態玻璃卡片中，默認出現在頁面右上角。
下面介紹這個插件能做什麼、如何安裝、如何配置 API Key 和平臺 userToken，以及使用時需要注意的事項。
這是什麼¶
dsh-liquid-glass-balance-card 是 DSH 網頁界面中的一個餘額與用量卡片插件。它的定位很直接：在 DSH Web 頁面裏顯示 DeepSeek API 的餘額、累計消費和 Token 用量，並允許拖動卡片位置。
該插件屬於 DSH 社區插件生態。DSH 強調“一切皆插件”，社區目錄是獨立站點，不等於 DeepSeek 或幻方的官方應用商店。
已覈實信息顯示：
- 倉庫名稱：
dsh-liquid-glass-balance-card - 倉庫 owner：
SoDaZilla-zzz - README 與
package.json作者字段顯示：sooodaaa package.json聲明版本：0.2.0- 許可證：
MIT - GitHub 倉庫：https://github.com/SoDaZilla-zzz/dsh-liquid-glass-balance-card
核心功能¶
這個插件主要提供以下幾類能力：
- 默認在 DSH 網頁界面右上角顯示一張可拖動的液態玻璃卡片。
- 顯示 DeepSeek API 總餘額、可用狀態、贈送餘額與充值餘額。
- 顯示累計消費金額與累計 Token 用量。
- 支持今天、昨天、近7天、近30天、全部時間維度。
- 提供雙層用量統計：本地 DSH 會話日誌聚合，以及 DeepSeek 平臺線上總計。
- 可選配置 DeepSeek 平臺
userToken，用於啓用線上總計。 - 卡片設置中可以開關線上總計顯示。
- 近7天、近30天以液態玻璃柱狀圖展示消費與 Token 趨勢。
- 液態玻璃效果參數可即時調節，包括透明度、背景模糊、飽和度、高光強度、流動光線。
- 3D 立體厚度效果可開關，並可調節厚度與側向角度。
- 可自定義玻璃顏色，同時保持液態玻璃特性。
- 幣種偏好支持
CNY、USD、Auto。 - 一鍵跳轉 DeepSeek 官方充值入口。
- 支持手動填寫 DeepSeek API Key；未填寫時回退使用 DSH 已配置的
DEEPSEEK_API_KEY。 - 每 60 秒自動刷新，也可手動刷新。
- 插件配置卡中可分別設置餘額與線上總計的自動刷新間隔。
- 跟隨 DSH 明暗主題變量
--dsw-*。
安裝與啓用¶
安裝需要 DSH CLI 與 pnpm。先執行下面的安裝命令：
dsh plugin --profile web add dsh-liquid-glass-balance-card
安裝完成後，重啓 DSH Web：
dsh web
打開瀏覽器訪問：
http://127.0.0.1:3080
刷新頁面後，卡片會出現在頁面右上角。
如果選擇手動安裝，需要做兩件事：
- 將插件包放入對應 profile 的
node_modules目錄。 - 在
~/.dsh/profiles/web/cordis.patch.yml中加入 loader entry。
loader entry 示例如下：
- insert:
- id: liquid-glass-balance-card
name: dsh-liquid-glass-balance-card
經過上面的步驟後，再啓動 DSH Web，卡片就會加載進網頁界面。
典型用法¶
配置 DeepSeek API Key¶
卡片顯示餘額前，需要先有可用的 DeepSeek API Key。可以通過兩種入口配置：
- 卡片上的齒輪圖標。
設置 → 插件 → 插件配置 → DeepSeek 餘額卡片。
操作步驟：
- 粘貼 DeepSeek API Key。
- 點擊保存。
保存後，手動填寫的 Key 會優先於 DSH 已配置的 DEEPSEEK_API_KEY。如果點擊清除，刪除手動 Key 後，插件會回退使用 DSH 自身的 DEEPSEEK_API_KEY。如果手動 Key 和 DSH 已配置的 DEEPSEEK_API_KEY 都沒有，卡片會顯示明確的錯誤提示。
該 Key 通過 DSH 官方憑據系統存儲，引用名爲：
DSH_LIQUID_GLASS_API_KEY
它不會落進插件自有的明文文件，瀏覽器也看不到明文。
如果此前使用過 v0.1，並且舊 Key 存儲在：
$DSH_HOME/storages/dsh-liquid-glass-balance-card.json
下次啓動時會自動遷移進 DSH 憑據系統，隨後舊文件會被刪除。
啓用線上總計¶
線上總計需要 DeepSeek 平臺 userToken。普通 API Key 無法讀取線上總計，因爲線上總量來自已登錄平臺會話的用量接口。
線上總計讀取的兩個接口是：
platform.deepseek.com/api/v0/usage/amount
platform.deepseek.com/api/v0/usage/cost
獲取 userToken 的步驟如下：
- 在瀏覽器中登錄 DeepSeek 平臺。
- 打開開發者工具。
- 進入
Application → Local Storage → platform.deepseek.com。 - 複製
userToken的值。 - 將該值粘貼到卡片設置或插件設置中並保存。
平臺 userToken 通過 DSH 憑據系統存儲，引用名爲：
DSH_LIQUID_GLASS_PLATFORM_TOKEN
該 Token 不會迴流到瀏覽器 UI 的返回流量中。瀏覽器只訪問本地宿主路由；宿主僅將其發送給 platform.deepseek.com 的兩個用量接口。
線上總計是賬號級統計，包含非 DSH 客戶端產生的用量，並按北京時間對齊。因此，它通常不等於某個 DSH 會話或某個項目內的本地統計。
調整液態玻璃效果¶
卡片中的液態玻璃效果可以在設置面板裏實時調節。可調參數包括：
- 透明度
- 背景模糊
- 飽和度
- 高光強度
- 流動光線
- 3D 立體厚度
- 側向角度
- 玻璃顏色
參數保存在瀏覽器 localStorage 中，並提供恢復默認按鈕。
適用場景與注意¶
這個插件適合以下幾類使用場景：
- 在 DSH 網頁界面中頻繁調用 DeepSeek API，需要隨時查看餘額。
- 希望在同一頁面裏看到本地會話統計和平臺線上總計。
- 需要按今天、昨天、近7天、近30天、全部時間維度查看消費和 Token 用量。
- 希望卡片外觀可調節，並與 DSH 明暗主題保持一致。
使用時需要注意幾點：
- 插件以當前
dsh進程權限運行。安裝前應檢查源碼、依賴與許可證。 - 手動 API Key 優先於 DSH 已配置的
DEEPSEEK_API_KEY。 - 線上總計需要平臺
userToken，不是普通 API Key。 - 線上總計是賬號級統計，會包含非 DSH 客戶端用量。
- 平臺
userToken只應由宿主發送給 DeepSeek 平臺用量接口，不要把它當作普通 API Key 使用。 - 玻璃參數保存在瀏覽器
localStorage中，換瀏覽器或清理本地數據後可能需要重新設置。
結尾¶
dsh-liquid-glass-balance-card 解決的是一個很具體的問題：在 DSH 網頁界面裏快速查看 DeepSeek API 餘額、累計消費和 Token 用量。它把餘額、本地統計、線上總計、時間維度和趨勢圖集中到一張可拖動的卡片中，並且把 Key 和平臺 Token 交給 DSH 憑據系統處理。
已覈實資料未給出可確認的社區目錄頁地址；如需查看源碼、提交 issue 或確認安裝細節，可訪問 GitHub 倉庫：
https://github.com/SoDaZilla-zzz/dsh-liquid-glass-balance-card
