DSH Session Map：拓撲展示的智能體會話執行圖

前言¶

在使用 DeepSeek Harness (DSH) 進行多智能體開發時，原始的會話日誌通常以平鋪的 JSON 或列表形式呈現。當涉及子 Agent 調用、工具鏈路和長時間輪次時，開發者難以直觀地把握執行流的時間順序與層級關係。dsh-seelog 插件將當前的 Session Log 轉換爲可瀏覽的拓撲圖，以可視化的方式還原智能體的執行過程。

這是什麼¶

dsh-seelog 是一個面向 DeepSeek Harness 的外部 Web 插件，由開發者 lhwu1 維護。它不修改 DSH 的源碼或會話格式，而是通過“bundle”方式加載，按需讀取當前會話的日誌，並將其轉化爲具有時間維度的拓撲結構。插件旨在解決多智能體場景下邏輯流不清晰、難以快速定位特定事件的問題。

核心功能¶

插件提供了一套完整的可視化與交互機制：

中文語義節點映射
將輸入、模型回覆、工具調用、輪次、失敗事件及子 Agent 映射爲中文語義節點，而非原始 JSON 字段。未知工具會顯示爲“工具調用”或“MCP 工具調用”，便於快速識別。
統一時間座標
將子 Agent 與主 Agent 放在同一時間座標軸上。子 Agent 從主線中實際啓動的位置分叉，執行完畢後匯回主線。這種設計避免了平鋪列表造成的父子關係混淆。
導航與交互
- 固定時間概覽尺：位於主圖頂部，映射整個已捕獲會話。青色窗口指示當前主圖可見範圍，點擊刻度或軌道位置可平滑跳轉。
- 節點檢查器：點擊節點或中文標籤後，右側檢查器顯示語義名稱、類別、狀態、時間及日誌序號。展開後可查看完整 JSON 及相鄰事件。
- 主執行線與繩結：紫色粗線表示根會話主線，節點以菱形繩結連接標籤卡片，拖動視圖時標籤隨之移動。
性能與限制
爲防止大日誌導致瀏覽器卡頓，插件設定了繪製限制：每條軌道最多繪製 400 個交互節點。

安裝與啓用¶

安裝過程依賴 Node.js 環境。以 Windows 路徑爲例，步驟如下：

    cd D:\harness-lh-int8\dsh-seelog
    npm install
    npm run validate

將外部插件鏈接到運行 Web UI 的 DSH profile：

    dsh plugin --profile web add D:\harness-lh-int8\dsh-seelog
    dsh --profile web --dump-config

重啓該 profile，標籤欄中會出現 會話圖。

典型用法¶

安裝並重啓後，在任意會話頁面進行以下操作：

打開視圖
切換到 會話圖 標籤，插件自動讀取當前日誌並生成拓撲圖。
瀏覽執行過程
- 概覽尺導航：點擊頂部時間刻度，主圖會跳轉到對應時間段。
- 主圖操作：鼠標滾輪水平滾動，按住左鍵拖動平移。鬆開拖動後，插件會後臺請求一次當前日誌，將新增事件納入圖中，頁面不會刷新擠佔畫布。
- 查看詳情：點擊主線、子 Agent 軌道或中文標籤，右側檢查器會加載該節點的語義信息和原始日誌。

適用場景與注意¶

適用場景：適合需要分析多智能體協作流程、調試工具調用失敗原因、或梳理複雜會話邏輯的開發者。
隱私與數據：插件僅讀取當前會話的輕量語義字段（不包含模型正文、提示詞或工具參數）。只有點擊節點後，瀏覽器纔會請求該事件及相鄰兩條原始日誌。
數據持久化：不保存瀏覽器本地快照歷史。離開或刷新頁面後，需重新進入視圖或拖動視圖以按需讀取日誌。
配置限制：默認配置下（cordis.patch.yml），插件最多讀取 128 個譜系會話，每個會話最多 20,000 條日誌事件。

結語¶

dsh-seelog 通過拓撲視圖將複雜的智能體執行過程具象化。對於習慣於圖形化調試的開發者，它能顯著提升排查問題的效率。更多細節可查閱其 GitHub 倉庫或社區目錄。