前言¶
DeepSeek Harness (DSH) 原生側邊欄僅支持單層工作區列表。當工作區數量增多或需要按項目結構(如 web/前端、backend/api)歸類時,原生視圖容易顯得雜亂。dsh-workspace-plus 是一個 DSH Web 插件,它在側邊欄引入了層級樹視圖、時間桶排序以及會話全局置頂功能。它作爲 dsh-better-workspace 的分支,主要解決工作區多層級管理與會話跨項目聚合查看的需求。
核心功能¶
層級樹與虛擬分組¶
插件通過解析工作區名稱中的 / 字符構建虛擬分組樹。例如,工作區名稱 github/dsh-plan-plus 會自動歸入 github 虛擬分組。這種分組是純邏輯投影,不依賴文件系統目錄結構。層級支持多級,單層工作區(如根目錄下的普通工作區)照常顯示。
添加工作區與分區交互¶
在添加工作區時,插件提供交互式對話框,允許直接點選分區與分組,而非僅輸入文本。對話框支持即時預覽最終標題,並在空間不足時自動調整下拉框方向。新增時支持直接創建空分區或空分組。
分組管理¶
所有分組操作均通過右鍵菜單完成。在分組行右鍵可執行:新增子分組(自動帶上父級前綴)、新增子工作區(自動預填分組路徑)、重命名分組、刪除空分組。分組狀態與工作區數據分離,由名稱自然派生。
獨立分區¶
除了層級分組,插件支持獨立分區。右鍵工作區或會話可選擇“分區”,將其移動到獨立分區或“未分區(項目)”。會話可選擇“跟隨所屬工作區”來撤銷獨立分區。分區爲單層結構,支持拖拽放置與摺疊。
視圖切換與時間桶¶
側邊欄提供多種視圖模式:
* 層級樹:默認視圖,顯示虛擬分組。
* 工作區:平鋪獨立分組與項目區域。
* 單列表:跨工作區平鋪會話。
* 時間桶:聚合所有會話,按“今天/昨天/近7天/近30天/更早”分桶顯示。
視圖切換支持排序(手動/最近更新)與篩選(歸檔/全部)。
會話置頂與拖拽¶
任意會話可右鍵置頂,置頂內容固定在列表頂部,顯示所屬工作區角標。置頂會話在原工作區隱藏,取消置頂後迴歸。支持拖拽調整順序,工作區可拖入分組,會話可在工作區內重排。
外觀自定義¶
右鍵任意層級(工作區、分組、會話)可自定義外觀,包括顏色(預設色板+取色器)、發光強度、字體粗細、陰影與圖標。設置實時生效並持久化在瀏覽器本地。
安裝與啓用¶
安裝前請確保已安裝 DSH。插件支持桌面端與 Web 端。安裝命令如下:
# DSH 桌面端
dsh plugin --profile desktop add https://github.com/lsdt45/dsh-workspace-plus.git
# DSH Web
dsh plugin --profile web add https://github.com/lsdt45/dsh-workspace-plus.git
安裝完成後需重啓 DSH 使插件生效。
典型用法¶
- 整理工作區:創建工作區時,在“所屬分組”中輸入
web或backend,即可自動歸入虛擬分組。 - 管理分區:右鍵工作區選擇“分區”,將其移入獨立的“開發”分區,以便與“學習”分區區分。
- 時間視圖:點擊側邊欄視圖按鈕切換至“按時間”,查看所有項目在過去 7 天的會話活動。
- 外觀定製:右鍵“前端”分組,選擇“自定義外觀”,設置品牌色以便快速識別。
注意事項¶
- 數據存儲:插件偏好設置與數據存儲在瀏覽器本地,切換瀏覽器會丟失配置。
- 刪除機制:DSH 宿主僅提供歸檔接口,本插件通過
POST /dsh-workspace-plus/delete-session實現永久刪除,宿主需支持該接口。 - 標題解析:插件遵循“URL/斜槓標題不拆層”原則,除非是新會話且命名穩定,否則不會因標題中的
/強行拆分層級。引號內的斜槓視爲普通字符。 - 許可證:資料未明確說明具體協議,使用前請查閱源碼。
生態背景¶
DSH 插件生態通過 Git 倉庫分發。本插件可在 SkillHub 插件目錄 查看詳情,源碼託管在 GitHub。