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 使用情况。
