前言¶
DeepSeek Harness（DSH）裏插件通常在整次會話或進程層面啓用。不同工作區如果承擔不同任務——例如一個專做前端、一個掛 MCP 工具鏈——往往要在設置裏反覆開關同一批插件，或靠記憶維持「當前工區該用誰」。社區插件 dsh-workspace-plugin-manager（維護者 Oreo2408，分類爲客戶端）給每個工作區維護一張自己的插件表：切換工作區時按表掛載或卸載，界面類似常見 mod 管理器的浮窗表格。下面按定位、功能、安裝與用法說明，事實以 GitHub README 爲準。
這是什麼¶
一句話：爲 DSH 的每個工作區單獨配置一套插件集合；切換工作區時應用對應表，而不是全局一套配置打到底。
狀態保存在本機 profile 目錄下的 workspace-plugin-manager.json，刷新、重啓或換窗口後不丟。插件在 SkillHub 等社區目錄中歸類爲客戶端，與 DeepSeek / 幻方無官方從屬關係，安裝前宜自行查看源碼與 MIT 許可證。
核心功能¶
入口在左側工作區標題：右擊或點「⋯」→「插件管理」，菜單裏會顯示當前工區的 開/總數。
浮窗與表格
- 窗口可拖動、可縮放，位置和大小會記住。
- 主表列出本工作區要用的插件；左下角「未啓用插件」池中的項雙擊即可加入表。
- 支持文件夾：新建、重命名、刪除、整組開關；工具欄支持剪切、複製、粘貼、刪除，剪切/複製可跨工作區使用。
提示與同步
- 新裝插件後首次進入某工作區，頂部黃條可詢問：加入本工作區、加入所有工作區、或加入指定文件夾；可摺疊或忽略。
- 表與當前實際插件狀態不一致時，切換工作區會彈窗詢問「應用」或「這次不換」；若其他工區任務在跑，則改爲頂部黃條（按鈕約 2 秒冷卻，可在設置裏關閉）。
- 某插件返回
restart-required時彈窗說明；設置頁可預覽該類提示。
模板、備份與依賴
- 可將某工區的表設爲模板；支持導出 / 導入 JSON。
- 可標記插件 A 依賴 B：刪除 B 時提醒；應用時缺依賴會有黃色提示。
- 描述優先用插件市場裏寫過的備註，否則用插件自帶說明。
存儲與宿主
- Host 側提供
GET/PUT /dsh-workspace-plugin-manager/state，僅接受本機迴環請求，原子寫入狀態文件；客戶端邏輯在client.js，通過window.__ModuleLoader__.load加載。
安裝與啓用¶
需要 DSH 0.2.2-rc.1 或更新（package.json 中 dsh.engines.dsh 爲 >=0.2.2-rc.1）。README 給出的安裝方式爲本地路徑鏈接，而非從名稱拼接 github:owner/repo。
- 將插件目錄放到本機任意路徑（示例：
F:\plugins\dsh-workspace-plugin-manager）。 - 用 CLI 或 Web GUI 以
link:形式安裝。
CLI：
dsh plugin --profile <你的 profile> add link:<上面那個路徑>
Web GUI：側邊欄「插件」→「添加插件」，填入 link:<路徑> 後啓用。
Host 半邊首次安裝後需重啓一次插件行或重啓 DSH，纔會註冊狀態文件路由；之後若只改 client.js，刷新頁面即可。插件以當前 DSH 進程權限運行，安裝前應檢查倉庫源碼與許可證。
典型用法¶
- 右擊左側任務欄裏的工作區標題（或點 ⋯）。
- 選擇「插件管理」。
- 首次打開時三選一：從空表開始、放進當前已啓用的插件、或套用模板。
- 在左下角「未啓用插件」中雙擊加入；在表裏用工具欄管理文件夾與剪貼板。
- 點「保存並應用」，將表同步到實際插件狀態。
數據文件路徑示例：
<DSH profile 目錄>/workspace-plugin-manager.json
Windows 下類似：%USERPROFILE%\.dsh\profiles\<profile>\workspace-plugin-manager.json。
適用場景與注意¶
適合誰
- 同一 DSH 實例裏開多個工作區，且各工區希望固定不同的插件組合（UI 增強、MCP、locale 等）。
- 需要跨工區複製插件佈局，或用 JSON 備份 / 模板複用工區配置。
已知限制（README 原文）
- 插件樹在整個 Host 進程一份，同一時刻只有一套插件實際生效；同時打開兩個不同工作區的會話時，它們共用當前這套。
- 切換工作區會實時卸載/掛載插件，MCP 會重連，通常耗時數秒。
- 多數開關依賴 HMR 即時生效；僅當插件管理器返回
restart-required時才需要重啓。 - 目前在 Windows + DSH Desktop 上驗證；其他環境行爲以自行測試爲準。
結尾¶
dsh-workspace-plugin-manager 把「工區 ↔ 插件集合」落到一張可編輯、可備份的表上，並用切換提示、新插件黃條和重啓說明減少誤操作。更多介紹見社區目錄頁與倉庫：
