前言¶
在 DeepSeek Harness(DSH)裏跑智能體任務時,一次對話往往對應一長串工具調用:嵌套關係、失敗條目、長參數和原生摺疊塊混在同一條時間線裏。默認界面能展開結果,但要在幾十次調用裏定位「哪一步失敗、父子關係如何」仍然費眼。若再疊加其他改縮進或連線的界面插件,同一區域可能被重複繪製。
下面介紹社區維護的客戶端插件 DSH Process Tree(npm 包名 dsh-process-tree),它不改模型、不註冊工具,只基於當前會話已加載的聊天結構,把已記錄的工具調用渲染成可配置的過程樹或「任務函數」式代碼視圖,並保留文件按鈕、web_fetch 鏈接等宿主交互。
這是什麼¶
DSH Process Tree 由 Bosaiting 維護,在 SkillHub 目錄中歸類爲客戶端插件;GitHub 倉庫爲 Bosaiting/dsh-process-tree,許可證爲 MIT。簡介爲:面向 DeepSeek Harness 的可定製過程樹可視化插件(Configurable process trees with classic curves, botanical artwork, quiet lines and IDE task functions)。
它是社區界面插件:適用於 DSH Web 與使用同一界面的桌面版;TUI 不顯示該插件界面。插件讀取已顯示的聊天結構、元素尺寸和當前會話已加載的 Chat 投影,不額外拉取歷史;不執行命令、不發送網絡請求。設置保存在當前界面的 localStorage(鍵名 dsh.process-tree.v1)。
核心功能¶
展示形態¶
默認 代碼塊 風格以任務函數形態呈現已記錄的調用:工具名、真實參數、註釋與嵌套作用域;也可切換爲 經典曲線、安靜線條 或 植物手稿 三種樹形風格。獨立箭頭可摺疊子調用,不改變原生工具結果的摺疊狀態。
代碼配色與語言¶
淺色、深色可分別選擇配色方案(如 VS Code Light+/Dark+、JetBrains、Catppuccin、Dracula 等),背景可跟隨界面或使用方案背景;語法角色(函數與工具、關鍵字、參數、字符串、註釋等)可在設置中逐項調整。展示語言支持 Python、JavaScript、C、C++、Java、Go,也可選「行尾大括號」形態。這些視圖是只讀的執行記錄示意,不是可執行源碼;子調用順序不表示串行執行證明。
狀態與導航¶
區分失敗、已中斷、結果未知和未結束;失敗列表與右側迷你地圖用於在當前已加載、可見的調用中定位。耗時僅在起止時間均有記錄時顯示。長會話會優先處理視口附近的調用,其餘分批轉換;滾出視口的歷史會釋放繪製資源,滾回時恢復。
與宿主的銜接¶
在能安全匹配時,文件按鈕和 web_fetch 網頁鏈接沿用宿主原有操作;原生結果仍可展開,長參數可查看完整記錄。無法安全匹配或缺少結構化記錄時保留原生摘要,不猜測參數。
安裝與啓用¶
最快方式是指定 Web profile 從 npm 安裝最新版,安裝後重啓對應 DSH 實例:
dsh plugin --profile web add dsh-process-tree@latest
需要固定版本時(資料中示例爲 0.11.1):
dsh plugin --profile web add dsh-process-tree@0.11.1
也可通過插件市場:在 插件 → 實驗性插件 中啓用自定義插件市場,在 發現 裏添加索引源 https://raw.githubusercontent.com/Bosaiting/dsh-process-tree/main/market/index.json,搜索 dsh-process-tree 並確認來源爲 https://registry.npmjs.org 後安裝。桌面版可使用插件管理界面;已驗證的 macOS 桌面版亦可用 CLI 管理 desktop profile,不要直接改桌面應用安裝目錄。
離線安裝可先 npm pack,再:
npm pack dsh-process-tree@0.11.1
dsh plugin --profile web add ./dsh-process-tree-0.11.1.tgz
卸載:
dsh plugin --profile web remove dsh-process-tree
重啓實例即可,無需刪除整個 DSH profile。
典型用法與設置¶
安裝並重啓後,打開 設置 → 插件 → 過程樹 調整展示。首次安裝與「恢復默認」時,資料記載的默認組合爲:
| 項目 | 默認值 |
|---|---|
| 風格 | 代碼塊 |
| 代碼形態 | 任務函數 |
| 展示語言 | Python |
| 淺色配色 | VS Code Light+ |
| 深色配色 | JetBrains Darcula |
| 代碼背景 | 使用配色方案背景 |
代碼模式下會隱藏樹形風格用的強度、狀態顏色和部分高級項;切回樹形風格後可繼續調整線條、圓點、縮進等。在代碼視圖中點擊「已記錄失敗」可打開失敗列表,選中條目會跳轉到對應調用並在需要時展開插件摺疊的父作用域。
適用場景與注意¶
適合:長期在 DSH Web 或同界面桌面版調試智能體、需要一眼看清調用嵌套與失敗點、又希望保留原生文件/鏈接交互的開發者。
注意:
- 插件隨當前 DSH 界面進程運行,安裝前建議閱讀 倉庫源碼 與 MIT 許可證;社區目錄 SkillHub 插件頁 與 DeepSeek / 幻方無官方從屬關係。
- 資料記載 0.11.1 不按 DSH 版本號阻止安裝,不等於所有未來組合均已測試;Windows、Linux 桌面等仍有未驗證範圍,詳見倉庫 兼容性記錄。
- 建議停用重複添加縮進或過程連接線的插件,避免同一區域被重複修改。Claude Style 不是運行依賴。
結尾¶
DSH Process Tree 把「工具調用時間線」整理成任務函數或多種 SVG 過程樹,並用失敗列表與迷你地圖輔助定位,同時儘量不破壞宿主原生交互。若你在 Web 或桌面 UI 裏排查 agent 工具鏈,可按上文命令安裝並在設置裏切換風格與配色。