前言¶
DSH 的 Web GUI 以工作區和會話爲基本操作對象。當開發者需要在多個分支上並行工作，或者希望把“主工作樹、分支 worktree、會話”放在同一個側邊欄中查看時，普通工作區列表不夠直接。
下面介紹 dsh-worktree-panel。它是用於 DeepSeek Harness Web GUI 的 Git worktree 與分支管理面板。
這是什麼¶
dsh-worktree-panel 是 HeathHe 維護的 DSH 插件，MIT 許可。
它的作用是在 DeepSeek Harness Web GUI 中擴展工作區側邊欄，把項目、主工作樹或分支 worktree、會話組織成更清晰的管理層級，同時保留原有工作區交互方式。
核心功能¶
- 在項目組內顯示主工作樹、當前分支、clean/modified 狀態，以及關聯的分支 worktree。
- 在 worktree 內啓動會話、刪除 worktree，並切換主工作樹分支。
- 爲已有分支創建 worktree，或創建新分支及對應 worktree。
- 對非 Git 文件夾，可以直接啓動會話；項目操作菜單中提供
Initialize Git and enable worktrees。 - 默認把 worktree 存儲在項目目錄下：
<project>/.dsh/workspaces/
也可以配置爲自定義全局目錄。
- 當 worktree 存儲位置變化時，檢測並遷移已有 worktree；遷移過程會跳過有未提交更改或活躍會話的 worktree。
- 對非 Git 工作區，保留默認會話流程，並可選加入 Git/worktree 初始化能力。
- 通過
settings.section提供獨立的 Worktree 設置頁。 - 支持當前 Host description store 和 home-directory path abbreviation。
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add dsh-worktree-panel
安裝後，重啓 dsh web。重啓後，worktree 層級會出現在工作區側邊欄中。
安裝指定版本¶
如果需要使用明確版本，例如 0.1.5：
dsh plugin --profile web add dsh-worktree-panel@0.1.5
升級插件¶
升級時使用對應版本號：
dsh plugin --profile web add dsh-worktree-panel@<version>
升級完成後，重啓 dsh web。
本地開發¶
如果你在本機有 dsh-worktree-panel 源碼目錄，可以使用 link: 方式加載：
dsh plugin --profile web add link:/absolute/path/to/dsh-worktree-panel
客戶端構建¶
lib/client.js 由 lib/build.mjs 基於 @deepseek-ai/dsh-client-ui-workspace 的瀏覽器 bundle 生成。構建過程會校驗上游包版本，並記錄到生成文件頭部。
如需指定一個明確的上游 bundle 文件，可以使用：
DSH_WORKSPACE_BUNDLE=/absolute/path/to/client.js npm run build
兼容性¶
已覈實資料中寫明，該插件在以下版本中測試過：
DSH Desktop 2.0.3 / DeepSeek Harness 0.1.1-rc.2
DSH peer dependency range 爲：
>=0.1.1-rc.2 <0.2.0
適用場景與注意¶
- 適合需要在 DeepSeek Harness Web GUI 中管理多個 Git worktree 的開發者。
- 適合希望把分支、worktree 與會話放在同一側邊欄中查看的場景。
- 適合非 Git 文件夾先啓動會話，之後可選擇初始化 Git 和 worktree 的工作方式。
- 插件以當前
dsh進程權限運行。安裝前應檢查源碼、LICENSE與NOTICE。 lib/client.js派生自@deepseek-ai/dsh-client-ui-workspace。相關聲明見倉庫中的NOTICE和LICENSE。- 本文材料未提供 Stars 數、分類和獨立目錄 URL，因此這裏不給出這些字段。
資源¶
GitHub：
https://github.com/HeathHe/dsh-worktree-panel
插件目錄頁：本文材料未提供獨立目錄 URL。你可以在自己使用的 DSH 插件目錄中搜索：
dsh-worktree-panel
