chenpengye/dsh-balance-local

dsh-balance-local

一个用于 DeepSeek Harness（dsh）的 DeepSeek API 余额插件：
在设置页显示你剩余的 DeepSeek API 余额，并在对话输入框下方以环境读数形式展示，
每 60 秒自动刷新。

安全优先：API key 仅在 Host 侧从 dsh 凭据库中解析，绝不会
到达浏览器。浏览器只是轮询一个同源、仅限回环的路由，该路由返回聚合的、
脱敏后的余额数据。

为 DeepSeek Harness（dsh）打造的余额查询插件：
在设置页显示「DeepSeek 余额」面板（总余额 / 充值 / 赠送），并在会话输入框下方显示余额徽章，每 60 秒自动刷新。

安全设计：API key 只在服务端（Host 进程）从 dsh 凭据库读取，永不进入浏览器；浏览器只轮询一个
同源、仅限本机访问的路由，拿到的是脱敏后的余额数据。

功能 / Features

- ⚙️ 设置页「DeepSeek 余额」面板：总余额 / 充值余额 / 赠送余额，手动刷新按钮
- 📌 会话输入框下方余额徽章（绿点=有余额 / 橙点=无余额 / 灰点=加载中或错误）
- ⏱ 每 60 秒自动刷新（Host 侧另有 30s 缓存）
- 🔒 key 不出服务端、路由仅本机回环可访问、错误分类返回（不透传上游响应体）

安装 / Install

该插件是一个 cordis bundle。它未发布到 npm —— 请从本仓库安装。

git clone https://github.com/chenpengye/dsh-balance-local.git
cd dsh-balance-local
pnpm install && pnpm build      # produces lib/index.js + lib/client.js

然后将其注册到你的 dsh profile（例如 web）：

cd ~/.dsh/profiles/web
pnpm add /absolute/path/to/dsh-balance-local -w

将 patch 条目添加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: dsh-balance-local
name: dsh-balance-local

重启 dsh web（或触发 HMR watcher）并硬刷新浏览器页面（Cmd+Shift+R）。

中文：克隆本仓库 → pnpm install && pnpm build → 在 ~/.dsh/profiles/ 下
pnpm add  -w → 在 cordis.patch.yml 里加上面的 insert 条目 → 重启 dsh web
或触发 HMR 热加载 → 硬刷新页面即可在设置页和输入框下方看到余额。

使用 / Usage

- API key 来自 dsh 凭据库（DEEPSEEK_API_KEY），与
设置 → 模型 中保存的是同一个。无需额外配置。
- API key 复用 dsh 凭据库中的 DEEPSEEK_API_KEY（设置 → 模型 里保存的那个），无需额外配置。

配置项 / Configuration

Host 侧配置（显示默认值），可在 profile 配置中覆盖：

| Key | Default | Description |
| --- | --- | --- |
| apiKeyRef | DEEPSEEK_API_KEY | 在 Host 上解析的凭据引用 |
| baseUrl | https://api.deepseek.com | 上游；仅限 HTTPS（测试允许回环 HTTP） |
| timeoutMs | 10000 | 上游请求超时 |
| cacheMs | 30000 | Host 侧响应缓存 |
| allowRemote | false | 为 false 时，非回环请求将以 403 拒绝 |

安全 / Security

- 凭据永不离开 Host 进程；浏览器只能看到聚合后的余额。
- 该路由拒绝非回环请求（默认 allowRemote: false）。
- 错误会被分类（INVALID_API_KEY、RATE_LIMITED、UPSTREAM_TIMEOUT 等）—— 不透传上游响应体。
- 响应为 no-store + nosniff。
💡 另见：dsh-balance-whale —— 同一插件的鲸鱼娘悬浮框版本。同款鲸鱼娘悬浮框版本。

许可证

MIT —— 参见 LICENSE。