@9Epuuuu/dsh-api-balance

English | 中文

DSH Web 输入框上侧的 DeepSeek 账户余额常驻显示：始终可见地显示账户余额与本次会话用量：

余额 ¥128.50 · 本次会话用量 ¥3.25

余额来自 DeepSeek 官方 GET /user/balance 接口，由宿主侧代查（规避浏览器 CORS）。本次会话用量采用「余额差值法」：某会话首次读到余额时记为该会话的起始余额，用量 = 起始余额 − 当前余额，负数归零。

功能

• 宿主侧：注册 GET /api/balance（仅限本机回环），经 DSH 的 ctx.credentials 服务解析 API key，按配置间隔拉取并缓存 DeepSeek 余额，并注册 api-balance 设置命名空间。
• 客户端：在 conversation.composer.dock（输入框上方的内置状态行）挂载一行，并在 Web UI 插件分组挂载设置卡。

安装

推荐直接安装全家桶聚合包 @linxin666/dsh-web-ui-all（一个包装齐全部功能插件与皮肤），或单独安装本插件：

# 推荐：直接从 npm 安装
dsh plugin --profile web add @9Epuuuu/dsh-api-balance

# 或从仓库安装（开发调试）
git clone https://github.com/9Epuuuu/dsh-api-balance.git
cd dsh-api-balance
pnpm install && pnpm build
dsh plugin --profile web add link:$(pwd)

安装后重启 dsh web，在插件设置中填写 API key 凭证引用名，输入框上方即出现余额行。

配置

键	类型	默认值	含义
apiKeyEnv	string	''	用于解析 DeepSeek API key 的 DSH 凭证引用名，如 DEEPSEEK_API_KEY
refreshIntervalSec	number	60	余额拉取的最小间隔（也是浏览器端轮询节奏）
enabled	boolean	true	插件总开关（浏览器侧 + 宿主路由）

本次会话用量如何计算

账户余额是全局的；本次会话用量按 sessionId 各自派生：

1. 某会话首次成功读到余额时，把该余额持久化（存 localStorage，按会话 id 区分）为该会话的起始余额。
2. 之后每次轮询，用量 = max(0, 起始余额 − 当前余额)。
3. 刷新页面沿用该起点；切换会话则重新起算。

导出形态

函数/命名空间插件：inject / Config / apply，无默认导出。DeepSeek 适配器（./deepseek-balance）为纯「拉取 + 归一化」辅助函数。

模型体验

提示与工具面

模型看到什么

什么也看不到。插件不注入提示段落、不注册工具、也不自行发出 session 事件。

Token 影响