前言¶
DSH 的理念是「一切皆插件」。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
當同一個工作區裏有多條會話、父會話和子代理時，普通文本視圖不容易快速看出分支關係。下面介紹 dsh-branch-visualizer：一個持久化 DeepSeek Harness 插件，用於查看原生會話分支，並進行跳轉、改名和歸檔。
這是什麼¶
dsh-branch-visualizer 由 111222cjyq 維護，採用 MIT 許可證。
它讀取同一工作區的會話、父會話和子代理關係，自動生成樹形佈局，並在同一界面提供會話跳轉、標題修改和歸檔操作。
當前狀態爲 Developer Preview。DeepSeek Harness 本身仍處於實驗階段。
核心功能¶
分支樹與畫布¶
- 讀取同一工作區的會話、父會話和子代理關係，自動生成樹形佈局。
- 支持拖動節點、框選、平移、縮放、自動佈局和視圖居中。
- 普通面板在有效縮放低於
0.6時切換圓形節點；緊湊面板閾值爲0.85。
會話跳轉¶
- 雙擊普通節點打開會話。
- 子代理節點使用 Harness 的跳轉地址：
openSubagent
狀態、改名與歸檔¶
- 區分
running、idle、cold，並監聽 Agent 生命週期事件。 - 活躍會話可直接改名。
- 冷會話通過持久化事件追加，並處理序列衝突。
- 歸檔前校驗工作區歸屬。
- 批量歸檔結果逐項返回。
- 父節點歸檔時收集其子代理後代。
歸檔視圖¶
- 默認不加載歸檔節點。
- 可切換完整視圖。
- 隱藏歸檔鏈時，用雙虛線連接最近可見祖先。
性能與診斷¶
- 使用快照 TTL/LRU、同鍵請求合併、全局重建併發上限、子代理 TTL/LRU 和輪詢退避。
- 提供去敏診斷接口：
/brvis/api/diagnostics
該接口返回適配器版本、能力狀態和缺失能力。
安裝與啓用¶
從 GitHub 安裝到指定 profile：
dsh plugin --profile <profile> add github:111222cjyq/dsh-branch-visualizer
安裝後重啓對應的 Harness 進程。
典型用法¶
1、打開任意會話。
2、點擊會話標題欄中的“◈ 分支圖”。
3、雙擊節點跳轉；拖動節點調整佈局；空格加左鍵平移畫布。
4、選擇一個或多個節點後執行改名或歸檔。
5、需要檢查完整歷史時開啓“顯示歸檔”。
適用場景與注意¶
這個插件適合需要查看同一工作區會話分支、子代理關係和歸檔歷史的 DSH 使用者。
由於它隨當前 dsh 進程運行，安裝前應檢查源碼和 MIT 許可證。
當前使用要注意：
- 當前只支持：
dsh.client.platform = web
未驗證 Electron/桌面專用 bridge。
- HTTP 邊界用於阻止普通跨站瀏覽器請求，不是本機惡意進程隔離或多用戶認證系統。
- 冷會話改名依賴 session event 結構，容易受 Harness schema 變化影響。
- 尚未提供“取消歸檔”。
- 鍵盤無障礙和觸屏手勢仍不完整。
- 不包含遙測、廣告、分析 SDK 或第三方網絡請求。
- 只通過 Harness 同源接口訪問本地宿主：
/brvis/api
鏈接¶
- 目錄頁：dsh-branch-visualizer
- GitHub：dsh-branch-visualizer
