DeepSeek Harness (DSH) 的執行過程通常以日誌或軌跡流的形式呈現。面對複雜的任務鏈路,快速定位關鍵步驟、錯誤點或執行耗時主導鏈變得困難。dsh-task-graph 插件將 DSH 單任務執行流程圖譜化,讓 Agent 的內部運行狀態從“流水賬”變成一張可交互的拓撲圖。
插件簡介¶
該插件由 KevinZhangNothing 維護,屬於工作流類別。它以“Task”爲第一層概念,進入任務後首先展示執行圖譜,而非一長串日誌。
核心功能¶
- Task First 與 Graph First:圖譜由底層的 Trajectory 數據解析而來,聚焦於任務流轉。
- Detail on Demand:畫布只展示關鍵節點,具體執行細節(LLM 步驟、工具調用、輸入輸出)收進右側詳情面板。
- 關鍵節點視圖:默認畫布只顯示 Turn(輪次)、代碼改動、Plan/Skill/SubAgent/測試以及失敗或重試事件。普通步驟隱藏,保持畫面清爽。
- 多種佈局:支持蛇形(默認)、DAG、時間線、力導向四種佈局,適應不同的分析需求。
- 實時執行狀態:通過 SSE 增量刷新,節點帶有秒級計時和 LIVE 徽標,運行狀態一目瞭然。
- 圖譜 ↔ Trajectory 雙向聯動:點擊圖譜節點可跳轉至軌跡詳情,點擊軌跡事件可反選圖譜節點。
- 分析與定位:支持查看關鍵路徑、錯誤定位、重試聚合以及任務摘要(耗時、Token、高頻工具等)。
安裝與啓用¶
- 執行安裝命令:
dsh plugin --profile web add github:KevinZhangNothing/dsh-task-graph
- 安裝完成後重啓引擎(或重新加載 Web UI)。
- 在「對話 / 軌跡」標籤旁會出現第三個「圖譜」Tab,點擊進入。
典型用法¶
- 獨立 Demo 測試:
npm run demo
打開瀏覽器訪問 Demo 頁面,查看內置數據或加載本地 `$DSH_HOME` 會話。
技術細節與注意¶
- 服務端需要 Node >= 22.15。
- 使用內置
zlib.zstdDecompressSync解碼.zstd格式的會話文件。 - 插件零原生依賴。
該插件通過將抽象的執行過程具象化,幫助開發者更高效地進行調試與分析。更多詳情與源碼,可訪問插件目錄或 GitHub 倉庫。