dsh-ds-balance
把 DeepSeek 账户余额放进 DSH 的左边栏
DeepSeek account balance in the DSH sidebar
各版本改动 → Releases(与 npm 版本一一对应)
简体中文 · English
---
左边栏底部常驻一个状态环,点开能看到具体的余额数字。要改配置,进侧栏的 **插件(Plugins)** 页,点开本插件。密钥与账号跟官方模型页走,端点是官方那一个 —— 这三样都不在这里配。
## 数据与凭据
余额直接读 DeepSeek 官方接口,不是根据用量估算的。
- 凭据由 DSH 的凭据通道解析,插件不自己保存密钥:密钥不会写进设置文件。
- 界面只看得到**首尾片段掩码**(`sk-cf08d*****3b84`,与 DeepSeek 平台控制台同形),**完整密钥永不跨线**;密钥不落日志,不落本插件的任何文件。
- 只访问 `api.deepseek.com`,不代理、不转发其他流量。
- 余额快照按凭据分开存放 —— **换 key 会重新开始记账**,旧的数字不会混进来。
## 上手
**前置**:DSH 跟的是当前那条 RC 线(安装时写明 `@next`);Node `>= 20`。兼容范围的唯一出处是 [package.json](package.json) 的 `engines.dsh`。
1. 装宿主。`latest` 与 `alpha` 都不是我们声明的那条线,请写明版本线:
```bash
npm install -g @deepseek-ai/dsh@next
```
2. 装插件:
```bash
dsh plugin --profile web add dsh-ds-balance
```
3. 启动(或重启)`dsh --profile web`,左边栏底部就会出现余额条目。
从源码安装:`git clone` 之后 `pnpm install && pnpm run build`,再执行 `dsh plugin --profile web add "$PWD"`,同样重启生效。
那一步 `pnpm install` 不能省 —— 按路径挂载时依赖由仓库自己提供,漏装会让插件显示「未运行」。
## 显示什么
三处界面,各管一件事:
| 界面 | 位置 | 做什么 |
|---|---|---|
| 状态环 | 左边栏底部,常驻 | 一眼看得出还剩多少、离预警线多远 |
| 余额浮层 | 点条目展开 | 看总额、赠送 / 充值拆分,以及数据是几分钟前的 |
| 设置卡片 | Plugins 页里本插件的详情页 | 查两条读余额的途径,换币种、调预警线、调刷新节奏 |
条目常驻左边栏底部,点开是余额浮层:总额、赠送 / 充值拆分、数据是几分钟前的,右下角是手动刷新。
环本身就是「现在是什么情况」,一眼能分出五种:
| 环的样子 | 意思 | 你该做什么 |
|---|---|---|
| 彩环 + 一段弧 | 有余额,颜色表示多还是少 | 看数字 |
| 灰环 + 一段缺口在转 | 正在取,还没结果 | 等 |
| 灰环 + 中间一个 **+** | 还没接入账户 | 去配置 |
| 灰色空环 | 已接入账户,本身没有余额 | 不用管 |
| 红环 + 中间一个 **叉** | 这里没有可用的数字 | 去查 |
## 每样东西是什么
| 东西 | 说明 |
|---|---|
| 弧长 | 余额占该币种**预警线**的比例,满格封顶一整圈 |
| 颜色 | 只表示状态(正常 / 偏低 / 告急),与金额大小无关;**告急线只决定颜色**,不参与画环 |
| 中心记号 | **+** 是还没接入,去配置;**叉**是这里没有可用的数字 —— 读不到,或者读到了但账户不能用 |
| 悬停提示 | 数字可信时显示**金额**,其余情况显示这个状态自己的话;收起态与展开态说的是同一句,且停在按钮的任意位置都会显示 |
| 来源括号 | 浮层标题右侧:这份数字用的是**哪一份凭据** —— 首尾片段掩码如 `sk-cf08d*****3b84`,或已登录账号的名字 |
| 数据新鲜度 | 浮层里的「多久之前」,从收到数据的时刻算起 |
| 手动刷新 | 带冷却,冷却从刷完那一刻重新计时,浮层上的秒数就是真实剩余 |
| 设置分组 | 连接 / 展示 / 阈值 / 刷新 |
## 配置
卡片在 Plugins 页:侧边栏 **插件(Plugins)** →「已安装」→ 点 **DeepSeek 余额** 卡片进详情页。
配置区在详情页,描述下面,直接可改:
- **连接** —— 只读:本插件读余额的两条途径、每条此刻在用哪一份凭据、那份凭据从哪来,外加一个**真的去打提供方**的 **Test** 按钮。
- **展示** —— 金额用哪种币种,或让它跟随账户。
- **阈值** —— 每个币种两条线:预警线与告急线。同一币种内**告急值必须低于预警值**,保存时会拦下来。
- **刷新** —— 服务端刷新周期、界面轮询周期与手动刷新冷却;默认值适用于大多数情况。
保存即生效,不必重启 DSH。
详情页的配置区。组里有填错的项时,那一组会自己展开。
> **升级提示**:设置项的键名跟着宿主升级改过一次,**旧值不会自动迁移**;升级之后请按上面四组重填一次。另有一条:**3.0 删掉了两个设置项** —— 手写的 `apiKey` 与自定的 `baseUrl` 从此不再起作用(凭据以官方模型页那一份为准,端点固定为官方地址);手改过设置文件的请把它们删掉。
## 版本兼容
- **要哪一版宿主**:以 [package.json](package.json) 的 `engines.dsh` 为准 —— 那个范围写明本插件覆盖**哪几条宿主线**(含上限,上限之外不受支持)。需要配置界面就把宿主升到最新那条线:`npm install -g @deepseek-ai/dsh@next`。
- **声明按线显式枚举**:只承诺 `engines.dsh` 里列出的那几条线;跨到上限之外的新线,要先在 [compat.yml](.github/workflows/compat.yml) 的矩阵里实测过、再把它写进声明,不自动跟着宿主走。**已列线内的补丁版本(含预发布)不需要动声明**。
- **兼容性是实测出来的**:每周由 [compat.yml](.github/workflows/compat.yml) 在声明的那条宿主线上跑一遍测试,另有一步单独核对声明范围是否还罩得住;承诺线红了会开一条跟踪 issue。结论与处置见 [兼容性](docs/PUBLISHING.md#兼容性)。
## 许可
[MIT](LICENSE)。
## 贡献
缺陷与需求走仓库 Issues。
维护者文档地图 → [AGENTS.md](AGENTS.md)。