# dsh-deepseek-balance

一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：在 Web 界面右上角显示一个实时悬浮徽章，展示你的 DeepSeek API 账户余额。

[English](README.md) | 中文

## 它做什么

- host 半：注册 `GET /dsh-deepseek-balance` 路由，从 harness 的 credentials seam 读取 `DEEPSEEK_API_KEY`（回退到环境变量），返回 `GET https://api.deepseek.com/user/balance` 的结果。
- 浏览器半：在 `shell.overlay` 座位注册一个徽章，按可配置间隔轮询（默认 60 秒），点击可立即刷新。

API Key 不会进入浏览器；它每次请求都在 host 进程里解析。

## 安装

```sh
dsh plugin --profile web add dsh-deepseek-balance
```

然后重启你的 `web` profile 并刷新页面。徽章出现在右上角：

- 绿点 — 余额充足
- 黄点 — 余额耗尽
- 灰点 — 加载中
- 红点 — 请求失败（悬停查看原因）

**点击徽章**立即刷新（悬停可看 granted/topped-up 明细）。

## 配置

密钥就是 harness 调模型时用的那个。在 **Settings → Models** 里存一次即可（走 credentials seam），或直接导出：

```sh
export DEEPSEEK_API_KEY=sk-...
```

可在 bundle 行里加可选覆盖（`config:`）：

```yaml
config:
  refreshIntervalMs: 30000   # 轮询间隔（毫秒，默认 60000）
  baseUrl: 'https://api.deepseek.com'
```

## 从源码构建

```sh
pnpm install
pnpm build
```

`pnpm build` 产出 `lib/index.js`（host 半）和 `lib/client.js`（浏览器半）。

## License

MIT