前言¶

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 或幻方官方無直接從屬關係。安裝前請確保檢查源碼與許可證。