前言¶
在 DSH Web 中使用模型时，余额和本地 Token 用量分散在不同来源。dsh-usage-lite 为 DeepSeek Harness Web 界面提供一个侧边栏面板，用于集中查看 DeepSeek 余额、供应商账户和近半年本地用量。下面介绍它的能力、安装方式和边界。
这是什么¶
dsh-usage-lite 是 ericw0315 维护的 DSH 客户端插件，许可证为 MIT。它面向 DeepSeek Harness Web 界面，把 DeepSeek 余额查询与本地 Token 用量聚合放在同一个入口中。
核心功能¶
- 在侧边栏快速查看余额。
- 展开后查看供应商账户与近半年用量。
- 自动发现 DSH 已配置的模型供应商，并逐行展示。
- 查询 DeepSeek 当前余额、赠送额度和充值额度。
- 支持刷新、隐藏余额，以及选择折叠态默认账户。
- 汇总输入、输出、缓存读取和缓存写入 Token。
- 按供应商与模型展示 Token 和估算开销。
- 展示最近 27 周的每日用量热力图。
- 点击日期查看当日 Token 与估算开销。
- 跟随 DSH Web 的中英文界面。
安装与启用¶
需要已安装并能够运行 dsh web 的 DeepSeek Harness 环境。
dsh plugin --profile web add dsh-usage-lite
先执行上面的安装命令，再重启正在运行的 dsh web，最后在浏览器中硬刷新。
更新插件：
dsh plugin --profile web update dsh-usage-lite
卸载插件：
dsh plugin --profile web remove dsh-usage-lite
配置与常见状态¶
插件会自动发现 DSH 已配置的模型供应商，并用于余额和用量展示。若要让 DeepSeek 余额可用，可以在 DSH 凭据文件中配置：
# ~/.dsh/.credentials.yaml
DEEPSEEK_API_KEY: sk-your-key-here
确认 llm-deepseek 的 apiKeyEnv 与 ~/.dsh/.credentials.yaml 中的键一致，然后重启 dsh web。
使用中需要注意：
- 当前仅 DeepSeek 支持余额查询；其他供应商暂不支持额度查询，但仍可出现在用量聚合中。
- 用量依赖 DSH 会话事件中的
data.usage和模型来源字段；没有相应事件时，对应明细可能为空。 - 开销由内置价格表估算，未知模型当前按
deepseek-chat价格估算；应以供应商实际账单为准。 - 不要将真实 API Key 提交到 Git、公开 Issue 或日志中。
隐私与运行边界¶
- API Key 通过 DSH credentials 在服务端解析，不会发送到插件客户端。
- 插件服务端接口只接受本机回环地址发起的
GET请求。 - 项目不包含遥测、用户跟踪或远程分析服务。
- 插件以当前
dsh进程权限运行；安装前建议检查源码与 MIT 许可证。
适用场景¶
dsh-usage-lite 适合已经使用 dsh web 的开发者，尤其是需要在浏览器侧边栏集中查看 DeepSeek 余额、供应商 Token 用量和近半年趋势的场景。如果需求是跨供应商余额统一查询，它目前只覆盖 DeepSeek 的余额查询，其他供应商仍主要依赖 DSH 自身的用量事件聚合。
链接¶
- 目录页：https://www.skillhub.cn/plugins/ericw0315/dsh-usage-lite
- GitHub：https://github.com/ericw0315/dsh-usage-lite
