Introduction

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 is primarily focused on conversational interaction, but often lacks intuitive visualization of the tool-call chain for debugging and optimizing agents. The dsh-ui-tool-graph plugin adds a “Tool Graph” tab to the circular navigation in the conversation view, folding session logs into a weighted relationship graph to help developers quickly locate issues.

Plugin Overview

  • Name: dsh-ui-tool-graph
  • Developer: rocklau
  • License: MIT
  • Description: A tool-call value graph tab for the DeepSeek Harness (dsh) Web UI.

Core Features

The plugin mainly provides the following visualization and analysis capabilities:

  • Weighted Radial Graph: Nodes represent tools, with sizes dynamically changing based on the currently selected metric (total duration, call count, error count); edge widths are proportional to transition counts.
  • Optimization Insights: Rule-based findings marked with dots to indicate severity, including bottleneck share, error-prone tools, repeated calls (cache/deduplication candidates), consecutive same-tool chains, model generation wait time, and token-heavy steps.
  • Tool Ranking Table: Shows total/average duration, call count, and error count for each tool. Click a table row or graph node to drill down into detailed data for all individual calls (including duration and parameter summaries).
  • Session Statistics Bar: Summarizes total calls, running, failed, tool wall-clock time, longest average interval, and output token count.
  • One-Click Next Round: Converts the above metrics into standalone analysis prompts. Click to copy to the clipboard, or click again to send it as the next message in the queue.

Installation and Enablement

Install the plugin via the command line. After restarting the Web UI, the new “Tool Graph” tab will appear in the session title bar.

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

After installation, please restart the dsh web service.

Usage

  • Switch Weights: In the graph view, switch between total duration, call count, and error count at any time to observe changes in node sizes.
  • Drill Down into Details: Click a node in the graph or a row in the ranking table below to view the tool’s specific call history, duration distribution, and parameter snippets.
  • Generate Next-Round Instructions: Use the plugin-generated analysis prompt to directly guide the next conversation round, or copy it, adjust it manually, and send it.

How It Works and Limitations

  • Data Source: The graph data is entirely generated by the client by folding persisted session logs. This means it is deterministic, replayable, requires no additional model calls, and does not incur extra token consumption.
  • Subcall Folding: Nested subcalls (delegations) only fold to show the results of their parent call.
  • Time Breakdown: The wall-clock time split between LLM and tools is estimated based on call intervals, and precise per-request time attribution is not yet available.
  • Single-Tool Sessions: If a session uses only a single tool, the graph renders only one node and no edges.

Conclusion

dsh-ui-tool-graph is a lightweight Web UI helper plugin that turns cumbersome logs into an intuitive topology, helping developers quickly identify bottlenecks and anomalies in tool calls. All calculations are performed locally and do not increase runtime costs. You can obtain the source code from the community directory or GitHub.

Ecosystem Context

The DeepSeek Harness philosophy is “everything is a plugin.” This plugin is maintained by community developers and has no direct affiliation with DeepSeek or the official Huanfang team. Before installing, be sure to verify the source code and license.