DeepSeek Harness(DSH)是面向智能体开发的平台。在开发与调试过程中,上下文预算的管理往往容易被忽略,直到成本或性能出现问题。dsh-context-dashboard 旨在解决这一问题,提供会话维度的消耗明细与全局汇总报告。
这是一个客户端插件,用于统计 DSH 本地会话的上下文消耗情况。它由 uckkk 维护,采用 MIT 许可证。插件能够解析 DSH 的会话日志,并提供基于字符数与预估 token 的统计面板。
安装¶
安装插件需要使用 DSH 的插件管理命令。
dsh plugin --profile web add dsh-context-dashboard
上述命令适用于 web profile,也可替换为其他 profile 名称。
核心功能¶
插件主要提供两类统计视图:
-
单会话统计
针对每一个会话,提供以下数据:消息数、用户与助手消息数、工具调用次数、轮次、字符数以及预估 token。支持按 token 数、消息数或时间进行排序。 -
全局报告
提供全量数据汇总:总消息数、总预估 token、消耗最高的会话列表,以及按项目(工作目录)分组的汇总信息。
使用示例¶
在 DSH 交互环境中,可以直接调用以下命令获取信息:
- 查看单会话详情:输入
session_stats。默认按预估 token 降序排列,用于快速定位消耗大户。 - 获取全局报告:输入
context_report。
技术细节¶
- Token 估算:插件使用经验公式
预估 token = 字符数 ÷ 1.5进行估算,该公式适用于中文为主的场景,仅供参考。 - 日志格式:支持解析 DSH 默认的 zstd 压缩格式(
.l.zstd)与明文格式(.l)的会话日志。 - 运行环境:纯 Node 实现,无第三方运行时依赖。
注意事项¶
- 插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证(MIT)。
- 生态背景:DSH 理念是「一切皆插件」,社区目录与 DeepSeek / 幻方无官方从属关系。