前言¶
使用 DSH 网页界面接入 DeepSeek API 时，余额、累计消费和 Token 用量通常分散在不同位置：有的要看平台控制台，有的要从会话日志里统计。对经常切换项目、需要快速确认额度的人来说，来回切页面会增加不少成本。
dsh-liquid-glass-balance-card 是一个给 DeepSeek Harness（DSH）网页界面使用的插件。它把 DeepSeek API 余额、累计消费和 Token 用量放进同一个可拖动的液态玻璃卡片中，默认出现在页面右上角。
下面介绍这个插件能做什么、如何安装、如何配置 API Key 和平台 userToken，以及使用时需要注意的事项。
这是什么¶
dsh-liquid-glass-balance-card 是 DSH 网页界面中的一个余额与用量卡片插件。它的定位很直接：在 DSH Web 页面里显示 DeepSeek API 的余额、累计消费和 Token 用量，并允许拖动卡片位置。
该插件属于 DSH 社区插件生态。DSH 强调“一切皆插件”，社区目录是独立站点，不等于 DeepSeek 或幻方的官方应用商店。
已核实信息显示：
- 仓库名称：
dsh-liquid-glass-balance-card - 仓库 owner：
SoDaZilla-zzz - README 与
package.json作者字段显示：sooodaaa package.json声明版本：0.2.0- 许可证：
MIT - GitHub 仓库：https://github.com/SoDaZilla-zzz/dsh-liquid-glass-balance-card
核心功能¶
这个插件主要提供以下几类能力：
- 默认在 DSH 网页界面右上角显示一张可拖动的液态玻璃卡片。
- 显示 DeepSeek API 总余额、可用状态、赠送余额与充值余额。
- 显示累计消费金额与累计 Token 用量。
- 支持今天、昨天、近7天、近30天、全部时间维度。
- 提供双层用量统计：本地 DSH 会话日志聚合，以及 DeepSeek 平台线上总计。
- 可选配置 DeepSeek 平台
userToken，用于启用线上总计。 - 卡片设置中可以开关线上总计显示。
- 近7天、近30天以液态玻璃柱状图展示消费与 Token 趋势。
- 液态玻璃效果参数可实时调节，包括透明度、背景模糊、饱和度、高光强度、流动光线。
- 3D 立体厚度效果可开关，并可调节厚度与侧向角度。
- 可自定义玻璃颜色，同时保持液态玻璃特性。
- 币种偏好支持
CNY、USD、Auto。 - 一键跳转 DeepSeek 官方充值入口。
- 支持手动填写 DeepSeek API Key；未填写时回退使用 DSH 已配置的
DEEPSEEK_API_KEY。 - 每 60 秒自动刷新，也可手动刷新。
- 插件配置卡中可分别设置余额与线上总计的自动刷新间隔。
- 跟随 DSH 明暗主题变量
--dsw-*。
安装与启用¶
安装需要 DSH CLI 与 pnpm。先执行下面的安装命令：
dsh plugin --profile web add dsh-liquid-glass-balance-card
安装完成后，重启 DSH Web：
dsh web
打开浏览器访问：
http://127.0.0.1:3080
刷新页面后，卡片会出现在页面右上角。
如果选择手动安装，需要做两件事：
- 将插件包放入对应 profile 的
node_modules目录。 - 在
~/.dsh/profiles/web/cordis.patch.yml中加入 loader entry。
loader entry 示例如下：
- insert:
- id: liquid-glass-balance-card
name: dsh-liquid-glass-balance-card
经过上面的步骤后，再启动 DSH Web，卡片就会加载进网页界面。
典型用法¶
配置 DeepSeek API Key¶
卡片显示余额前，需要先有可用的 DeepSeek API Key。可以通过两种入口配置：
- 卡片上的齿轮图标。
设置 → 插件 → 插件配置 → DeepSeek 余额卡片。
操作步骤：
- 粘贴 DeepSeek API Key。
- 点击保存。
保存后，手动填写的 Key 会优先于 DSH 已配置的 DEEPSEEK_API_KEY。如果点击清除，删除手动 Key 后，插件会回退使用 DSH 自身的 DEEPSEEK_API_KEY。如果手动 Key 和 DSH 已配置的 DEEPSEEK_API_KEY 都没有，卡片会显示明确的错误提示。
该 Key 通过 DSH 官方凭据系统存储，引用名为：
DSH_LIQUID_GLASS_API_KEY
它不会落进插件自有的明文文件，浏览器也看不到明文。
如果此前使用过 v0.1，并且旧 Key 存储在：
$DSH_HOME/storages/dsh-liquid-glass-balance-card.json
下次启动时会自动迁移进 DSH 凭据系统，随后旧文件会被删除。
启用线上总计¶
线上总计需要 DeepSeek 平台 userToken。普通 API Key 无法读取线上总计，因为线上总量来自已登录平台会话的用量接口。
线上总计读取的两个接口是：
platform.deepseek.com/api/v0/usage/amount
platform.deepseek.com/api/v0/usage/cost
获取 userToken 的步骤如下：
- 在浏览器中登录 DeepSeek 平台。
- 打开开发者工具。
- 进入
Application → Local Storage → platform.deepseek.com。 - 复制
userToken的值。 - 将该值粘贴到卡片设置或插件设置中并保存。
平台 userToken 通过 DSH 凭据系统存储，引用名为：
DSH_LIQUID_GLASS_PLATFORM_TOKEN
该 Token 不会回流到浏览器 UI 的返回流量中。浏览器只访问本地宿主路由；宿主仅将其发送给 platform.deepseek.com 的两个用量接口。
线上总计是账号级统计，包含非 DSH 客户端产生的用量，并按北京时间对齐。因此，它通常不等于某个 DSH 会话或某个项目内的本地统计。
调整液态玻璃效果¶
卡片中的液态玻璃效果可以在设置面板里实时调节。可调参数包括：
- 透明度
- 背景模糊
- 饱和度
- 高光强度
- 流动光线
- 3D 立体厚度
- 侧向角度
- 玻璃颜色
参数保存在浏览器 localStorage 中，并提供恢复默认按钮。
适用场景与注意¶
这个插件适合以下几类使用场景：
- 在 DSH 网页界面中频繁调用 DeepSeek API，需要随时查看余额。
- 希望在同一页面里看到本地会话统计和平台线上总计。
- 需要按今天、昨天、近7天、近30天、全部时间维度查看消费和 Token 用量。
- 希望卡片外观可调节，并与 DSH 明暗主题保持一致。
使用时需要注意几点：
- 插件以当前
dsh进程权限运行。安装前应检查源码、依赖与许可证。 - 手动 API Key 优先于 DSH 已配置的
DEEPSEEK_API_KEY。 - 线上总计需要平台
userToken，不是普通 API Key。 - 线上总计是账号级统计，会包含非 DSH 客户端用量。
- 平台
userToken只应由宿主发送给 DeepSeek 平台用量接口，不要把它当作普通 API Key 使用。 - 玻璃参数保存在浏览器
localStorage中，换浏览器或清理本地数据后可能需要重新设置。
结尾¶
dsh-liquid-glass-balance-card 解决的是一个很具体的问题：在 DSH 网页界面里快速查看 DeepSeek API 余额、累计消费和 Token 用量。它把余额、本地统计、线上总计、时间维度和趋势图集中到一张可拖动的卡片中，并且把 Key 和平台 Token 交给 DSH 凭据系统处理。
已核实资料未给出可确认的社区目录页地址；如需查看源码、提交 issue 或确认安装细节，可访问 GitHub 仓库：
https://github.com/SoDaZilla-zzz/dsh-liquid-glass-balance-card
