dsh-balance-chip：DSH 侧边栏与右下角余额监控

前言¶

在 DSH 环境下进行开发或模型调用时，需要频繁确认 API 余额以避免超额扣费。频繁切换到网页端查看既低效又干扰操作流。dsh-balance-chip 插件将余额查询集成到客户端界面，在侧边栏底部和右下角提供常驻状态。

是什么¶

该插件由 AKUSH99 维护，开源协议为 MIT。它通过读取本地凭证库的 API Key，在 DSH 客户端展示 DeepSeek API 的当前余额。

安装¶

使用以下命令安装插件：

dsh plugin --profile web add github:AKUSH99/dsh-balance-chip

安装完成后，重启 dsh web 即可应用。

核心功能¶

插件在界面中提供两个展示位置：

1. 侧边栏底部：以状态点的形式存在，位于设置选项旁。
2. 右下角胶囊：常驻显示，默认不阻挡鼠标点击（pointer-events: none）。

两种展示均每 60 秒自动刷新。鼠标悬停可查看币种与最后更新时间。

状态颜色指示如下：
* 绿色：余额 ≥ $5
* 橙色：余额 < $5
* 红色：请求出错

安全机制¶

插件本身不包含 API Key。Key 仅在运行时从本地 DSH 凭证库读取，并仅向官方余额接口发起请求。插件无遥测数据，无外部依赖。

使用前提¶

使用前需确认凭证库中存在 DEEPSEEK_API_KEY 引用。该引用可通过网页端模型页面写入。

典型用法¶

安装并重启 dsh web 后，插件会自动开始轮询。在主界面右下角即可看到胶囊，在侧边栏底部即可看到状态点。

注意事项¶

插件以当前 DSH 进程权限运行。安装前请检查源码与许可证（MIT）。

故障排查¶

• 显示 Key?：凭证库中缺少 DEEPSEEK_API_KEY 引用。
• 显示 …：首次轮询尚未完成，等待几秒。
• 显示红色：无法连接到官方余额接口或 Key 无效，请检查网络与 Key 配置。

生态背景¶

DSH 理念是“一切皆插件”。本插件托管于社区目录，与 DeepSeek 官方应用无从属关系。