← 返回列表
未验证
dsh-deepseek-balance · DeepSeek 账户余额实时显示
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/15 · 已提供中文文档
# 用于 dsh Web GUI 的 DeepSeek 账户余额小组件——始终可见的对话头部徽章，外加一个完整的设置标签页
综合分
27.5
GitHub 分
27.5
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add MatsMQ/dsh-deepseek-balance该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
信任档位：仅索引本站尚未对其实装验证，仅收录元数据
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 本站尚未做安装检查
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 更新放缓：最近一次提交在 41 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
数据截至 2026/9/17（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成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 自带）。
使用
1. 确保凭据已配置（$DSH_HOME/.credentials.yaml 或环境变量）：DEEPSEEK_API_KEY: sk-...，与模型设置中使用的 Key 一致。
2. 重启 DSH Web 服务（插件在启动时装载）。
3. 进入会话后可在标题栏右侧看到余额徽章，悬停显示完整明细与更新时间；完整页在 设置 → 插件 → 账户余额。
配置（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，该路由也会暴露到局域网（余额信息，非密钥）。
- 本插件不修改任何配置或凭据文件。