余额用量看板 stevenx65/dsh-balance-plugin

dsh-balance-plugin

Awesome DSH Plugin

DeepSeek Harness(dsh)web 插件:在 3080 端口的侧边栏底部显示 DeepSeek API 余额 和 token 用量,支持 今日/累计 切换,并按 provider 过滤(只统计 deepseek-official,忽略其他厂商)。

功能

- 💰 余额:调 DeepSeek 官方 GET /user/balance,key 复用 dsh 的 credentials(~/.dsh/.credentials.yaml),无需手动填
- 📊 token 用量:读取 dsh 原始 session 日志(session.jsonl.zstd),按 provider 过滤后聚合
- 未缓存输入 / 缓存读取 / 输出 / 模型调用次数
- 🔄 今日/累计切换:今日(北京时间当天)或全部历史
- 🎨 深色/浅色自动适配

截图

dsh-balance-plugin

一键安装(从插件市场)

dsh plugin --profile web add dsh-balance-plugin

重启 dsh web 后刷新页面,侧边栏底部出现余额按钮。

架构

浏览器(3080 页面)
client.js ──fetch──▶ /dsh-balance/data?scope=today|all
│
node 端(index.js,运行在 dsh 进程内)
├── credentials.resolve("DEEPSEEK_API_KEY") ← 复用 dsh 的 key ├── fetch(https://api.deepseek.com/user/balance) └── 解压 ~/.dsh/sessions///session.jsonl.zstd 逐行过滤 assistant/message + provider=deepseek-official

- index.js:node 端 cordis 插件,注册 HTTP 路由 /dsh-balance/data
- client.js:浏览器端插件,注入 sidebar.footer.action(侧边栏底部按钮 + 黑色浮层)
- package.json:dsh.client.platform: "web" + exports["./client"],供 dsh-client-modules 扫描

安装

1. 把 dsh-balance-plugin 目录放到 web profile 的 node_modules:

mkdir -p ~/.dsh/profiles/web/node_modules/dsh-balance-plugin
cp index.js client.js package.json ~/.dsh/profiles/web/node_modules/dsh-balance-plugin/

2. 编辑 ~/.dsh/profiles/web/cordis.patch.yml,加入:

- insert:
- id: dsh-balance
name: 'dsh-balance-plugin'

3. 重启 dsh web(如 tmux 里:tmux send-keys -t dsh C-c 然后 dsh web)

4. 刷新浏览器 3080 页面,侧边栏底部出现余额按钮

依赖

- node 端:仅 Node 内置模块(node:fs、node:child_process、node:path 等),需要系统有 zstd CLI 用于解压 session 日志
- 浏览器端:依赖 dsh 自带的 @deepseek-ai/dsh-client-ui-primitives(图标组件),dsh 0.1.0-rc.6 自带,无需额外安装

数据来源

原始会话日志位置:~/.dsh/sessions///session.jsonl.zstd

每条 assistant/message 行含:

{
"type": "assistant/message",
"time": 1786635270943,
"data": {
"message": { "source": { "kind": "model", "provider": "deepseek-official", "model": "deepseek-v4-pro" } },
"usage": { "inputTokens": 8702, "outputTokens": 298, "cacheReadTokens": 0 }
}
}

打包

npm pack # 生成 dsh-balance-plugin-0.1.0.tgz

License

MIT