前言¶
DeepSeek Harness (DSH) 通過插件機制擴展功能。dsh-workspace-presets 是一個插件，旨在解決在不同工作區手動配置 Agent 預設的繁瑣過程。它允許開發者將一個 Agent 預設與特定工作區綁定，該工作區下的新會話將自動應用該預設。
插件簡介¶
- 名稱: dsh-workspace-presets
- 核心功能: 每個工作區的 Agent 預設綁定
- 維護者: GBDJXB
- 許可證: MIT
- 兼容版本: DSH 0.1.5, 0.1.7, 0.2.0
核心功能¶
- 原生設置頁面: 在 DSH 的設置面板中添加一個原生的“Workspace presets”頁面，以表格形式展示工作區與預設的綁定關係。
- 自動應用: 當工作區存在綁定關係時，該工作區下的空白會話會自動應用綁定的預設。這包括側邊欄中爲每個工作區維護的隱藏空白會話。
- 回退機制: 如果工作區沒有綁定預設，或綁定不存在，系統會回退到 DSH 的默認行爲（全局默認或啓動頁的選擇器）。
- 會話隔離: 插件不會對已啓動的會話、子代理會話或已歸檔的會話產生任何影響。
- 手動優先: 在空白會話上，手動選擇芯片（Chip）的選擇始終優先於自動綁定的預設。
安裝與啓用¶
在安裝前，請確保 DSH 部署已包含 Agent 預設配置，且系統環境變量中包含 pnpm。
方式一：從 npm 安裝¶
dsh plugin --profile web add dsh-workspace-presets
方式二：從 GitHub 安裝¶
dsh plugin --profile web add github:GBDJXB/dsh-workspace-presets
方式三：從本地文件夾安裝¶
- 克隆倉庫：
git clone https://github.com/GBDJXB/dsh-workspace-presets.git
cd dsh-workspace-presets
- 安裝依賴（本地安裝必須執行此步）：
npm install
- 添加插件：
dsh plugin --profile web add .
安裝完成後，重啓 DSH 進程並刷新瀏覽器（Ctrl+Shift+R），在側邊欄底部的“設置”中即可找到“Workspace presets”頁面。
兼容性與注意事項¶
- 版本要求: 插件支持 DSH 的 0.1.5、0.1.7 和 0.2.0 版本。0.1.7 版本需要將預設聲明在 Composition 中，如遇預設缺失，需運行對應的鏡像腳本。
- 本地安裝依賴: 使用本地文件夾安裝時，必須在倉庫目錄內先執行
npm install，否則啓動時可能會報ERR_MODULE_NOT_FOUND錯誤。 - 生效範圍: 綁定僅在空白會話上生效。已啓動的會話、子代理會話和歸檔會話不受影響。在空白會話上手動選擇 Agent 芯片會覆蓋自動綁定的行爲。
- DSH Desktop: Desktop 2.x 使用獨立的 profile 安裝插件，命令需指定
--profile desktop。
結語¶
dsh-workspace-presets 通過在設置層面提供可視化的預設綁定功能，降低了 DSH 在多工作區場景下的配置成本。安裝並配置後，新會話的啓動將變得確定且零延遲，無需額外模型調用成本。
詳細信息請參考項目主頁：
https://github.com/GBDJXB/dsh-workspace-presets
