Plugin directory / Developer / dsh-account-balance
dsh-account-balance
Verified · install-tested on dsh ls-cool-123
What it does
DeepSeek account balance dashboard plugin for dsh web — shows your DeepSeek API balance above the chat window.
Works — verified, early-stage project
DeepSeek account balance dashboard plugin for dsh web — shows your DeepSeek API balance above the chat window. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
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 官方文档 为准。
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-account-balance for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:ls-cool-123/dsh-account-balanceHeadless (CLI) profile:
dsh plugin --profile headless add github:ls-cool-123/dsh-account-balanceTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-account-balance/)<a href="https://dshbase.com/plugins/dsh-account-balance/"><img src="https://dshbase.com/badges/dsh-account-balance.svg" alt="dshbase install-tested"></a>