前言¶
DeepSeek Harness (DSH) 依赖插件扩展功能。在日常开发或使用中，需要直观地掌握当天的 Token 消耗、缓存命中率以及账户余额情况。dsh-plugin-duwg 插件通过在输入框下方挂载一个小部件，聚合当日所有会话的 Token 消耗，并提供缓存命中率与余额的可视化展示。
是什么¶
该插件由开发者 Yolotd 维护，属于客户端插件。它解决的核心问题是：在 DSH 使用过程中，无法快速看到当天精确的 Token 统计与余额状态。插件通过读取本地会话日志和网关透传数据，实现数据的聚合与展示。
核心功能¶
该插件提供以下功能：
- 今日总消耗：汇总当天所有会话的 input（输入）、output（输出）、cache-read（缓存读取）和 cache-write（缓存写入）的 Token 总数。
- 会话日志校准：插件启动时，会扫描
$DSH_HOME/sessions目录下的.l.zstd文件进行校准，确保数据在进程重启或崩溃后不丢失。 - 万/亿简化显示：大数字会自动转换为“万”或“亿”的简写形式，鼠标悬停可查看精确数值。
- 缓存命中率：实时显示缓存读取占总量的比例，以绿色数字呈现。
- 余额血条：显示 DeepSeek 账户当前余额与当天最高余额。余额较低时会变红提示。
- 预计消耗：基于网关透传的
usage.cost字段进行累计计算。 - 持久化：数据被写入
$DSH_HOME/storages/duwg/usage.json文件，支持跨进程保留与跨天自动重置。
安装与启用¶
安装前请确保已安装 DSH。通过以下命令安装插件：
dsh plugin --profile web add dsh-plugin-duwg
或者从本地仓库/源码安装：
dsh plugin --profile web add <本仓库路径或 git URL>
安装完成后，重启 dsh web，小部件会自动出现在输入框下方。
安全与隐私¶
该插件对隐私和安全性有明确的设计原则：
- API Key 安全：API Key 仅存在于 host 端，绝不进入浏览器环境。
- 网络请求：余额查询仅调用 DeepSeek 官方接口，并带有 60s 缓存以降低调用频率。无任何第三方网络请求或遥测行为。
- 本地扫描：会话日志扫描仅读取本地
$DSH_HOME/sessions下的文件，用于校准用量，不对外发送数据。
适用场景¶
该插件适合需要在 DSH 界面中实时监控 Token 成本与缓存效率的开发者或用户。由于数据基于本地文件和官方接口计算，无需担心云端数据泄露问题。
结语¶
dsh-plugin-duwg 通过轻量级的 UI 组件，将分散的 Token 消耗与余额信息聚合展示。对于关注成本控制或缓存优化的人员，该插件提供了直观的参考数据。
- 目录页: https://www.skillhub.cn/plugins/Yolotd/dsh-plugin-duwg
- GitHub: https://github.com/Yolotd/dsh-plugin-duwg
