SoDaZilla-zzz/dsh-liquid-glass-balance-card 预览 preview

SoDaZilla-zzz/dsh-liquid-glass-balance-card

Plugin插件 Native原生 ⭐ 5 MIT Usage & Cost用量与计费UI & Themes界面与主题

可拖拽的液态玻璃风格DeepSeek API余额卡片插件,适用于DeepSeek Harness(DSH)Web GUI / DSH 平台下的DeepSeek余额展示组件。

Project Overview项目介绍

This is a DSH-native plugin built specifically for the DeepSeek Harness (DSH) web graphical user interface. It adds a draggable floating card with a liquid glass visual effect to your DSH instance, which displays your DeepSeek API account balance, cumulative spend, and total token usage. To install the plugin, you need to have DSH CLI and the pnpm package manager installed on your machine. You can run the one-line install command dsh plugin --profile web add dsh-liquid-glass-balance-card to add it automatically, then restart DSH Web and refresh your browser page to see the card in the top-right corner.

The plugin supports two tiers of usage statistics: local stats aggregated from your DSH session logs, and optional online total stats pulled from the DeepSeek platform if you add your platform userToken. You can view usage trends across multiple time ranges including today, yesterday, the last 7 days, the last 30 days, and all time, with liquid-glass styled bar charts showing spend and token trends. It includes a one-click link to the official DeepSeek top-up page, and supports manual API key input, falling back to your existing DSH-configured DEEPSEEK_API_KEY if you do not enter a custom one.

All your credentials are stored securely through DSH's native credential system, and your API key never leaves your local machine; no analytics, tracking, or remote telemetry is included in this plugin. Any legacy storage of keys from older versions of the plugin are automatically migrated to the secure credential system on first run after upgrade. The plugin is open-source under the MIT license, so you can modify it or contribute to its development freely following the provided development steps in the README.

这是一款专为 DeepSeek Harness(DSH)网页界面打造的原生插件,它会在界面上添加一个可拖动的液态玻璃风格悬浮卡片,用于展示 DeepSeek API 的账户余额、累计消费金额和 Token 使用量。插件支持自定义玻璃颜色、调节液态玻璃效果参数,还可开启或关闭 3D 立体厚度效果,并能自定义厚度与侧向角度。卡片位置拖动后会自动保存在浏览器 localStorage 中。

它支持双层用量统计,本地统计由 DSH 会话日志聚合而来,可选配置 DeepSeek 平台的 userToken 获取全账户线上总用量,还能按今天、昨天、近7天、近30天等不同时间维度查看用量趋势,并用液态玻璃柱状图展示。用户可以一键跳转 DeepSeek 官方充值入口,支持手动配置 API 密钥,未手动配置时自动回退使用 DSH 已有的密钥。适合经常使用 DeepSeek API 的 DSH 用户跟踪成本。

安装需要 DSH CLI 和 pnpm 包管理器,可通过 dsh plugin --profile web add dsh-liquid-glass-balance-card 命令一键安装,安装后重启 DSH Web 刷新页面即可使用。API 密钥通过 DSH 官方凭据系统存储,不会明文保存,也不会离开用户本地机器,无任何追踪或遥测。插件采用 MIT 许可协议开源,可免费使用和修改。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-liquid-glass-balance-card

把 SoDaZilla-zzz/dsh-liquid-glass-balance-card 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-liquid-glass-balance-card

A draggable liquid-glass floating card for the DeepSeek Harness (DSH) web GUI that shows your DeepSeek API balance, cumulative spend, and token usage.

一个给 DeepSeek Harness(DSH)网页界面 使用的插件:在页面右上角显示 DeepSeek API 余额、累计消费 与 Token 用量,采用可拖动的液态玻璃卡片。

Created with ❤️ by sooodaaa · 创作者:sooodaaa

dsh-liquid-glass-balance-card cover


🎬 Demo / 效果演示

Demo GIF

GIF 预览 · 完整视频见下方播放器。

完整演示:液态玻璃效果、3D 立体厚度、颜色调节、余额与用量统计、充值入口。

Full demo: liquid glass, 3D thickness, color customization, balance & usage stats, and top-up entry.


✨ Features / 功能

English 中文
Floating card in the top-right corner by default 默认悬浮在右上角
Draggable; position is remembered in localStorage 可拖动,位置自动保存在浏览器 localStorage
Liquid Glass effect with adjustable parameters 液态玻璃效果,参数可实时调节
3D thickness effect with toggle, depth and side-angle controls 3D 立体厚度效果:可开关、调节厚度与侧向角度
Custom glass color while keeping liquid glass properties 自定义玻璃颜色,调节后仍保持液态玻璃特性
Shows total balance, availability, granted & topped-up balance 显示总余额、可用状态、赠送余额与充值余额
Currency preference (CNY / USD / Auto) to avoid multi-currency conflicts 币种偏好(人民币/美元/自动),避免多币种余额冲突
Cumulative spend & cumulative tokens 累计消费金额与累计 Token 用量
Two-tier usage stats: 本地 (aggregated from DSH session logs) + 总计(线上) (official DeepSeek platform usage) 双层用量统计:本地(由 DSH 会话日志聚合)+ 总计(线上)(DeepSeek 官方平台用量)
Time ranges: Today / Yesterday / Last 7 days / Last 30 days / All 时间维度:今天 / 昨天 / 近7天 / 近30天 / 全部
Optional platform userToken credential for online totals 可选配置 DeepSeek 平台 userToken 以启用线上「总计」
Toggle to show/hide the online totals in the card settings 卡片设置中可开关「总计(线上)」显示
Liquid-glass bar charts for 7d/30d spend & token trends, with the date range shown below 近7天/近30天液态玻璃柱状图展示消费与 Token 趋势,柱状图下方显示日期范围
One-click DeepSeek top-up link 一键跳转 DeepSeek 官方充值入口
Manual API key input in the card settings 支持在卡片设置中手动填写 API Key
Falls back to the DSH DEEPSEEK_API_KEY credential 未填写手动 Key 时自动使用 DSH 已配置的 DEEPSEEK_API_KEY
Auto-refresh every 60 seconds + manual refresh 每 60 秒自动刷新,也可手动刷新
Configurable refresh intervals (balance & online totals) in the plugin config card 插件配置卡中可分别设置余额与线上「总计」的自动刷新间隔
Follows DSH light/dark theme variables (--dsw-*) 跟随 DSH 明暗主题变量(--dsw-*)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-spur 下一个 Next dsh-drop-in →