dsh-workspace-tree：DeepSeek Harness 虛擬會話文件夾管理插件

前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許用戶通過擴展來增強功能。在長期使用過程中，管理大量會話和物理目錄容易導致系統雜亂。dsh-workspace-tree 插件通過引入虛擬會話文件夾機制，在不觸碰物理文件系統的情況下實現會話的分組與管理，旨在提供更穩定的跨工作區體驗。

插件簡介¶

這是一個由 pipipigu 維護的客戶端插件，屬於 DeepSeek Harness (DSH) 生態。

核心價值：提供虛擬會話文件夾分組、拖放（或點擊移動）以及子項目管理功能。

基礎信息：
* 名稱：dsh-workspace-tree
* 類別：客戶端
* 許可證：MIT
* 倉庫：github:pipipigu/dsh-workspace-tree

核心功能¶

該插件通過零文件系統污染的機制，實現了對會話的精細化管理：

虛擬會話文件夾
- 零文件系統污染：不會移動或修改底層的對話日誌或物理目錄。元數據以原子方式持久化在 .dsh/workspace-tree..。
- 多工作區穩定性：每個工作區擁有獨立的分類和置頂隊列。切換工作區時，文件夾狀態保持持久和穩定。
- 完整生命週期：支持創建、內聯重命名（雙擊）、自定義顏色標籤以及刪除（未分類會話安全回退）。
文件夾範圍會話創建
- 懸停在任意文件夾上並點擊 [+]，可直接在該目標文件夾內開始新對話。通過原子 SessionId 綁定，避免了競態條件。
活躍任務橫幅與“讀取即移除”
- 頂部膠囊（28px）固定顯示正在運行的任務和未讀的已完成會話。
- 生成時顯示脈衝藍點；後臺完成時顯示持久綠 [Unread] 標記；閱讀後自動移除。
- 支持一鍵深跳並自動展開父級工作區和文件夾。
精確移動到文件夾下拉菜單
- 取代了側邊欄拖拽的交互痛點，提供精準的點擊移動功能。
- 支持快速文件夾選擇、內聯創建新文件夾，以及文件夾內的“彈出”按鈕將會話返回未分類區域。
應用內可視化目錄瀏覽器與工作區創建器
- 點擊側邊欄頭部的 [+]，可打開原生風格的“選擇工作區目錄”模態框。
- 支持完整層級導航（麪包屑、單擊選擇、雙擊/箭頭下鑽、返回上一級）。
- 支持在對話框內直接創建子目錄、切換顯示隱藏文件（如 .config）以及直接編輯路徑。
會話置頂、內聯重命名與分頁
- 支持將重要會話置頂。
- 雙擊會話標題可激活內聯重命名。
- 默認顯示前 10 個會話，並提供展開器查看剩餘項目。
原生單槽陰影
- 完全自包含的主機 RPC 和 UI，繞過 DSH 內部插槽衝突。
- 以優先級 -10 陰影原生 sidebar.workspaces 插槽，與 DSH 的深色/淺色配色方案無縫融合。
0ms 響應式引擎
- 基於 useSyncExternalStore 和不可變版本快照，確保任何操作下的 UI 渲染均爲 0ms 延遲。

安裝與啓用¶

在終端中執行以下命令安裝插件：

dsh plugin --profile web add github:pipipigu/dsh-workspace-tree

安裝完成後，請重啓 DSH Web 實例（或刷新瀏覽器）以啓用插件。

典型用法¶

在特定文件夾中創建會話：將鼠標懸停在側邊欄的某個文件夾上，點擊其左側的 [+] 按鈕，即可直接在該文件夾內新建對話。
選擇或創建工作區目錄：點擊側邊欄頂部的 [+]，會彈出原生模態框，支持瀏覽目錄、創建子目錄或直接粘貼路徑。
重命名會話：雙擊任意會話標題，即可直接在列表中進行內聯重命名。

適用場景與注意¶

適用場景：需要管理大量會話、希望保持物理目錄整潔、或者需要在多個工作區間頻繁切換並保持會話分類穩定性的 DSH 用戶。
注意：
- 插件以當前 dsh 進程的權限運行，請確保安裝的來源可信。
- 該插件通過自包含的 RPC 和 UI 實現了跨 Web 和 Desktop 平臺的 100% 穩定性。
- 它會覆蓋 DSH 原生的 sidebar.workspaces 插槽，優先級爲 -10。

總結¶

dsh-workspace-tree 爲 DSH 提供了一個輕量級、高性能的會話管理方案。通過虛擬化文件夾和精確的交互控制，它解決了傳統物理目錄管理的痛點，適合追求高效工作流的技術用戶。