前言¶
DeepSeek Harness（DSH）採用插件化架構擴展功能。在 Web 界面中管理多個工作區時，主側邊欄的會話列表容易變得雜亂。dsh-workspace-dock 插件在側邊欄左側渲染一個 Dock 欄，以可視化和過濾工作區。它由 qschen86 維護，掛載在官方 sidebar.rail 槽位，通過服務注入實現，不修改任何內置文件。
核心功能¶
- 會話過濾：點擊 Dock 欄中的圖標，主側邊欄會過濾顯示該工作區下的會話列表。
- 工作區菜單：再次點擊已選中的圖標（或右鍵點擊），會打開菜單。菜單包含文件夾路徑、複製路徑、重命名、修改圖標和歸檔選項。
- 狀態徽章：
- 窄欄模式：顯示數字徽章（運行中會話）或圓點徽章（待關注會話）。
- 展開模式：顯示狀態膠囊。
- 徽章統計基於會話歸屬（host canonical-cwd 索引），與側邊欄列表完全一致。
- 尺寸調整：可收起爲窄欄（52px）或展開爲寬欄（200px，顯示名稱）。雙擊 rail 空白處也可切換展開/收起狀態。
- 自定義配置：支持爲每個工作區自定義圖標顏色與字形。圖標設置持久化於瀏覽器本地。
- 首頁入口：頂部 logo 提供首頁入口與菜單。菜單包含 dsh 安裝目錄、複製路徑和打開文件夾功能。
安裝與啓用¶
使用官方 CLI 安裝插件：
dsh plugin --profile web add dsh-workspace-dock
安裝後，運行以下命令驗證配置：
dsh --profile web --dump-config
安裝完成後需重啓 dsh web（使主機配置生效）並刷新頁面（使客戶端配置生效）。
使用說明¶
- 切換狀態：雙擊 rail 空白處，可在窄欄和寬欄之間切換。
- 打開菜單：右鍵點擊圖標，或再次點擊已選中的圖標，打開工作區菜單。
- 修改設置：在菜單中選擇“修改圖標”或“重命名”，可自定義工作區的視覺呈現和名稱。修改會同步至主側邊欄等界面。
注意事項與兼容性¶
- 版本要求：已驗證兼容 dsh 0.1.0-rc.6。
- 實現機制：純槽位（slot）+ 服務注入實現，無任何內置文件改動。
- 數據存儲：圖標設置存儲在瀏覽器本地。
結語¶
該插件通過在側邊欄左側提供可視化的工作區 Dock 欄，增強了 DSH Web 界面管理會話的能力。它無需修改核心文件，且支持高度自定義。
