dsh-balance-strip
Manifest validA compact pill pinned to the right side of the DSH session tab bar that always shows the DeepSeek account balance, today's spend estimated from balance drops, and whether peak or off-peak pricing is a
余额胶囊 · dsh-balance-strip
在 DeepSeek Harness 会话页顶部标签行右侧,常驻一枚小胶囊:余额、今日已用(估算)、峰/谷,一眼看完,不用点、不用悬停、不用打开别的面板。界面语言是中文时显示汉字,其它语言自动换成英文。
非官方社区插件,与 DeepSeek 官方无隶属关系,也未获其背书。
源码与问题反馈:https://github.com/CPHWQ/dsh-balance-strip · npm:https://www.npmjs.com/package/dsh-balance-strip
预览
对话 上下文 上下文 编队 … ┌───────────────────────────────────┐
───── │ 今日 ¥0.40 估 │ 余额 ¥89.24 峰 │
└───────────────────────────────────┘
低谷时段(北京时间 00:30–08:30)整枚胶囊转绿,字换成「谷」:
┌───────────────────────────────────┐
│ 今日 ¥0.40 估 │ 余额 ¥89.24 谷 │
└───────────────────────────────────┘
界面语言不是中文时自动换成英文:Balance / Today ≈ / Peak / Off-peak
- 贴在标签行右侧:垂直按「对话」两个字的中线对齐,字号直接取标签的
computed font-size,所以改界面字号、换缩放比例、最大化/还原窗口,它都跟着走。 - 右边缘始终贴住会话栏的右边界,不跟窗口边缘走——窗口变宽、右侧留白变多,它不会跟着漂。
- 胶囊底色与描边跟随峰谷:峰偏红、谷偏绿,字色与底色是同一套变量,深色主题下自动换成另一组值。
- 整枚胶囊
pointer-events: none,点哪儿都穿透到底下的真实界面,不会挡输入框。
显示内容
| 读数 | 含义 |
|---|---|
| 余额 | 充值余额 + 赠金,按币种合计(优先 CNY)。符号跟着账户币种走:CNY ¥ / USD $ / EUR € / JPY JP¥ …,认不出的币种直接显示代码(如 SGD 12.34)。 |
| 今日 | 今天零点(北京时间)以来的余额下降额,估算值,所以数字后跟一个上标的「估」。账户币种变了(切账号)会清零重算,不会把两种钱加在一起。 |
| 峰 / 谷 | 当前处于 DeepSeek 的哪一个计价时段(谷 00:30–08:30,峰 08:30–次日 00:30)。 |
安装
环境要求:
- DeepSeek Harness
0.2.1-rc.2至0.2.x(写进engines.dsh,不兼容的版本会拒绝加载而不是半加载)。 - 已登录 DeepSeek 账户,或 profile 里配了
DEEPSEEK_API_KEY凭据。两者都没有时会显示余额 —,其它读数照常。
从 npm 安装:
dsh plugin --profile web add dsh-balance-strip
包是纯 JavaScript,没有构建步骤,因此不需要 allowBuilds 授权。
从 GitHub 安装(npm 装不上时的备选,适合跟着主干走):
dsh plugin --profile web add github:CPHWQ/dsh-balance-strip
若你的网络访问 GitHub 需要代理,先给 git 配好代理(git config --global http.proxy http://127.0.0.1:7897,端口按你自己的客户端改)再安装。
从本地 checkout 安装:
dsh plugin --profile web add link:/绝对路径/dsh-balance-strip
web 是 CLI Web 应用用的 profile 名,桌面版通常叫 desktop(桌面版的 profile 由 Electron 应用独占,CLI 改不了,请在应用的插件页里装,或让助手用它内置的插件工具装)。
装完要重启客户端(含系统托盘退出):插件往页面里注入脚本的通道只在宿主启动时收集一次,热装上的当次窗口不会出现胶囊。之后改样式就不用重启了——见下面「热替换」。
和别的余额类插件共存
同一块地方不要装两份。本插件与 dsh-whale-widget(小鲸鱼)位置不同但都显示余额,两个都开会看到两个读数,关掉其中一个即可。
卸载
dsh plugin --profile web remove dsh-balance-strip
桌面版在插件页里关掉开关。插件不写任何全局状态,卸载即完全还原;$DSH_HOME/.dsh-strip.json 是它唯一的落盘文件(今日累计与上一次余额),可以直接删。
工作原理
一半在宿主、一半在页面:
- 宿主(
lib/index.js)注册两条路由,并把一段内联脚本注入页面:GET /dsh-strip/data.json—— 现读余额、算今日已用、给峰谷与时段,返回 JSON;GET /dsh-strip/strip.js—— 现读assets/strip.js的内容返回(不缓存),所以改完样式一次请求就生效。
- 页面(
assets/strip.js)每 20 秒拉一次data.json,画那枚胶囊。失败时间隔缩到 6 秒重试。
余额两条来源,按顺序试:
| 顺序 | 来源 | 说明 |
|---|---|---|
| 1 | DEEPSEEK_API_KEY 凭据 → GET https://api.deepseek.com/user/balance | 取 balance_infos[].total_balance。 |
| 2 | deepseekAccount 服务(账号登录态) | 充值钱包 + 赠金钱包按币种求和,与官方的 total_balance 同口径。头、令牌、401 清理都由该服务负责。 |
热替换
data.json 里的 build 是 assets/strip.js 的 mtime,每次请求现算。页面发现自己手里的 build 和返回的不一样,就拆掉旧胶囊、删掉自己的 <script>、重新加载 strip.js?v=<build>。所以改前端不用重启、不用刷新页面,20 秒内自己换过来。
口径与误差
- 今日已用是估算的,不是账单。 插件没有账单接口,只能每 60 秒采一次余额,把下降额记进当天。
- 充值与赠金只移动基线,不会记成负数消费。
- 采样间隔内的多次小额请求会被合并;插件没跑的那段时间不计入。
- 同一天跨过北京时间零点会清零重算。
- 想看准确到每一次请求的账,得读会话事件算 token——那是另一件事,这一版不做。
隐私与安全
data.json没有认证,但只服务本机:非回环 socket 的对端、以及sec-fetch-site: cross-site的请求一律 403。同一台机器上的其它进程仍能读到余额数字。- 路由只返回金额、币种、时段与估算值:没有账户 ID、没有资料、没有令牌、没有流水。
- 余额查询走的是宿主已有的凭据/账号服务,插件自己不落盘任何凭据。
- 页面脚本不加载远程内容、不用
eval、不上报遥测。 - 如果你把 Harness 公开部署到局域网/公网,胶囊在这些远端页面上会显示
余额 —(被上面那条规则挡住了),这是有意为之。
兼容性
| 组件 | 支持范围 |
|---|---|
| DeepSeek Harness | >=0.2.1-rc.2 <0.3.0(engines.dsh) |
| 界面 | 桌面版 Web GUI;CLI web profile 同样可用 |
| 余额来源 | DEEPSEEK_API_KEY 凭据 或 deepseekAccount 账户服务,二者其一 |
| Node(仅开发) | ^22.19.0 或 >=24.0.0 |
| 运行时依赖 | 无 |
故障排查
| 现象 | 检查 |
|---|---|
| 完全没有胶囊,控制台也不报错 | 多半是装完没重启客户端。注入通道只在宿主启动时收集一次,托盘退出重开即可。 |
显示 余额 — + 「同步中」 | 冷启动第一轮还没回来,等 6~20 秒;一直不动就是两条来源都不可用,看悬停提示里的原因码。 |
悬停提示 no-api-key / no-account-service | profile 里既没有 API key 凭据,组合里也没有 deepseekAccount 服务。 |
account-timeout | 账号服务 12 秒没回,通常是网络或平台侧抖动,会自己重试。 |
| 数字很久不动 | 每 60 秒才采一次;余额本身也只有账单结算后才变。 |
| 胶囊位置飘了 | 它靠找「对话」这两个字的文本节点定位。换语言包或改了标签文案时可能找不到,此时退回右下角固定位(assets/strip.js 里的 RIGHT / BOTTOM)。 |
远端访问时显示 余额 — | 本机以外的请求被 403 挡住了,见「隐私与安全」。 |
可调项
都在 assets/strip.js 顶部,改完 20 秒内自动生效(前端热替换):
| 常量 | 作用 |
|---|---|
GAP | 与标签行的水平间距 |
EDGE | 距会话栏右边缘的间距 |
RIGHT / BOTTOM | 找不到标签时的兜底固定位 |
POLL_OK / POLL_ERR | 正常/失败时的轮询间隔(毫秒) |
配色是两套 CSS 变量::root 给深色底,#dsh-strip-bar.is-light 覆盖成浅色底;峰谷各自一组 --off-* / --on-*。
开发
没有构建步骤,没有运行时依赖:
node --check lib/index.js
node --check assets/strip.js
pnpm pack --dry-run
目录:
lib/index.js 宿主侧:注入行、两条路由、余额两条来源、估算记账、回环栅栏
assets/strip.js 页面侧:定位、配色、轮询、热替换
cordis.patch.yml 补丁层(插入本插件行)
icon.png 插件图标
在真实 Harness 里调试:把本目录 link: 进你正在用的 profile,重启客户端,然后改 assets/strip.js——前端改动 20 秒生效,改 lib/index.js 才需要重启。
发布
pnpm pack --dry-run核对内容(应当只有lib/、assets/、cordis.patch.yml、icon.png、三个 md、LICENSE)。pnpm publish --access public。- 在干净的 profile 里
dsh plugin --profile demo add dsh-balance-strip验证真实安装路径(link:与 npm 的解析不一样,这一步不能省)。 - 给仓库打
dsh-plugintopic,README 里保留可复制的安装命令,然后提交到社区插件库。
许可证
Comments
Loading…
Similar plugins
by LZ-jun
Shows the DeepSeek account balance and the current peak / off-peak phase in the sidebar, and estimates per-session and per-turn cost using the official peak and off-peak rates.
★ 0
MIT
JavaScript
Oct 16, 2026
dsh plugin --profile web add dsh-balance-usageDSH plugin: real-time API balance in the sidebar with provider switching (DeepSeek / Zhipu GLM / OpenRouter / Tavily), peak/off-peak pricing, per-session and daily cost tracking, and configurable spending limits.
★ 0
dsh plugin --profile web add dsh-balance-monitorAccount balance beside the Harness mark, per-session spend beside each Session row, and a running-session spend list for DeepSeek Harness (dsh).
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-balance-spendReal DeepSeek account balance and official spend tracker in the session header, with peak/off-peak badge, monetary alert with auto-stop, and one-click top-up.
★ 0
dsh plugin --profile web add dsh-balance-trackerby Arun1016
Account balance and per-session cost pill for DeepSeek Harness (dsh) web GUI: official peak/off-peak pricing, per-model breakdown, no credentials stored.
★ 1
MIT
TypeScript
Oct 30, 2026
dsh plugin --profile web add dsh-costby dougen
Shows a card in the sidebar footer with the DeepSeek account balance (read from the official /user/balance endpoint with the API key DSH already stores) and the unit prices of the active model — input
★ 10
↓ 2.1k/wk
NOASSERTION
JavaScript
Nov 18, 2026
dsh plugin --profile web add @dougen/dsh-deepseek-usage