DeepSeek Harness (DSH) 採用插件架構，默認的側邊欄工作區視圖功能相對基礎。對於需要管理多目錄工作區或頻繁在文件樹與對話之間切換的開發者來說，這種視圖限制了操作效率。dsh-multi-root-explorer 插件旨在替換 DSH 原生側邊欄的工作區區域，將其改造爲一個雙標籤的多根瀏覽器：左側爲按真實工作目錄分組的對話樹，右側爲可預覽文件的只讀資源樹。
插件簡介¶
dsh-multi-root-explorer 是由開發者 Nethur-auro 維護的 DSH 客戶端插件。它不依賴額外的運行時庫，僅使用 DSH 客戶端模塊加載器自帶的 React。
核心價值在於：
1. 固定多根工作區：導入的目錄保持固定，不會因爲會話的增減而重新計算。
2. 對話即目錄樹：將每個會話的真實工作目錄 (cwd) 作爲文件夾結構進行展示。
3. 資源樹同步：只讀的資源樹按需加載，並實時檢測磁盤變更，僅刷新實際發生變化的層級。
核心功能¶
固定多根工作區
導入的目錄是固定的，不會像原生視圖那樣隨會話上下文自動重算。
對話作爲目錄樹
每個會話根據其真實的 cwd 被歸入對應的文件夾。位於工作區根目錄之外的會話可以作爲錨點保留；沒有 cwd 的會話會被單獨分組。
資源樹（只讀）
資源樹採用按需加載和分頁策略，打開大容量驅動器不會導致磁盤全量掃描。點擊文件會通過 DSH 原生右側側邊欄打開文件，而不影響主對話的位置。
磁盤變更感知
資源樹會定期探測已加載目錄層級在磁盤上的變更，僅重新獲取真正發生變化的層級，已手動展開的層級不會因此被摺疊。
統一選擇機制
插件引入了“選擇模式”（通過眼睛按鈕開啓）。在此模式下，選擇一個文件夾會選中其整個子樹；選擇一個子節點會排除該節點（相當於選中父節點的兄弟節點）；雙擊已選中的文件夾會提交一個空文件夾。所有操作均通過 Host 讀取，未展開的文件夾也能被正確選中。
文件夾操作
在任意文件夾上點擊右鍵或尾部的 ··· 按鈕，可以：
* 在該目錄啓動新會話（標題留空，由 DSH 標題器根據首條消息命名）。
* 在系統文件管理器中打開該目錄。
* 對於資源樹，可複製其絕對路徑。
拖放引用
將資源樹中的行拖入對話編輯器，會生成一個原生的“原子引用”（文件圖標、文件名、業務色），效果與從 @ 菜單中選中的候選文件一致。
@ 菜單覆蓋
DSH 原生的文件補全索引僅限於當前會話目錄。本插件註冊了自己的 @ 源，覆蓋所有已註冊的工作區根目錄，提供更全面的文件索引。
誠實的工作狀態
狀態卡片和行圖標不僅顯示主 Agent 的狀態，還會顯示子 Agent 是否仍在工作，以及目標是否仍在進行中。
原生歸檔支持
支持通過 DSH 自身的服務對會話進行歸檔和解檔，歸檔狀態與永久刪除區分清晰。
卸載後存活
在插件運行期間，承載普通會話的目錄會被註冊爲 DSH 的原生工作區。即使禁用或卸載插件，這些工作區及其關聯的對話也不會消失。
安裝與啓用¶
本插件要求 DeepSeek Harness 版本 >= 0.2.0-rc.1，且瀏覽器需支持 Popover API (element.showPopover)。安裝後必須重啓 DSH 應用和 Host 以加載路由。
請根據你的環境選擇以下任一命令（需替換 <your-profile>）：
dsh plugin --profile <your-profile> add dsh-multi-root-explorer
或從 GitHub 發佈頁獲取最新構建：
dsh plugin --profile <your-profile> add https://github.com/Nethur-auro/dsh-multi-root-explorer/releases/latest/download/dsh-multi-root-explorer.tgz
或直接從 Git 倉庫安裝源碼（始終指向 main 分支）：
dsh plugin --profile <your-profile> add git+https://github.com/Nethur-auro/dsh-multi-root-explorer.git
安裝完成後，側邊欄的工作區區域應顯示 對話 / Conversations 和 資源 / Resources 兩個標籤頁。如果區域未變化，請確認已重啓 DSH。
典型用法¶
- 新建會話：在對話樹中右鍵點擊任意文件夾，選擇“在此目錄啓動新會話”。
- 插入文件引用：在資源樹中找到目標文件，拖拽該行到對話輸入框中，鬆開鼠標即可生成引用。
- 提交空文件夾：在對話樹中選中一個文件夾，雙擊該文件夾，該文件夾會被選中並提交爲空內容（此時子節點保持選中狀態）。
適用場景與注意事項¶
- 狀態：插件目前處於預覽狀態。自動化測試套件已通過，但尚未對每次 DSH 構建進行實時的運行時驗收測試。
- 安全限制：插件通過 HTTP 路由提供服務，拒絕非 Loopback 端口、非 Loopback Host 頭以及跨站請求。
- 生態說明：本插件屬於 DSH 生態的一部分，與 DeepSeek 或幻方官方無官方從屬關係。
通過該插件，開發者可以更清晰地管理基於目錄的會話結構，並在文件操作與對話交互之間獲得更順滑的體驗。
