jiangli07/dsh-deepseek-quota-bar

Name: jiangli07/dsh-deepseek-quota-bar
Author: jiangli07

插件Plugin 原生Native ⭐ 4 MIT cat_label.balancecat_label.balance cat_label.deepseekcat_label.deepseek cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh cat_label.plugincat_label.plugin cat_label.quotacat_label.quota

用于DSH Web GUI的DeepSeek API配额血条组件：显示剩余余额与月初对比、今日/本月花费、会话成本。可拖拽且可折叠。

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-deepseek-quota-bar 是 DSH Web 界面的悬浮额度血条插件。核心能力：实时显示余额与本月额度的比例（绿/橙/红），并展示今日、本月使用量（凭 DEEPSEEK_PLATFORM_TOKEN 取官方数据，否则按余额差估算）及当前会话费用，附带峰谷时段徽标、倒计时与可切换的 Flash/Pro 单价。适用场景：需要持续观察 DeepSeek API 额度消耗与峰谷调用成本的用户。提醒：分母取自月内首次观测到的余额快照，月中安装时会以「余额+当月官方消耗」反推，可能与官方初始值略有偏差。

dsh-deepseek-quota-bar is a floating widget plugin for the DSH web GUI. Core capability: a blood-bar showing the ratio of remaining balance to the month-opening snapshot, with today's and this month's spend, current session cost computed against official peak/off-peak pricing, and a peak-hour badge with countdown plus toggleable Flash/Pro unit prices. Use it when tracking DeepSeek API balance and peak/off-peak costs in real time. Caveat: the denominator is the first observed month balance, or back-calculated mid-month from current balance plus official usage, so the starting value may diverge from the platform's reference.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-deepseek-quota-bar】【https://github.com/jiangli07/dsh-deepseek-quota-bar】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add dsh-deepseek-quota-bar

把 jiangli07/dsh-deepseek-quota-bar 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.2 KB · 缓存于 2026-08-23 03:42:17 · 3.2 KB

dsh-deepseek-quota-bar

DeepSeek API 额度血条插件 for DeepSeek Harness (dsh) web GUI：右下角悬浮卡片，血条直观显示「余额 / 本月额度」，并展示今日与本月使用量（官方数据优先）。

A floating bottom-right widget for the dsh web GUI: a blood-bar of your remaining DeepSeek API balance vs the month-opening balance, plus today's and this month's spend (official platform data when configured).

dsh-deepseek-quota-bar 截图

功能 Features

🩸 血条：剩余比例 = 当前余额 / 月初余额快照（≥50% 绿 / ≥20% 橙 / <20% 红）
📅 今日/本月使用量：配置 DEEPSEEK_PLATFORM_TOKEN 后为官方精确数据；未配置时自动降级为余额差值估算
💬 当前对话费用：按官方价格表（含峰谷定价）对会话日志计价，含安装前历史
🕐 峰谷时段提醒：北京时间高峰（09:00-12:00 / 14:00-18:00）徽标 + 距下一时段切换倒计时 + 当前模型单价（Flash/Pro 点击切换，V4 官方峰谷价格表，半价低谷）
⚙️ 可调透明度：设置按钮 + 滑块（0-100%），背景不透明度可调并持久化
🖱️ 可拖动：按住卡片任意位置拖动，位置持久化（localStorage）
📉 可折叠：一键折叠为只显示血条的迷你卡，再点展开
🌗 跟随浅色/深色主题
⏱️ 余额每 60s 自动刷新，支持手动刷新

安装 Install

dsh plugin --profile web add dsh-deepseek-quota-bar
# 或从 GitHub 安装：
dsh plugin --profile web add github:jiangli07/dsh-deepseek-quota-bar

安装后重启 dsh web，打开页面强刷（Ctrl+Shift+R），右下角出现卡片。

配置 Configuration

凭证	必需	说明
`DEEPSEEK_API_KEY`	✅	与 harness 同一个 Key（设置 → 模型页面填写）
`DEEPSEEK_PLATFORM_TOKEN`	可选	platform.deepseek.com 的 `userToken`：F12 → Console → 执行 `JSON.parse(localStorage.getItem('userToken')).value`，把值写入 `~/.dsh/.credentials.yaml`

凭证是热读取的：配置后无需重启，下一次刷新即生效。

工作原理 How it works

余额：GET https://api.deepseek.com/user/balance
今日/本月（官方）：GET https://platform.deepseek.com/api/v0/usage/cost?month=&year=（与平台控制台同源）
今日/本月（估算兜底）：月初/当日期初余额快照差值，状态持久化于 ~/.dsh/storages/deepseek-quota-bar.json
血条分母：本月 1 号首次观测到的余额快照；月中新装时用「当前余额 + 本月官方消耗」反推
对话费用：订阅 session/event 实时计价 + 持久化日志全量回放（含重启前历史）

开发 Development

git clone https://github.com/jiangli07/dsh-deepseek-quota-bar.git
cd dsh-deepseek-quota-bar
dsh plugin --profile web add .

注意：修改 lib/client.js 后需重启 dsh web（bundle 引导哈希重新生成）再强刷页面。

许可 License

MIT。Fork 自 yingjunnan/dsh-deepseek-quota（MIT）；定价引擎参考 dsh-web-billing（MIT）。

渲染基于仓库 jiangli07/dsh-deepseek-quota-bar 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install