dsh-account-balance

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` 并渲染。

## 安装

在插件目录（本目录）下运行：

```sh
dsh plugin --profile web add .
```

等价于手动方式：把 `dsh-account-balance` 加进 `$DSH_HOME/profiles/web/package.json` 的 `dependencies` 与 `dsh.profile.bundles`。

## 生效

重启 web 服务即可看到余额：

```sh
# 停掉当前 dsh web，再启动
dsh web
```

## 配置

插件复用 DeepSeek 官方适配器的凭证来源，无需额外配置：

| 配置 | 说明 |
| --- | --- |
| `DEEPSEEK_API_KEY` | API Key（web 模型设置页写入的托管凭证、`.env`、或环境变量均可） |
| `DEEPSEEK_BASE_URL` | 可选，覆盖余额接口基地址，默认 `https://api.deepseek.com` |

余额接口返回格式以 [DeepSeek 官方文档](https://api-docs.deepseek.com/zh-cn/api/get-user-balance/) 为准。