余额用量面板 Jaimo-so/dsh-deepseek-usage

dsh-deepseek-usage

DeepSeek 用量与余额插件 —— 在 DeepSeek Harness（dsh） 的 Web GUI 中显示你的 DeepSeek API 余额、token 使用量与月度用量图表。

数据直接来自 DeepSeek 官方/平台接口，密钥只留在 Host 端，不经过浏览器。

功能特性

- 左下角余额胶囊（sidebar.footer.action，常驻，任何页面可见）
- 展开侧栏显示 余额 ¥110.00，收起（56px 窄轨）显示 ¥110（大额自动缩写为 ¥1.2k）
- 悬停反色，点击开合详情面板
- 输入框下 readout（conversation.composer.dock）
- 一行 DeepSeek 余额 ¥… + 手动刷新，悬停看明细
- 悬浮详情面板（shell.overlay）
- 概览：余额总额、充值/赠送明细、今日消耗、本次会话 token（输入/缓存/输出）
- 月度用量：当月每天的费用柱状图 + 本月合计（金额 + tokens），支持上/下月翻页
- userToken 配置：直接在面板里粘贴 platform.deepseek.com 的 userToken 并保存
- 自动刷新：每 60 秒拉取一次最新余额
- 全部样式使用 --dsw- 主题 token，自动跟随明暗模式

截图

（欢迎贡献实际运行截图，可放入 docs/ 并在本小节引用。*）

安装

把本包加入 dsh 的插件目录，或在你的 dsh 部署中通过 cordis.patch.yml 注册（见下）。

以 npm 链接或直接复制到插件目录后，在 dsh 部署配置中插入：
- insert:
- id: deepseek-usage
name: dsh-deepseek-usage

插件包含两部分：

| 文件 | 说明 |
| lib/index.js | Host 半：注册 /api/deepseek-usage、/api/deepseek-chart、/api/deepseek-token 三个同源路由 |
| lib/client.js | 浏览器半：渲染左下角胶囊、输入框 readout、悬浮面板与月度图表 |

配置

1. DEEPSEEK_API_KEY（必需，余额）

在 dsh「设置 → 模型」中填入 DeepSeek API Key（与模型调用共用同一个凭据引用 DEEPSEEK_API_KEY）。未配置时余额区域会提示。

2. DEEPSEEK_PLATFORM_TOKEN（可选，今日消耗 + 月度图表）

每日/月度用量只有 DeepSeek 平台（platform.deepseek.com）的私有接口才提供，公开 API 只有余额接口。因此需要平台登录态 token：

1. 用浏览器登录 platform.deepseek.com
2. 按 F12 打开开发者工具 → Application → Local Storage → 选中 https://platform.deepseek.com
3. 复制 userToken 的值（一长串）
4. 两种方式写入凭据：
- 面板内直接粘贴：打开插件面板 → 「月度用量」→ 粘贴 → 「保存并刷新」（等价于下面的 credentials.set）
- 或环境变量/凭据文件：把该值存为凭据引用 DEEPSEEK_PLATFORM_TOKEN

token 会过期（平台返回 HTTP 401 / code 40002 / 40003），重新登录后再取一次即可。

Host 路由（浏览器同源调用）

| 方法 | 路径 | 说明 |
| GET | /api/deepseek-usage?sessionId=<id> | 余额 + 今日消耗 + 指定会话 token 使用量 |
| GET | /api/deepseek-chart?month=6&year=2026 | 月度每日用量（费用 + token 数组）与月度合计 |
| POST | /api/deepseek-token body {"value":"<userToken>"} | 保存平台 token 到凭据服务 |

示例响应：

// GET /api/deepseek-usage
{
"ok": true,
"balance": { "currency": "CNY", "total": 110.5, "granted": 10, "toppedUp": 100.5, "isAvailable": true },
"today": { "cost": 1.23, "tokens": 4567, "source": "official" },
"session": { "inputTokens": 12345, "cacheTokens": 678, "outputTokens": 2345, "totalTokens": 15368 },
"warnings": []
}

// GET /api/deepseek-chart
{
"ok": true,
"month": 6,
"year": 2026,
"days": [
{ "date": "2026-06-01", "cost": 0.12, "tokens": 456 },
{ "date": "2026-06-02", "cost": 0.85, "tokens": 3210 }
],
"monthCost": 12.34,
"monthTokens": 45678
}

架构说明

- 密钥安全：DEEPSEEK_API_KEY / DEEPSEEK_PLATFORM_TOKEN 通过 ctx.credentials 按引用解析，只存在于 Host 进程内；浏览器端永远接触不到密钥。
- 会话 token：Host 监听 session/event 的 assistant/message 事件，累计 DeepSeek 每条回复实际上报的输入/缓存/输出 token（从插件启动后开始累计）。
- 月度图表：并行请求平台 usage/cost 与 usage/amount，按日期合并为完整的当月每日序列（无数据日为 null）。

许可

MIT