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