dsh-balance-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 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 页面,侧边栏底部出现余额按钮