dsh-usage-lite

为 DeepSeek Harness Web 界面提供简洁、优雅的余额与 Token 用量面板。

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

界面示意图：直观展示折叠态余额、供应商账户与聚合用量；具体文字和数据以实际运行环境为准。

为什么选择 Lite

dsh-usage-lite 只保留高频信息和必要操作：侧边栏快速查看余额，展开后查看供应商账户与近半年用量。没有独立后台、复杂配置页或遥测服务。

• 一眼查看余额：侧边栏直接显示所选供应商、当前余额和上次拉取时间。
• 自动发现供应商：读取 DSH 已配置的模型供应商并逐行展示，超出高度后在列表内滚动。
• 聚合本地用量：按日期、供应商和模型汇总 Token，并用 27 周热力图展示趋势。
• 明确能力边界：当前仅查询 DeepSeek 余额；其他供应商仍会展示并参与 Token 统计。
• 隐私优先：凭据只在服务端解析，不会返回浏览器；HTTP 接口仅接受本机回环请求。
• 中英文界面：跟随 DSH Web 的语言环境。

功能

余额

• 展示 DSH 中已配置的供应商账户。
• 查询 DeepSeek 当前余额、赠送额度和充值额度。
• 支持刷新、隐藏余额以及选择折叠态默认账户。
• 刷新失败时保留最近一次成功余额和拉取时间。
• 不支持余额查询的供应商会明确标记，且不能设为折叠态默认账户。

用量

• 汇总输入、输出、缓存读取和缓存写入 Token。
• 按供应商与模型展示 Token 和估算开销。
• 展示最近 27 周的每日用量热力图。
• 点击日期查看当日 Token 与估算开销。
• 用量视角聚合所有供应商，不受余额页默认账户选择影响。

安装

需要已安装并能够运行 dsh web 的 DeepSeek Harness 环境。

dsh plugin --profile web add dsh-usage-lite

安装后重启正在运行的 dsh web，并在浏览器中硬刷新。入口会出现在侧边栏设置项上方。

更新

dsh plugin --profile web update dsh-usage-lite

更新后同样需要重启 dsh web 并硬刷新浏览器，以避免旧客户端资源缓存。

卸载

dsh plugin --profile web remove dsh-usage-lite

配置

插件不维护独立供应商配置，而是读取 DSH 已有设置：

• 官方 DeepSeek 配置来自 llm-deepseek。
• 其他模型供应商来自 llm-pi-ai.providers。
• DeepSeek 默认凭据引用为 DEEPSEEK_API_KEY；若 provider 配置了 apiKeyEnv，则使用该引用。

例如在 DSH 凭据文件中配置：

## 配置

插件不维护独立供应商配置，而是读取 DSH 已有设置：

- 官方 DeepSeek 配置来自 `llm-deepseek`。
- 其他模型供应商来自 `llm-pi-ai.providers`。
- DeepSeek 默认凭据引用为 `DEEPSEEK_API_KEY`；若 provider 配置了 `apiKeyEnv`，则使用该引用。

例如在 DSH 凭据文件中配置：

```yaml

### DeepSeek 显示“未配置访问凭据”

确认 `llm-deepseek` 的 `apiKeyEnv` 与 `~/.dsh/.credentials.yaml` 中的键一致，然后重启 `dsh web`。