前言¶

DeepSeek Harness (DSH) 的理念是“一切皆插件”。在智能體開發與工程化過程中，會話的分支管理常與代碼倉庫的分支管理脫節。dsh-branchman 解決了這個問題，它將一個分支動作映射爲一個 git worktree、一個繼承對話歷史的子會話，以及一個可視化的樹狀結構邊。

核心功能¶

該插件提供樹狀分支工作區管理。一個動作包含 git worktree + 子會話 + 可視化樹邊。每個主樹擁有獨立分區，子樹佈局按真實父子關係排列。開發者可以在側欄的“走向總覽”中查看所有會話，包括尚未創建分支的節點。

會話繼承與創建
創建分支時，子會話可繼承最新已完成輪次，或從特定助手消息開始繼承。每個分支使用 UUID，生成獨立的 branchman/<UUID> 分支和 .branches/<UUID> 工作樹。交接說明保存在詳情中，不會自動發送給模型。
可視化與篩選
提供層級列表，支持展開、收起、按倉庫或主樹篩選。圖形視圖支持搜索、分頁（保留祖先）、刷新、相機控制（拖動、縮放、選中定位）及可縮放圖形。
文件攜帶與操作校驗
支持攜帶未提交文件（包括中文路徑和二進制），但不攜帶符號鏈接、子模塊及 .branches 內容。合併、同步、移除操作會檢查實際工作樹身份。未提交改動、未合入提交或衝突會阻止對應操作。
中斷恢復
操作中斷時會保留工作樹和日誌，使用“繼續恢復”進行對賬。

npm 發佈完成後，可直接使用 dsh-branchman@0.3.2。

宿主兼容性：已驗證宿主爲 @deepseek-ai/dsh-desktop@0.2.0-rc.2，運行時版本爲 Electron 44。運行依賴由宿主提供。
數據遷移：v1 數據遷移爲獨立 tree-v2.，原 tree. 保留。舊記錄若缺少可信基點會標記爲恢復；降級需考慮狀態版本。
CLI 限制：CLI scripts/branchman.ps1 需顯式提供 -BaseUrl，寫操作通過 -BodyFile 提交，不繞過操作日誌。
權限風險：插件以當前 DSH 進程權限運行。安裝前應檢查源碼與許可證。

dsh-branchman 通過將 Git worktree 與子會話結合，提供了一種可視化的工程方向管理方式。它適合需要清晰管理多分支會話與代碼狀態的 DeepSeek Harness 用戶。