DSH Web 側邊欄目前沒有直接顯示 DeepSeek API 餘額的位置。開發者需要打開網頁或查看設置才能知道當前消耗。dsh-dsbal 插件在側邊欄底部（設置按鈕上方）增加了一個餘額按鈕，顯示當前的人民幣餘額，並提供查看明細和告警功能。
核心功能¶
1. 餘額顯示
在側邊欄底部顯示餘額按鈕，位置位於設置按鈕上方。按鈕左側顯示錢包圖標，右側顯示人民幣金額 ¥xx.xx。
2. 自動與手動刷新
默認開啓 30 秒自動刷新機制。點擊按鈕可立即刷新余額，並重置 30 秒計時週期。
3. 懸停詳情卡片
Hover 按鈕時彈出詳情卡片，內容包括：
- 大號顯示當前總餘額。
- 餘額明細：充值餘額和贈送餘額。
- 峯谷定價規則。
- 刷新規則與當前時間。
- 插件版本號。
4. 峯谷定價與告警
- 定價基於北京時間：週一至週五 09:00-12:00 和 14:00-18:00 爲高峯時段，其餘爲低谷時段（含週末及法定節假日）。
- 餘額告警：根據閾值改變按鈕邊框顏色。餘額 < 50 顯示黃色虛線，< 30 顯示橙色虛線，< 10 顯示紅色虛線，≥ 50 爲正常狀態。
5. 語言跟隨
所有文本內容自動跟隨 DSH 的界面語言設置（中文/英文）。
安裝與啓用¶
使用官方提供的命令直接安裝：
dsh plugin --profile web add github:flyingfishzxf/dsh-dsbal
安裝完成後，需要重啓 dsh web 並在瀏覽器中硬刷新（Ctrl+Shift+R 或 Cmd+Shift+R）以加載新插件。
典型用法¶
- 配置憑證：在 DSH 中配置
DEEPSEEK_API_KEY，或者直接登錄 DeepSeek 賬戶（適用於 DSH 桌面應用）。 - 查看餘額：在側邊欄底部查看當前人民幣餘額。
- 刷新余額：點擊按鈕手動刷新，或等待 30 秒自動刷新。
- 查看詳情：Hover 按鈕查看詳細的餘額構成、峯谷定價及當前狀態。
適用場景與注意¶
適用場景
- 需要頻繁監控 DeepSeek API 消耗的開發者。
- 使用 DSH Web 界面進行開發，需要將 API 餘額集成到側邊欄的開發者。
注意事項
- 僅讀功能：插件僅顯示餘額，不可進行充值或任何賬戶操作。
- 刷新間隔固定：刷新間隔爲 30 秒，不可在配置文件中修改。
- 系統依賴：
- POSIX 系統（Linux/macOS）需要 curl 命令。
- Windows 系統需要 node 環境。
- Host 兼容性：需要 DSH host 兼容性支持，使用較新的 API 接口。
結語¶
dsh-dsbal 是一個專注於單一功能的實用插件，將 DeepSeek 的餘額信息無縫集成到 DSH 側邊欄中。通過簡單的按鈕交互和自動刷新機制，開發者可以更直觀地掌握 API 使用情況。
