前言¶
DeepSeek Harness（DSH）支持插件化擴展。在調試智能體或複雜工作流時，僅依賴內置的文本或表格視圖查看軌跡往往不夠直觀，難以快速定位工具調用邏輯或模型決策路徑。TangRj-Git/trajectory-graph 插件在 DSH 默認的 Chat 和 Trajectory 視圖旁增加了一個 Graph 標籤頁，將結構化的軌跡快照投影爲可交互的從左至右執行圖。
該插件完全在本地運行，不上傳軌跡數據，不修改會話歷史，旨在幫助開發者以圖形化方式梳理執行流。
插件簡介¶
- 插件名稱: dsh-plugin-trajectory-graph
- 倉庫地址: https://github.com/TangRj-Git/trajectory-graph
- 維護者: TangRj-Git
- 許可證: MIT
- 核心價值: 將 DSH 的結構化軌跡快照轉換爲可視化的執行拓撲圖，支持節點級詳情查看與交互。
核心功能¶
該插件提供以下功能來輔助軌跡分析：
- Turn 導航與選擇: 支持獨立選擇每個回合的圖表，默認選中最新回合。通過 Turn 導航器可隔離單個用戶請求，避免歷史記錄干擾。
- 語義化節點展示: 展示語義化的節點類型，包括用戶、上下文、模型、工具、工具組、子工具、Agent、Final、Retry 和 Error 節點。
- 工具調用可視化: 工具調用以垂直分支形式呈現，並在後續的模型或 Final 節點處收斂。
- 交互操作: 支持搜索、類型過濾、摺疊/展開、縮放以及適應視圖。
- 節點詳情: 點擊任意節點可查看結構化詳情。工具節點特別展示 Payload、Result、Schema、Timing 等數據。
- 實時更新: 運行會話時圖表實時更新，流式文本變化時保持佈局穩定。
- 隱私安全: 純本地可視化，不上傳軌跡數據，不調用外部分析服務。
安裝與啓用¶
安裝前請確保環境滿足以下要求：
- Node.js 20 或更新版本
- pnpm 10 或更新版本
- DeepSeek Harness 0.1.0-rc.6 或 0.1.0-rc.7
- 從 GitHub Releases 下載
dsh-plugin-trajectory-graph-0.3.0.tgz文件，並保持在本地目錄中。 - 執行以下命令將插件安裝到默認的 Web 預設中（請替換爲實際文件路徑）：
npx --yes @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile web add "C:\path\to\dsh-plugin-trajectory-graph-0.3.0.tgz"
安裝成功後，會話重啓即可生效。
典型用法¶
- 啓動默認 Web 預設：
npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web --port 3080
- 在瀏覽器中打開
http://127.0.0.1:3080，選擇一個包含軌跡數據的會話。 - 在頂部標籤頁切換到
Chat / 對話 | Trajectory / 軌跡 | Graph / 圖譜。 - 使用左側的 Turn 導航器選擇特定回合，或點擊空白畫布拖動以平移，滾動滾輪以縮放。
- 點擊任意節點，在詳情面板中查看 Payload、Result 或 Timing 等信息。
注意事項與侷限¶
- 查看器定位: 這是一個執行查看器，而非可編輯的工作流設計器。它不會修改提示詞或會話歷史。
- Agent 推斷限制: 當前版本不推斷 Agent 分支。由於 Harness 不提供持久化身份，插件無法根據工具名或模型文本推斷 Agent 路徑。
- 性能考慮: 歷史記錄過大時圖表可能過寬，建議使用回合導航、搜索或摺疊功能進行查看。
- 數據依賴: 沒有結構化軌跡快照的會話無法生成圖節點。
- 隱私: 插件完全在本地運行，不會上傳軌跡數據。
結語¶
TangRj-Git/trajectory-graph 插件通過提供可視化的執行拓撲圖，解決了 DSH 用戶在分析複雜工具調用和模型決策路徑時的痛點。結合 Turn 導航器和節點詳情查看，它能夠顯著提升調試效率。更多細節與源碼請參考 GitHub 倉庫。
