dsh-usage-lite

dsh-usage-lite

在 DeepSeek Harness Web 侧边栏查看账户余额，展开同一个面板即可浏览本地 Token 用量、模型构成与每日趋势。

Compact provider balances and local token-usage analytics for the DeepSeek Harness Web UI.

由当前 lib/client.js、DSH 主题与图标实际渲染，使用固定示例数据；金额、账户和用量均为演示内容。为便于阅读，截图展开了面板的滚动区域。

查看深色界面

功能一览

• 侧边栏余额入口：显示默认账户、余额与更新时间，可直接刷新或隐藏金额；收起侧边栏后保留图标入口。
• 余额与用量并排展示：宽屏下左侧为余额和供应商账户，右侧为用量与趋势；窄屏自动切换为单列，内容可滚动。
• 四项用量指标：总 Token、总估算开销、近 7 日 Token、近 7 日日均 Token。
• 供应商与模型明细：按供应商分组列出各模型的 Token 和估算开销。
• 近 7 日堆叠柱状图：按模型区分颜色，展示每日构成和相对前 7 日的用量变化；点击某一天查看模型 Token 与占比。
• 27 周每日热力图：按用量深浅展示活跃情况，与柱状图联动选择日期，查看当日 Token 和估算开销。
• 本地会话聚合：合并内存与持久化会话，识别普通回复和上下文压缩等调用的模型归属，并对复制到子代理会话的历史调用去重。
• 跟随宿主外观：支持中文、英文以及浅色、深色主题，无需独立配置页面或后台服务。

安装与更新

需要已安装、能够运行 dsh web，且支持 profile 插件与 Web 客户端扩展的 DeepSeek Harness 环境。

## 使用

1. 点击侧边栏的「用量与额度」打开面板。
2. 在左侧查看当前余额、赠金额度、充值额度和供应商账户。支持余额查询的账户可以设为折叠态默认账户。
3. 在右侧查看累计用量与模型明细。点击近 7 日柱状图，查看所选日期的模型构成；点击热力图，查看历史某一天的用量。
4. 点击刷新按钮重新拉取余额和本地统计；点击侧边栏的金额显隐按钮切换余额显示。

点击关闭按钮、面板外部或按 `Esc` 可收起面板。默认账户与余额显隐偏好保存在当前浏览器的 `localStorage` 中。面板首次加载时自动拉取数据，后续通过刷新按钮更新。

刷新失败时，当前页面会保留最近一次成功获得的余额及更新时间，并显示失败状态。账户切换只影响余额展示，用量始终聚合所有供应商。

### DeepSeek 显示「未配置访问凭据」

检查 `llm-deepseek.apiKeyEnv`（默认 `DEEPSEEK_API_KEY`）是否能被 DSH credentials 解析，然后点击刷新。若通过进程环境变量配置 Key，需要让正在运行的 `dsh web` 进程取得该变量。