dsh-stats-board:DeepSeek Harness Web 的会话统计看板

DeepSeek Harness 的核心设计理念是「一切皆插件」。在 Web 客户端中,默认视图通常只有「对话」和「轨迹」。开发者或用户在调试或分析会话时,往往需要更细粒度的数据透视。下面介绍一个能够新增第三个视图标签的插件,用于展示会话统计。

它是什么

这个插件名为 dsh-stats-board,由 PastSheep 维护,属于客户端插件。它的核心作用是在对话/轨迹视图之外,增加一个名为「统计」的第三个标签页,并提供可视化的图表和表格来呈现会话数据。

核心功能

  • 视图注册与压制
    插件将组件注册进 conversation.view slot,排序为 order 20,标签名为「统计」。同时,它在 conversation.composer.dock 注册空组件,以压制 Web 客户端自带的那一行统计行。

  • 会话总览 KPI
    页面顶部展示一系列关键指标,包括总轮次、总步数、LLM 耗时、工具耗时、平均首字生成时间(TTFT)、输出速度、输入输出 tokens 数量、缓存命中率以及上下文占用情况。

  • Token 构成环形图
    提供两种模式展示 Token 构成。一种是投影模式,显示系统、工具和消息的构成;另一种是计费桶模式,显示未缓存输入、缓存读写和输出。

  • 轮次趋势图表
    展示最近 16 轮的输入(蓝色)和输出(紫色)柱状图,以及输出 tokens 的累计折线图。

  • 数据明细
    提供每轮的明细表,列出轮次、步数、LLM 耗时、TTFT、速度、输出量和工具数。此外还有按调用次数与总耗时排序的工具调用表。

安装与启用

先执行安装命令。

dsh plugin --profile web add @deepseek-ai/dsh-stats-board

安装后,重启 DeepSeek Harness。在对话视图右上会出现「统计」标签,点击即可查看当前会话的统计看板。

数据来源与依赖

插件的数据来源主要依赖会话节点 useSession((s) => s.chat.legacy.nodes) 来推导步数、耗时和 tokens,以及投影 useProjection('sessionStats') 等来获取上下文压力和构成。安装前需确认已安装 peerDependencies,包括 @deepseek-ai/dsh-tools、@deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-client-ui-slots 和 react。

未发布时,可使用本地目录进行安装:

dsh plugin --profile web add file:C:/path/to/dsh-stats-board

注意事项

由于插件以当前 DSH 进程权限运行,安装前建议检查源码与许可证(MIT)。该插件采用免构建方式,通过手写 JS(React.createElement + 内联 SVG)实现,直接使用 file: 或 npm 安装均可。

总结

经过上面的步骤,你已为 DeepSeek Harness Web 添加了一个可视化的会话分析工具。它通过免构建的方式,利用 React.createElement 和内联 SVG 直接渲染图表,为智能体开发提供了便利的数据查看途径。

生态目录:https://www.skillhub.cn/plugins/PastSheep/dsh-stats-board
源码地址:https://github.com/PastSheep/dsh-stats-board

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜