前言¶
在使用 DeepSeek Harness 进行开发或日常交互时，实时掌握 Token 消耗与账户余额有助于控制成本和监控运行状态。下面介绍一个侧边栏插件，用于在 Web 界面中直接展示这些关键数据。
插件简介¶
该插件由 zdjmrq 维护，属于客户端插件。它通过在侧边栏底部增加一行标签，提供用量和余额的概览与详情查询功能，无需离开当前页面即可获取数据。
核心功能¶
-
用量/余额标签行
在侧边栏底部「设置」按钮上方，显示一条简洁的「用量 | 余额」标签行。标签与设置、Cordis 面板同一排位，与 Cordis 面板纵向堆叠、互不冲突。 -
玻璃拟态详情卡
鼠标悬停标签行时，在右侧展开玻璃拟态详情卡。卡片包含四项数据：- 运行时长（xxmxxs，每秒跳动）
- Token 数量（输入/输出）
- 估算金额（基于内置价格表计算）
- 官方账户余额（真实接口数据）
-
滑杆开关控制
详情卡底部提供椭圆滑杆开关，用于在「悬停显示」和「固定常驻」两种显示模式间切换。 -
自适应布局
详情卡宽度自适应桌面环境。右侧空间不足时，卡片会自动翻转到左侧展开。当侧边栏折叠为竖条时，仅显示 ¥ 徽标。 -
主题跟随
整体样式使用 DSH 主题变量（--dsw-*），支持亮/暗主题自动切换。
安装与配置¶
前置条件：
* Node.js ≥ 20
* DeepSeek Harness（需包含 dsh plugin 命令）
安装命令：
dsh plugin --profile web add github:zdjmrq/dsh-usage-balance
安装后，重启 dsh web 即可生效。
使用说明¶
- 查看概览：侧边栏底部会出现「用量 | 余额」标签行。
- 查看详情：鼠标悬停标签行，展开玻璃拟态详情卡。
- 切换模式：拖动卡片底部的滑杆，可将详情卡片固定在侧边栏中显示。
注意事项¶
- 金额估算：卡片中显示的金额为估算值，实际账单以 DeepSeek 官方为准。
- 网络与权限：余额查询功能需要可访问
api.deepseek.com的网络环境，并复用llm-deepseek设置中的 API Key。若网络不通或 Key 无效，余额项可能无法显示。
结尾¶
该插件通过侧边栏集成，简化了用量与余额的查看流程。相关源码与目录页可查看下方链接。
