dsh-usage-meter：DeepSeek Harness 模型用量仪表盘插件

前言¶

在使用 DSH（DeepSeek Harness）进行智能体开发时，需要直观地掌握模型调用成本与效率。现有方案往往依赖手动统计或外部工具。dsh-usage-meter 插件通过在设置页新增「用量」板块，按服务商和模型聚合全部会话的 token 用量，并提供时间趋势图。

是什么¶

该插件由 V-dev-388 维护，基于 MIT 协议。它利用官方 Cordis 服务被动监听会话事件，将数据落盘在本地，不依赖任何第三方库。其核心价值在于提供零外部依赖、本地化、可查询的用量统计能力。

核心功能¶

1. 汇总指标：显示请求数、总 Token、缓存命中率、输入 Token、输出 Token、缓存读取 Token。
2. 时间维度：支持今日（24 根小时柱）、近 7 天、近 30 天（按天柱），并自动根据本地时区切日。
3. 多维度视图：提供服务商表和模型表，分别展示各项指标。
4. 刷新机制：支持 60s 自动轮询与手动刷新。
5. 数据覆盖：统计全部会话（含子 agent 会话）。
6. cc-switch 同步：支持将用量数据同步到 cc-switch，实现统一统计。

安装与启用¶

使用官方 CLI 安装：

dsh plugin --profile web add dsh-usage-meter

安装后重启 dsh web（或刷新页面加载 client bundle），进入 设置 → 用量 即可查看。

典型用法¶

• 查看仪表盘：在设置页的「用量」板块查看汇总卡和趋势图。
• API 查询汇总：

    GET /dsh-usage-meter/summary?range=today\|7d\|30d

• API 查询会话明细：

    GET /dsh-usage-meter/sessions

• 关闭 cc-switch 同步：

    export DSH_CC_SWITCH_SYNC=0

适用场景与注意¶

• 适用场景：适合需要监控每日 token 消耗、评估缓存命中率、按模型维度分析调用情况的开发者。
• 注意：插件仅使用官方 Cordis 服务（sessions / fs / sessionQuery / webServer），无外部依赖。数据完全本地化，不联网、无遥测。数据存储于 $DSH_HOME/storages/usage-meter.json（原子写入）。

结尾¶

该插件提供了一个轻量级的本地用量统计方案，适合对隐私敏感或希望集成到现有工作流中的用户。源码与文档位于 GitHub。