前言¶
DeepSeek Harness (DSH) 的會話管理通常涉及 fork 會話以並行處理任務。隨着會話數量增加，僅憑列表視圖很難把握上下文和任務分支。分支圖譜插件通過樹形結構提供了一種解決方案，將 fork 會話組織成可視化的圖譜，並允許爲每個分支添加文檔和持久化佈局。
插件定位¶
這是一個用於樹形管理 fork 會話、每分支註解文檔以及佈局持久化的插件。由 useful-money 維護。它提供零第三方依賴、零 CDN 和零構建步驟的靜態雙端包形態。
安裝與啓用¶
插件通過一條命令完成安裝與激活，無需手工改 patch 文件或 mklink junction。
dsh plugin --profile web add github:<你的用戶名>/branch-map-plugin
核心功能¶
- 樹形管理 fork 會話：將 fork 會話呈現爲樹形結構。
- 每分支註解文檔：爲每個分支添加描述。
- 佈局持久化：保存拖拽後的卡片位置。
- 零依賴：純自研渲染，無外部依賴。
典型用法¶
- 打開任意會話，頂部會出現“分支圖譜”標籤。
- 卡片代表一個工作區會話，連線上的圓點代表分叉點（
#fork序號）。 - 拖拽卡片調整佈局（自動保存）；在空白處拖拽可平移視圖。
- 使用工具欄進行“重置佈局 / 適應窗口 / 刷新”。
- 點擊“編輯”打開對話框，可修改分支名稱、說明、狀態和標籤。
- 使用狀態下拉列表過濾卡片。
- 點擊“跳轉”在新會話中打開該分支。
數據與文件¶
樹結構不落盤，按會話 cwd 實時聚合。數據存儲在工作區根目錄下的 .branchmap 文件夾中：
* annotations.yaml：存儲分支註解信息，包含樂觀鎖 revision。
* layout.yaml：存儲節點位置信息，拖拽後自動保存。
* diag.log：診斷日誌文件。
卸載¶
若需移除插件：
dsh plugin --profile web remove @local/branch-map
參考資料¶
- GitHub 倉庫：https://github.com/useful-money/Deepseek-Harness-branch-map-plugin
- 插件目錄：https://www.skillhub.cn/plugins/useful-money/Deepseek-Harness-branch-map-plugin
