dsh-usage-meter：DeepSeek Harness 侧边栏常驻用量仪表

DeepSeek Harness（DSH）采用插件化架构，开发者在调试或长时间运行会话时，往往需要频繁查看上下文窗口占用率和账号余额。手动进入设置页面会打断工作流。下面介绍一个插件，它在 DSH 侧边栏底部常驻一个仪表，提供常驻的用量与余额显示。

kxdyh/dsh-usage-meter 是由开发者 kxdyh 维护的客户端插件。它通过读取官方接口数据，在 DSH 侧边栏底部提供常驻的用量与余额仪表，无需打开设置页面即可实时掌握上下文占用率和剩余额度。

核心功能¶

1. 常驻侧边栏显示：仪表位于侧边栏底部，支持深色/浅色主题自适应。
2. 余额读取：直接读取官方账号接口余额，精确到小数点后 7 位，不进行四舍五入估算。
3. 上下文追踪：实时显示上下文窗口占用率、已用与上限 token 数量。进度条在占用率 70% 变为琥珀色，90% 变为红色。
4. 零额外请求：不轮询模型，不发送额外请求，仅利用宿主已有的会话数据。
5. 收起适配：侧边栏收起为 56px 导轨时，仪表自动变为紧凑环形指示器。

安装与启用¶

使用 dsh CLI 安装：

dsh plugin --profile <你的 profile> add github:kxdyh/dsh-usage-meter

安装完成后无需重启，侧边栏底部会立刻出现仪表。

典型用法¶

1. 安装后，仪表会自动出现在侧边栏底部，默认显示上下文占用率和余额。
2. 点击仪表区域可展开明细，查看输入/输出/缓存读取/写入的 token 详情。
3. 展开后点击刷新按钮（↻）可立即更新余额与用量，平时每 60 秒自动更新一次。
4. 若要查看余额，需在 DSH 设置中登录 DeepSeek 账号。

适用场景与注意¶

本插件依赖 dsh 桌面版或 Web 版。查看余额需先在 DSH 设置中登录 DeepSeek 账号，插件仅读取余额，不发起登录或上传凭据。

• Token 数据：仅在会话产生模型用量后才显示。
• 费用显示：不显示费用，也不进行费用估算。
• 侧边栏收起：收起时仪表会切换为环形指示器，悬停可查看数值。

该插件通过常驻仪表和精确读取官方数据，解决了开发者频繁查看用量和余额的需求，适合需要精细化控制上下文窗口和预算的开发者。