DeepSeek Harness 插件

deepseek-balance-floating

DeepSeek 余额/用量悬浮窗插件:左下角红色血条(账户余额)+ 蓝色环(估算剩余 token)+ 今日消耗横条,数据基于 dsh-cost-meter。A floating balance & usage widget for the DeepSeek Harness web GUI: bottom-left red balance bar + estimated(英文原文)

跳到安装方式

来源信息

GitHub 仓库
yhPrime/deepseek-balance-floating
最近更新
2026年8月17日
分类
界面增强
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/yhPrime/deepseek-balance-floating
插件名:deepseek-balance-floating
作者:yhPrime

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

DeepSeek 余额悬浮窗插件(dsh-balance-floating)

> DeepSeek Harness Web 界面的左下角悬浮窗:红色血条 = 账户余额蓝色环 = 估算剩余 token今日消耗横条。 > 数据基于 dsh-cost-meter 插件提供(余额来自 DeepSeek 官方接口,token/费用来自它拦截 llm/stream 的账本)。

效果

侧边栏左下角(sidebar.footer.action 第一个格子,自动把「Cordis plugin」按钮与设置按钮挤到右侧):

<img width="85" height="136" alt="image" src="https://github.com/user-attachments/assets/95cd37ea-eca1-49e6-8812-c36de824680d" />

  • 悬停圆环/横条可查看明细(总额/赠送/充值、估算依据、输入/输出/缓存分项、调用次数)。
  • 每 60 秒自动轮询刷新;切换亮/暗/跟随系统主题时,配色自动跟随(读取主题语义色),「今日」文字用 mix-blend-mode: difference 相对实际背景逐像素反色。
  • 侧边栏收窄(rail 模式)时自动隐藏,避免挤占空间。

依赖

必须:本插件本身不联网、不记账,只做展示。数据全部来自:

  • dsh-cost-meter v1.3.1+ —— 余额(官方 /user/balance 接口)、今日/累计 token 与费用账本、官方价格表。

请先安装并启用 dsh-cost-meter,再安装本插件。

安装

前置:已安装 DeepSeek Harness(≥ 0.1.0-rc.5)并已安装 dsh-cost-meter。

# 方式一:从仓库目录直接添加
dsh plugin --profile web add /path/to/dsh-balance-floating

# 方式二:克隆后添加
git clone <本仓库地址>
dsh plugin --profile web add <克隆目录>

# 方式三:复制到 profile 的 node_modules 后添加
cp -r dsh-balance-floating ~/.dsh/profiles/web/node_modules/
dsh plugin --profile web add dsh-balance-floating

安装完成后重启(或刷新)DeepSeek Harness。在设置 → 外观中可切换主题查看效果。

配置说明

本插件暂无可视化设置页,两个刻度为内置常量,改动需编辑 lib/client.js

常量默认含义
BALANCE_CAP100血条满血额度(¥)
BLEND_INPUT / BLEND_OUTPUT0.7 / 0.3估算剩余 token 的混合单价权重(输入 cacheMiss / 输出)
今日横条额度¥100 的 token 数与满蓝同一基准

工作原理

1. 数据源:客户端经 Typert RPC 调用 dsh-cost-meter 挂载的 remote.costMeter.getState() / refreshBalance()(与 dsh-cost-meter 自身 UI 同一条通道)。 2. 余额血条balance.totalBalance,环填充 = 余额 / 100。 3. 剩余 token 估算余额 ÷ 汇率 ÷ 混合单价(混合单价 = 当前模型价表 0.7×输入未命中 + 0.3×输出,USD/1M tokens),满蓝 = ¥100 对应 token 数。 4. 今日消耗横条今日(input+output+cacheRead+cacheWrite) ÷ 满蓝 token 数。 5. 主题适配getComputedStyle 读取当前主题已解析的 --dsw-alias-* 语义色并内联应用;「今日」文字用 mix-blend-mode: difference 实现逐像素自动反色。

致谢 / 版权

  • 数据层:dsh-cost-meter(MIT)——本插件的余额与用量数据完全基于它提供。
  • 界面层:本插件独立实现(左下角血条/剩余环/今日横条),依赖 DeepSeek Harness 的 --dsw-* 主题语义变量与 Slot 系统。

MIT License,见 [LICENSE](./LICENSE)。