前言¶
DeepSeek Harness(DSH)採用插件化架構,擴展功能通常需要修改代碼或自行構建。在調試智能體時,追蹤會話中發生的每一次工具調用(包括工具名、參數、結果及狀態)是一項常見需求。dsh-ui-tools 是一個瀏覽器端插件,它通過在會話頭部註冊一個獨立的視圖,將工具調用信息結構化地展示出來。
插件介紹¶
dsh-ui-tools 是由用戶 liukj98 維護的一個 DeepSeek Harness(DSH)Web 插件。它主要解決在 Web 界面下難以直觀查看和調試工具調用流程的問題,不涉及模型請求的攔截或 Chat 快照的修改,僅作爲信息的消費者存在。
核心功能¶
- 會話頭部視圖註冊:在會話頭部的標籤環裏註冊一個 tools 視圖。
- 調用列表展示:按派發順序列出本次會話的每一次工具調用。
- 詳細信息展示:顯示工具名、格式化後的參數、結果文本,以及 ok / error / running 狀態。
- 無侵入運行:作爲瀏覽器端插件運行,不參與模型請求,不改動 Chat 快照,只消費 ConversationSnapshot。
安裝與啓用¶
安裝前需確保環境滿足以下條件:
* 已安裝 DeepSeek Harness,且 dsh web 能正常啓動。
* pnpm 命令在系統 PATH 上。
使用以下命令安裝:
dsh plugin --profile web add dsh-ui-tools@latest
dsh web
安裝完成後,重啓 dsh web,會話頭部會出現 tools 標籤頁。
注意事項¶
- pnpm 版本限制:若使用
pnpm >= 10,該版本默認攔截未允許的構建腳本。若首次add失敗,請根據提示將打印出的 key 加進 profile 目錄的pnpm-workspace.yaml的allowBuilds後重試。 - 內置版本衝突:若同時安裝了 DSH 內置的
ui-tools插件,會看到兩個tools標籤頁。爲區分兩者,可修改src/client.tsx裏apply()中的id與label(例如id: 'tools-ext'、label: () => 'tools+'),然後重新執行pnpm build。
結語¶
對於需要在 DSH 環境下調試工具調用流程的開發者,dsh-ui-tools 提供了一個輕量級且不干擾核心邏輯的查看入口。更多細節可參考 GitHub 倉庫。