前言¶

Agent trajectories bury their own economics: which tool ate the wall time, where calls failed, how many tokens each round burned, which calls repeated themselves verbatim. DeepSeek Harness (DSH) 的 Web UI 本身侧重于对话交互，但对于调试和优化智能体，往往缺乏对工具调用链路的直观可视化。dsh-ui-tool-graph 插件在对话视图的环形导航中增加了一个「工具图谱」标签页，将会话日志折叠成一个加权关系图，帮助开发者快速定位问题。

插件定位¶

• 名称: dsh-ui-tool-graph
• 开发者: rocklau
• 开源协议: MIT
• 简介: DeepSeek Harness (dsh) Web UI 的工具调用价值图谱标签页。

核心功能¶

该插件主要提供以下可视化与分析能力：

• 加权径向图: 节点代表工具，大小根据当前选定的指标（总耗时、调用次数、错误数）动态变化；边的宽度与转换次数成正比。
• 优化洞察: 基于规则生成的发现，使用圆点标记严重程度，包括瓶颈占比、易错工具、重复调用（缓存/去重候选）、连续同工具链路、模型生成等待时间、以及耗 Token 较多的步骤。
• 工具排名表: 展示每个工具的总耗时/平均耗时、调用次数、错误数。点击表格行或图谱节点，可深入查看所有单次调用的详细数据（含耗时和参数摘要）。
• 会话统计条: 汇总调用总数、运行中、失败数、工具墙钟时间、最长平均间隔以及输出 Token 数。
• 一键下一轮: 将上述指标转化为独立的分析提示词，点击复制到剪贴板，或再次点击后将其作为下一条消息发送到队列中。

安装与启用¶

通过命令行安装插件，Web UI 重启后即可在会话标题栏看到新增的「工具图谱」标签。

dsh plugin --profile web add github:rocklau/dsh-ui-tool-graph

安装完成后，请重启 dsh web 服务。

使用方法¶

• 切换权重: 在图谱界面，随时在总耗时、调用次数和错误数之间切换，观察节点大小的变化。
• 钻取详情: 点击图谱中的节点或下方的排名表行，查看该工具的具体调用历史、耗时分布及参数片段。
• 生成下一轮指令: 利用插件生成的分析提示词直接指导下一轮对话，或者将其复制下来手动调整后发送。

工作原理与限制¶

• 数据来源: 图谱数据完全由客户端根据持久化的会话日志折叠生成。这意味着它是确定性的、可回放的，不需要额外的模型调用，也不会产生额外的 Token 消耗。
• 子调用折叠: 嵌套的子调用（委托）仅折叠显示其父调用的结果。
• 时间拆分: LLM 与工具的墙钟时间拆分基于调用间隔估算，尚未提供按请求的精确时间归属。
• 单工具会话: 如果一个会话只使用了单一工具，图谱中只会渲染一个节点，不显示边。

结语¶

dsh-ui-tool-graph 是一个轻量级的 Web UI 辅助插件，它将枯燥的日志转化为直观的拓扑结构，帮助开发者快速识别工具调用的瓶颈与异常。所有计算均在本地完成，不会增加运行成本。你可以通过社区目录或 GitHub 获取源码。

生态背景¶

DeepSeek Harness 理念是「一切皆插件」。本插件由社区开发者维护，与 DeepSeek 或幻方官方无直接从属关系。安装前请确保检查源码与许可证。