English | 简体中文

dsh-balance-monitor

DeepSeek 账户余额，直接显示在 dsh 侧边栏底部。

一个极简的 DeepSeek Harness (dsh) 插件：在侧边栏底部（设置上方）显示你的 DeepSeek API 账户余额、一条细的余额剩余比例条，以及当天已花费的金额。样式完全使用官方设计令牌，克制内敛。

功能

安装

浏览器端 bundle 是手写的 classic script，无构建步骤，git 安装无需 prepare 脚本：

dsh plugin --profile web add "github:<you>/dsh-balance-monitor#main"

或从 npm（发布后）：

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

然后重启 Web UI（dsh --profile web）。卡片出现在展开的侧边栏底部、设置按钮上方。

工作原理

一个插件行同时承担两种角色（dsh.bundle patch + dsh.client 浏览器注册表声明）：

• 服务端半（lib/index.js）—— 在 ctx.connection 上注册 /balance RPC 通道（loopback 信任围栏）。每次调用读取 API key、查询余额 API、折算当日基线，返回 { ok, value }。
• 浏览器半（lib/client.js）—— 零依赖 classic-script bundle，注册 sidebar.footer.action 条目。卡片每 60s 轮询一次，标签页重新可见时立即刷新。

状态文件（$DSH_HOME/storages/balance-monitor.json）：

{
  "date": "2026-08-14",
  "dayStart": 100.0,
  "lastTotal": 99.5,
  "lastCurrency": "CNY",
  "updatedAt": 1755200000000
}

安全说明

• API key 永不离开服务端：浏览器半只能通过 RPC 通道看到余额数字，接触不到 key。
• 通道走 loopback 信任策略。
• 无遥测，网络请求仅官方余额接口。

目录结构

dsh-balance-monitor/
├── package.json        # dsh.bundle (patch) + dsh.client (浏览器注册表)
├── cordis.patch.yml    # 插入这一个组合插件行
└── lib/
    ├── index.js        # 服务端半：/balance RPC 通道
    └── client.js       # 浏览器半：侧边栏卡片（手写，无构建）

开发

无需工具链。直接改 lib/*.js；bundle 格式与官方 tsdown 预设产物一致（window.__ModuleLoader__.load({ id, factory })）。

License

MIT