前言¶

DeepSeek Harness (DSH) 默認的側邊欄工作區列表是平鋪的。當工作區數量增多，或者需要按項目類型、技術棧進行區分時，這種結構顯得不夠直觀。dsh-better-workspace 插件爲這個列表增加了一套兩層文件夾系統，通過“磁盤層”和“名稱層”兩個維度進行嵌套，讓工作區的組織結構更加清晰。

插件介紹¶

名稱：dsh-better-workspace
維護者：KannaKuron
協議：MIT

該插件通過 DSH 的標準插槽機制，將側邊欄的瀏覽區替換爲層級樹視圖。樹的結構由兩部分正交組成：
1. 磁盤層：按目錄路徑自動嵌套。
2. 名稱層：喫工作區名字裏的 /，作爲虛擬分組。

核心功能¶

插件接管了側邊欄工作區列表，提供了以下能力：

1. 雙層文件夾系統

   • 磁盤層：按照目錄路徑自動嵌套（官方 workspace-tree 語義）。
   • 名稱層：利用工作區名稱中的 / 進行虛擬分組（默認關閉，可在設置開啓）。例如，工作區名稱爲 web/前端，會自動歸入 web 分組。

2. 即時分組與歸組

   • 重命名即歸組：新建工作區後，直接重命名名稱，加入 / 即可歸入對應分組；也可以直接拖拽工作區行進分組。
   • 右鍵菜單：右鍵任意一行（工作區、分組、會話、會話分組），可執行重命名、刪除、分叉、歸檔或“自定義外觀”操作。

3. 外觀自定義

   • 支持對任意層級自定義顏色、發光強度、字體粗細、陰影、字體描邊（默認開啓）以及圖標（工作區與工作區分組專屬）。

4. 會話層級的支持

   • 工作區內的會話名稱同樣支持使用 / 分層（如 測試1/兩個插件維護）。
   • 會話分組採用次級配色且無文件夾圖標，與工作區分組區分開。

5. 視圖交互

   • 摺疊/展開：點擊工作區行或會話分組行即可收起/展開其下的內容。
   • 拖拽還原：支持調整順序、移動進分組。拖拽期間會有高亮和提示線。
   • 狀態呼吸燈：當狀態燈被摺疊隱藏時，發光效果會向外冒泡，在層級行上顯示。

6. 原生能力兼容

   • 支持 DSH 官方快捷鍵：⌥⌘K（搜索）、⌥⌘O（添加工作區）、⌥⌘N（新會話）。
   • 新會話頁的工作區選擇器，與側邊欄使用同一棵樹，視圖選項即時同步。

7. 新增項自動配置（v0.25.0）

   • 在設置卡片開啓“自動配色 + 圖標”後，新創建的工作區和會話會自動分配內置色板和圖標，避免逐個設置。

安裝與啓用¶

這是一個純 JS 插件，不依賴構建工具。安裝後需要重啓 DSH 才能生效。

dsh plugin --profile web add dsh-better-workspace

典型用法¶

1. 歸組工作區：將工作區重命名爲 web/前端，該工作區會立即歸入 web 分組。
2. 批量改名：右鍵點擊分組行，選擇“重命名分組”，可以批量修改組內所有工作區名稱的前綴。
3. 自定義外觀：右鍵點擊任意一行，選擇“自定義外觀”，在彈出的卡片中調整顏色、發光強度等。
4. 跨端同步：在設置 → 插件 → 插件配置 → “更好的工作區”卡片中，可開啓“跨端同步”，手動在 Web 和桌面客戶端之間交換外觀與設置數據。

注意事項與限制¶

• 會話跨工作區拖拽：目前仍被拒絕，會話必須保留在所屬工作區內。
• 搜索過濾：搜索僅針對本地標題過濾（兩層扁平化後逐工作區匹配），尚未接管宿主內容搜索。
• Flat 視圖：平鋪視圖未被接管，層級樹即視圖。當側欄切到“單列表/按工作區”時，新會話頁選擇器會退化爲完整標題列表。
• URL 處理：URL 或斜槓標題不拆層的規則，僅對本次啓動後新建的會話生效。存量會話或手動命名的 / 分組標題不會被改動。
• 重啓生效：安裝或配置更改後必須重啓 DSH。

總結¶

dsh-better-workspace 通過引入兩層文件夾系統，解決了 DSH 工作區管理混亂的問題。它通過重命名和拖拽提供靈活的分組方式，同時保留了外觀自定義、原生快捷鍵等核心體驗。如果你需要更精細地管理多個項目或會話，這是一個可以直接安裝使用的工具。

• GitHub 倉庫
• 社區目錄