dsh-balance-display
已验证dsh-balance-display · v0.1.0 · MIT · Web 界面
DeepSeek API balance pill for the DSH Web GUI: shows remaining credit in the left sidebar footer with low-balance alerts, spend history, and a one-click top-up link. The API key never leaves the host process — the host half resolves it through the dsh cre
安装
dsh plugin add dsh-balance-display 用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。
源码
发布到 npm 但没有公开仓库。安装前请检查包内容。
标签
作者
说明文档
dsh-balance-display
DeepSeek API 余额显示插件（DeepSeek API balance pill for the DSH Web GUI）。
在 DSH Web GUI 的左侧栏底部显示 DeepSeek API Key 剩余额度，支持低余额预警、余额消耗趋势、一键跳转充值。密钥全程只在主机端：主机端通过 dsh 凭据服务读取 key 并查询 api.deepseek.com/user/balance，浏览器端只从本机回环路由拉取脱敏后的余额 JSON。
功能
- 左下角余额胶囊：
余额 ¥92.12，点击刷新，悬浮显示充值/赠送拆分 - 低余额预警：低于阈值时圆点变红 + 悬浮警告 + 可选浏览器通知（跨过阈值只提醒一次）
- 余额趋势：localStorage 记录历史点，设置页 sparkline + 今日/近 7 天消耗
- 充值直达：胶囊与设置页均可一键打开
platform.deepseek.com/usage - 错误退避：连续失败时刷新间隔自动 1min → 5min → 30min
- 页面隐藏时暂停轮询，回到页面立即刷新
- 跟随主题（浅色/深色/跟随系统），中英文界面
- Agent 协作：在系统提示中声明插件，智能体可在余额过低时提醒用户
安装
dsh plugin --profile web add dsh-balance-display
或本地开发：
dsh plugin --profile web add link:/path/to/dsh-balance-display
装完重启 dsh web（或硬刷新浏览器以加载客户端改动）。侧边栏底部出现余额胶囊；设置页出现「余额显示」tab。
安全
- API Key 只存在于主机进程：仅用于余额请求的
Authorization头，不持久化、不写日志、不下发浏览器 - 主机端对所有外发错误文本做脱敏（
sk-*/Bearer *替换为[redacted]），客户端二次脱敏兜底 - 路由仅 GET（余额）与 GET/POST（announce 配置），loopback 绑定，无 CORS
- 客户端 bundle 不含任何凭据，渲染全部走 React 文本转义，无
innerHTML
配置
设置页「余额显示」tab：
| 项 | 说明 |
|---|---|
| 侧边栏显示余额角标 | 开关胶囊显示 |
| 自动刷新间隔（分钟） | 默认 10 |
| 低余额预警阈值（¥） | 默认 5 |
| 余额不足时浏览器通知 | 需授权通知权限 |
| Agent 协作 | 在系统提示中声明插件 |
余额历史存于浏览器 localStorage（dsh.balanceDisplay.*），阈值与通知偏好仅存本地，主机端不感知。
兼容性
兼容桌面打包版（内嵌 dsh rc.5）与官网 npm 版 dsh web（rc.6）：两者共用同一套 profile 插件协议（bundle 挂载、/plugins/<id>/client.js、webServer 路由、credentials 服务），插件零 @deepseek-ai 运行时依赖，所有接入点特性检测。
License
MIT