余额悬浮胶囊 pyfei1994/dsh-balance

dsh-balance

DeepSeek 账户余额实时显示插件 —— 一个可拖拽、自动吸附窗口边缘的悬浮胶囊，悬停显示余额、今日消耗、模型价格，一键直达充值页。

dsh-balance 效果

功能

- 🟢 悬浮胶囊实时显示 DeepSeek 余额（每 60s 自动刷新，点击立即刷新；余额不可用变橙红）
- 🖱 可自由拖动，松手自动吸附到最近的窗口边缘（左 / 右）
- 📊 悬停展开详情面板：
- 今日金额消耗 / 请求次数 / Tokens（入 / 出拆分）
- 三个 DeepSeek 模型（v4-pro / v4-flash / v4-flash-vision）的峰时 / 闲时价格
- 「去充值」按钮，直达 DeepSeek 充值页
- 🔑 API key 全程留在 host 侧（DSH credentials 服务），不会下发到浏览器

安装

方式一：克隆后本地安装（推荐）

git clone https://github.com/pyfei1994/dsh-balance.git
cd dsh-balance
dsh plugin --profile <你的profile名> add .

<你的profile名> 通常就是 web（对应 dsh web）。

方式二：直接通过 git 源安装

dsh plugin --profile web add git+https://github.com/pyfei1994/dsh-balance.git

方式三：拿到目录直接装

好友之间拷贝插件目录后：

dsh plugin --profile web add /path/to/dsh-balance

安装后需要重启 dsh web（或对应 profile 的应用）才会加载生效。

配置（可选）

默认配置开箱即用（按 deepseek-v4-pro 计价）。如需自定义，在 profile 的用户层 patch（如 ~/.dsh/profiles/web/cordis.patch.yml）里加：

- id: balance
config:
model: deepseek-v4-pro # 计价主模型（今日消耗按它计费） peak: # 峰时价格（¥/百万 tokens） input: 9.0 cacheRead: 0.3 cacheWrite: 9.0 output: 27.0 offPeak: # 闲时价格（默认 = 峰时一半） input: 4.5 cacheRead: 0.15 cacheWrite: 4.5 output: 13.5 rechargeUrl: https://platform.deepseek.com/top_up # 「去充值」跳转地址 refreshMs: 60000 # 刷新间隔（毫秒）

默认价格取自 DeepSeek 官方定价（闲时段 00:30–08:30 UTC+8，价格为峰时一半）。

使用

- 拖动胶囊调整位置，松手自动吸附左右边缘
- 悬停胶囊展开详情面板（余额 / 今日消耗 / 三模型价格 / 充值）
- 单击胶囊立即刷新余额
- 面板里点「去充值 ↗」打开充值页

数据来源

- 余额：DeepSeek GET /user/balance（key 从 ctx.credentials 读取）
- 今日消耗：聚合所有会话的 assistant/message token usage，按请求实际发生时间判定峰 / 闲时计价
- 价格：内置 DeepSeek v4 官方定价表（v4-pro / v4-flash / v4-flash-vision-exp）

前提

- DEEPSEEK_API_KEY 已配置在 DSH credentials（~/.dsh/.credentials.yaml）
- host 侧有 webServer 服务（dsh web 默认提供）与 sessions 服务

License

MIT