DeepSeek Harness (DSH) 的側邊欄默認以工作區爲單位展示。面對多個項目和大量會話時，這種視圖容易顯得雜亂。Metafolder 插件提供了一種元文件夾機制，在不修改底層文件路徑的前提下，在側邊欄層面對工作區和會話進行可視化的歸類與整理。
插件簡介¶
- 插件名稱：
manoloremiddi/dsh-metafolder-plugin - 維護者：ManoloRemiddi
- 許可協議：MIT
- 核心定位：爲 DeepSeek Harness 側邊欄提供彩色的工作區和會話分組視圖。
核心功能¶
該插件在現有的工作區行之上疊加了一層元文件夾，提供以下能力：
- 元文件夾與計數：以命名、可摺疊的組來嵌套真實的工作區文件夾和會話，並在文件夾旁顯示包含的會話數量。
- 拖拽操作：將工作區或會話行拖拽到元文件夾中即可歸檔；拖拽到列表背景可取消歸檔。
- 本地持久化：分組和歸屬關係保存在瀏覽器的
localStorage中，頁面刷新後依然存在（僅限當前瀏覽器）。 - 行菜單：提供豐富的上下文操作，包括
→ <meta folder>歸檔、Remove from meta folder取消歸檔，以及重命名、上移/下移、刪除工作區。 - 自定義顏色：創建文件夾時可從八色色板、主題色或自定義顏色中選擇，該顏色會應用到文件夾圖標、標籤和拖拽目標邊框。
- 視圖選項：支持按“工作區”分組或“平鋪”視圖，支持按“手動”或“更新時間”排序。
- 工作區與會話管理：在寬側邊欄或摺疊側邊欄中均可添加工作區；支持按會話或工作區進行搜索、重命名、派生和歸檔。
安裝與啓用¶
在終端中執行以下命令，通過 web 配置文件安裝指定版本：
dsh plugin --profile web add https://github.com/ManoloRemiddi/DSH-Metafolder-Plugin/releases/download/v1.2.1/dsh-metafolder-plugin-1.2.1.tgz
安裝完成後，重啓 DSH 進程並刷新 Web 頁面即可生效。
典型用法¶
- 項目歸類：將所有“Resonant OS”相關的項目和工作區會話拖拽到一個名爲“Resonant OS”的元文件夾中。
- 顏色標記：爲不同類型的文件夾（如開發、測試、文檔）分配不同的顏色，以在視覺上快速區分。
- 快速歸檔：使用行菜單中的
→ <meta folder>快速將不再活躍的會話移動到對應的分組中。
適用場景與注意¶
該插件適合需要管理大量工作區和會話、希望對側邊欄視圖進行自定義整理的用戶。
重要限制：
* 無跨設備同步：目前的實現依賴瀏覽器本地存儲，不支持跨設備同步或持久化的 Host 服務存儲。
* 物理移動受限：工作區的物理路徑移動受到保護，插件不直接修改文件系統或路徑註冊表，直到 DSH 提供支持路徑遷移的 API。
* 權限綁定：AI 的權限始終綁定到真實的文件夾，因爲插件只是渲染層，並未改變底層數據結構。
前置要求：
* DeepSeek Harness 版本 >= 0.1.5-rc.1。
* 需要在 web 配置文件下安裝。
總結¶
Metafolder 插件爲 DSH 側邊欄增加了一層邏輯上的組織結構。它通過元文件夾和拖拽功能，在不觸碰文件系統底層的前提下，極大地改善了多項目管理的視覺體驗。
