前言¶
DeepSeek Harness 的「預設」本質上是一份插件清單，決定了 Agent 有哪些工具、技能和子 Agent。通常這份清單隻能通過查看 YAML 文件來了解，執行流程和組件構成較爲抽象。agent-preset-graph-xww 插件將這份清單畫成一張 ComfyUI 風格的節點圖，展示 Agent 的組成與實時執行狀態。
該插件由 laojingwei 維護，開源協議爲 MIT。它運行在 Web 客戶端，不修改 Host 狀態，僅通過讀取現有服務數據來呈現可視化視圖。
核心功能¶
- 節點圖展示：將 Agent 預設畫成 ComfyUI 風格的節點圖，左側爲任務入口，中間爲各類能力塊，右側爲執行循環。
- 實時高亮：實時高亮當前正在執行的節點，並顯示工具名稱、運行時長、輪次以及當前會話使用的預設。
- 能力塊與部署級插件：展示預設聲明的各類能力塊（按包名歸類），以及部署級插件（不屬於預設但可用的插件）。
- 節點詳情：點擊節點可查看詳情（ID、模塊、狀態、啓用條件、統計信息）。
- 交互與導出：支持節點搜索、摺疊/展開、自動跟隨執行節點，以及導出節點圖爲 PNG 圖片。
安裝與啓用¶
使用 DeepSeek Harness 的插件管理命令安裝。安裝後重啓 DSH 服務生效。
dsh plugin --profile web add agent-preset-graph-xww
如果目標插件尚未發佈到 npm，也可以通過 GitHub 倉庫或本地路徑安裝：
# 從 GitHub 倉庫安裝
dsh plugin --profile web add github:laojingwei/agent-preset-graph-xww
# 本地工作副本安裝
dsh plugin --profile web add link:D:/path/to/agent-preset-graph-xww
使用方法¶
安裝完成後，在任意會話的對話頁標籤欄會出現第三個標籤：對話 | 軌跡 | 節點圖。
- 查看預設組成：在“節點圖”標籤頁中查看 Agent 預設的完整結構。
- 查看詳情：點擊任意節點，下方會展開顯示該節點的詳細信息和本輪統計。
- 搜索與過濾：使用工具欄的搜索功能，按名稱、模塊或條目 ID 過濾節點，命中的節點會高亮顯示。
- 定位與跟隨：使用“定位”功能手動跳轉到特定節點；默認開啓的“自動”功能會跟隨當前執行的節點移動畫布。
- 導出圖片：點擊“導出”按鈕，將當前節點圖保存爲 2 倍分辨率的 PNG 圖片。
依賴與兼容性¶
- 平臺：Web（DSH Web GUI）。
- DeepSeek Harness 版本：≥ 0.1.7-rc.2。
- 依賴服務：插件依賴
slots、locale、sessions、remote.pluginInventory四項服務，缺少任一服務時插件不會激活。 - 配置要求：無需額外配置。
注意事項¶
- 工具映射限制：工具到節點的映射僅覆蓋 DSH 內置工具，第三方工具依賴模糊匹配，名稱與包名無關時可能無法精確高亮。
- 預設組成來源：預設組成來自 Plugin Inventory 的扁平化結果，Loader 的 group 層級不會體現在圖上。
- 高亮統計範圍：高亮統計僅基於當前輪次，超出事件窗口的老調用不會計入。
- 權限範圍：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
結尾¶
預設節點圖通過可視化的方式，將 DeepSeek Harness 中抽象的預設配置轉化爲直觀的節點結構，輔助開發者理解 Agent 的組成與執行流。對於需要監控 Agent 實時行爲或梳理預設結構的開發者，該插件提供了實用的調試視圖。
