前言¶
DeepSeek Harness (DSH) 採用插件化架構，但在原生側邊欄管理中存在侷限：工作區查找不便、歸檔操作不可逆、缺乏視覺定製。dsh-workspace-kit 是一個 Cordis Bundle 插件，由 ice5kysl 維護，旨在解決工作區管理痛點。它提供 ⌘K 快捷搜索、軟歸檔機制、以及可拖拽排序和自定義樣式的增強側邊欄。
核心功能¶
Spotlight 搜索與導航¶
插件將 Spotlight 調色板註冊到 shell.overlay 插槽。按下 ⌘K 或 Ctrl+K 後，可以模糊搜索所有工作區和會話（包括未分組和已歸檔項）。
* 搜索歸檔項：輸入時會匹配歸檔項目，結果帶有 “Archived” 標識，支持恢復。
* 快捷操作：使用 ↑↓ 鍵導航，按 Enter 直接打開或跳轉。
軟歸檔機制¶
原生 DSH 的歸檔是系統級且不可逆的。該插件實現了「視圖層」的軟歸檔：
* 歸檔狀態：歸檔的工作區從主列表中移除，移動到可摺疊的 “Archived (N)” 區域。
* 恢復與刪除：歸檔狀態持久化存儲（localStorage）。用戶可以通過側邊欄行或 Spotlight 結果執行恢復或徹底刪除操作。
* 數據安全：歸檔僅改變視圖狀態，不刪除實際數據。
增強側邊欄¶
插件以低優先級（-1）註冊到 sidebar.workspaces 插槽，替換原生側邊欄瀏覽器。
* 拖拽排序：支持拖拽工作區行以重新排序，或拖拽會話調整順序。
* 側邊欄搜索：提供可展開的搜索框，支持按標題、路徑過濾，以及基於內容的全文搜索（需 ≥2 字符）。
* 視覺定製：每行懸停時顯示操作按鈕。點擊圖標或顏色按鈕，可在 32 個 SVG 圖標和 9 種顏色中選擇，用於區分工作區。
* 快速操作：懸停顯示「新建會話」（針對活躍行）和「恢復」（針對歸檔行）。
* 一鍵切換：側邊欄底部提供按鈕，可在「增強側邊欄」和「官方側邊欄」之間快速切換。
安裝與啓用¶
在已運行 DSH Web 的環境下，使用以下命令安裝：
dsh plugin --profile web add dsh-workspace-kit
安裝後，增強側邊欄和 Spotlight 搜索會自動生效。
典型用法¶
查找工作區¶
在會話中輸入以下命令，或在 Spotlight 中輸入：
* workspace_find pms
* /workspace-find pms
管理側邊欄¶
- 排序：拖拽工作區行，會話將切換到「手動」排序語義。
- 樣式：懸停工作區行，點擊圖標或調色板圖標進行自定義。
- 歸檔：點擊行上的「···」菜單，選擇歸檔或恢復。
技術細節與限制¶
架構設計¶
插件採用 Bundle 形式，包含兩個「面」：
* Host (Node)：位於 lib/index.js。提供 workspace_find / workspace_list 模型工具，以及 /workspace-find / /workspace-list 斜槓命令（僅查詢，寫入操作在 GUI）。
* Browser (Client)：位於 lib/client.js。實現 Spotlight 調色板、軟歸檔狀態存儲（localStorage）以及增強側邊欄。
本地化¶
- 瀏覽器端：優先讀取
localStorage中的dsh.workspace-kit.locale，否則根據navigator.language推斷（zh*爲中文，否則爲英文）。 - 主機端：優先讀取環境變量
WSKIT_LOCALE，否則讀取LC_ALL/LANG。
版本與限制¶
- 目標版本：
@deepseek-ai/dsh≥ 0.1.1-rc.2。 - 能力邊界：v1 版本替換瀏覽器的能力邊界在
known-limitations.md中有詳細文檔。
生態背景¶
DSH 強調「一切皆插件」。dsh-workspace-kit 發佈在 npm，遵循 MIT 許可證。安裝前請檢查源碼與許可證，確保符合項目規範。
