DeepSeek Harness 的核心设计理念是「一切皆插件」。在 Web 客户端中,默认视图通常只有「对话」和「轨迹」。开发者或用户在调试或分析会话时,往往需要更细粒度的数据透视。下面介绍一个能够新增第三个视图标签的插件,用于展示会话统计。
它是什么¶
这个插件名为 dsh-stats-board,由 PastSheep 维护,属于客户端插件。它的核心作用是在对话/轨迹视图之外,增加一个名为「统计」的第三个标签页,并提供可视化的图表和表格来呈现会话数据。
核心功能¶
-
视图注册与压制
插件将组件注册进conversation.viewslot,排序为 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