在使用 DeepSeek Harness (DSH) 进行开发或日常对话时，缺乏可视化的用量统计容易导致成本失控。这个插件通过后台静默采集，解决了从会话日志回填数据以及实时监控费用的问题。
插件简介¶
dsh-usage-guard 是 DSH Web GUI 的用量统计面板。由 hb-degithub 维护，专注于后台静默采集、按模型分析、费用估算及每日超限守卫。
核心功能¶
- 静默采集：挂钩会话事件，按天、提供商、模型维度折叠 token 用量。支持重启不丢数据，首次运行自动从会话日志回填。
- 仪表盘：包含六张统计卡（tokens、会话数、消息数、活跃天数、连续天数、最常用模型）、GitHub 风格活跃热力图（年度视图、星期/月份标注、逐日悬浮详情）、多序列趋势图（输入/输出/缓存命中/缓存创建/成本，双轴，7/30 天切换）、模型用量环形图。
- 费用估算：支持按模型配置价格（每 1M tokens 的 输入/输出/缓存读/缓存写）。内置 DeepSeek 刊例价。未配置价格的模型不计费，不会进行猜测。
- 每日超限守卫：可选每日 token 或费用上限。
warn模式显示全局横幅提醒，block模式在请求发出前拦截。 - 中英双语：跟随 DSH 主题令牌，无外部运行时依赖。
安装与启用¶
通过命令行安装：
dsh plugin --profile web add dsh-usage-guard
安装完成后重启 dsh web，在设置菜单中打开 使用统计 即可查看面板。
典型用法¶
安装完成后，访问 设置 → 使用统计。插件支持从插件市场（设置 → 插件市场）或 GitHub 一键安装。
适用场景与注意¶
- 适用场景：需要精细化控制 token 消耗和预算的开发者。
- 权限注意：插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。
结语¶
dsh-usage-guard 提供了一个轻量级的用量监控方案，内置 DeepSeek 刊例价，避免盲目猜测成本。该项目采用 MIT 许可证。