dsh-account-balance

一个给 dsh Web 界面实时显示 DeepSeek 模型账户余额的插件。余额以一个小胶囊显示在聊天窗口上方（会话头部的工具区），鼠标悬停可查看「总余额 / 赠送余额 / 充值余额」明细，支持手动刷新，并每 60 秒自动刷新。

工作原理

• Host 半（lib/index.js）：在 Web 服务器上注册一个本地路由 /api/account-balance。它通过凭证服务（ctx.credentials，也就是 web 模型设置页 / DEEPSEEK_API_KEY 环境变量写入的那个来源）解析 API Key，再代理 DeepSeek 官方的 GET /user/balance 接口。API Key 只留在本机进程里，绝不暴露给浏览器。
• Client 半（lib/client.js）：在 conversation.session.header.utilities 槽位注册余额组件，轮询 /api/account-balance 并渲染。

安装

在插件目录（本目录）下运行：

dsh plugin --profile web add .

等价于手动方式：把 dsh-account-balance 加进 $DSH_HOME/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles。

生效

重启 web 服务即可看到余额：

# 停掉当前 dsh web，再启动
dsh web

配置

插件复用 DeepSeek 官方适配器的凭证来源，无需额外配置：

配置	说明
DEEPSEEK_API_KEY	API Key（web 模型设置页写入的托管凭证、.env、或环境变量均可）
DEEPSEEK_BASE_URL	可选，覆盖余额接口基地址，默认 https://api.deepseek.com

余额接口返回格式以 DeepSeek 官方文档 为准。