安装
npx -y @deepseek-ai/dsh plugin --profile web add github:MatsMQ/dsh-deepseek-balance此安装命令根据 GitHub 仓库地址生成，是未经验证的安装起点。
README
维护者编写的文档快照。
dsh-deepseek-balance · DeepSeek 账户余额实时显示
DSH Web GUI 的余额小部件，两处显示，每 30 秒自动刷新（也可手动刷新）：
- 会话标题栏右侧：主界面 banner 位置的余额徽章（
余额 ¥1.36） - 设置 → 插件 → 账户余额：完整详情页（总余额 / 赠送余额 / 充值余额 / 可用状态）
两处共享同一份轮询数据，任意一处挂载即开始刷新，切换页面后数据同步更新。
API Key 全程留在 host 进程内：插件通过 DSH 的凭据通道（ctx.credentials）解析 DEEPSEEK_API_KEY，在 host 侧请求官方余额接口（GET https://api.deepseek.com/user/balance），浏览器只拿到余额结果，永远接触不到 Key。
安装
# 从 GitHub 安装（发布后）
dsh plugin --profile web add https://github.com/MatsMQ/dsh-deepseek-balance
# 或本地路径安装
dsh plugin --profile web add <本包路径>
依赖：host 侧需要 webServer 与 credentials 服务（web profile 自带），浏览器侧需要 react（shell 自带）。
使用
- 确保凭据已配置（
$DSH_HOME/.credentials.yaml或环境变量）：DEEPSEEK_API_KEY: sk-...，与模型设置中使用的 Key 一致。 - 重启 DSH Web 服务（插件在启动时装载）。
- 进入会话后可在标题栏右侧看到余额徽章，悬停显示完整明细与更新时间；完整页在 设置 → 插件 → 账户余额。
配置（cordis.patch.yml 的 entry config）
| 字段 | 默认值 | 说明 |
|---|---|---|
credentialRef | DEEPSEEK_API_KEY | 使用的凭据引用名 |
upstreamUrl | https://api.deepseek.com/user/balance | 余额查询端点 |
timeoutMs | 10000 | 上游请求超时（毫秒） |
路由
GET /dsh-balance（exact）— 余额 JSON，Cache-Control: no-store。- 浏览器请求做同源围栏（校验
Sec-Fetch-Site），防止 DNS-rebinding 类跨站读取；无该头部的本地工具（curl、node）不受影响。 - 返回码：
no-credential/unauthorized/upstream/network，以及成功时的{ ok: true, data, fetchedAt }。
安全边界
- Key 不出 host 进程；路由只返回余额数据。
- 默认 Web 部署只监听
127.0.0.1；若把 webServer 绑到0.0.0.0，该路由也会暴露到局域网（余额信息，非密钥）。 - 本插件不修改任何配置或凭据文件。
项目文件与信号
以下项目是目录快照中检测到的公开仓库信号。
测试已检测
仓库信息
- 开发语言
- JavaScript
- 许可证
- MIT
- 最后更新
- 2026年8月15日 11:41
谨慎安装
请检查源代码、权限、生命周期脚本、依赖与网络访问；不受信任的插件应先在隔离环境中测试。