前言¶
DeepSeek Harness (DSH) 採用插件化架構，支持通過 Web GUI 進行配置。在使用過程中，針對特定會話調整子代理模型、MCP 工具或技能的行爲，往往需要修改配置文件或重啓服務。dsh-session-settings 插件提供了在 Web 界面直接管理這些會話級配置的能力，實現了無需重啓的實時生效。
插件定位¶
這是一個爲 DeepSeek Harness (DSH) Web GUI 設計的插件，由 u9521 維護，基於 MIT License。它通過 Web 界面提供會話設置、MCP 服務器和技能的集中管理功能，允許用戶在全局默認、父會話繼承和會話自定義之間靈活切換。
核心功能¶
該插件主要包含以下能力：
- 側邊欄導航入口：在設置導航側邊欄中增加頂層入口，用於集中管理 MCP 服務器和技能。
- 會話專用標籤頁：在對話視圖中新增專用標籤頁，用於配置當前會話的子代理模型、MCP 工具和技能。
- 靈活的模式切換：支持三種模式。
- 使用全局默認：自動繼承全局默認規則。
- 跟隨父會話：繼承父會話的模型和推理努力程度。
- 會話自定義：爲當前會話指定自定義模型、可用 MCP 服務器以及具體的工具/技能禁用規則。
- 即時生效：通過運行時請求攔截和按需 MCP 客戶端生命週期管理，修改配置後無需重啓 DSH 即可生效。
- 集中式 MCP 服務器管理：提供側邊欄導航，支持 MCP 服務器的兩階段兼容性探測、自動協議降級和工具模式檢查。
- 會話級 MCP 工具控制：可以獨立控制每個會話的 MCP 服務器啓用狀態及具體工具的啓用/禁用。
- 會話級技能管理：可以獨立啓用或禁用每個會話的內置、用戶和項目技能，並支持動態提示目錄過濾。
安裝與啓用¶
通過 DSH CLI 安裝插件。
dsh plugin --profile web add github:u9521/dsh-session-settings#dist
安裝完成後，啓動或重啓 Web 服務以加載插件。
dsh web
常用操作¶
更新插件
如果已通過上述命令安裝，可以使用 update 命令更新到最新版本。
dsh plugin --profile web update github:u9521/dsh-session-settings#dist
卸載插件
移除插件以恢復到默認配置。
dsh plugin --profile web remove github:u9521/dsh-session-settings#dist
環境要求¶
該插件對 DSH 主線版本和運行環境有特定要求。
- DSH 版本：目標版本爲
>= 0.1.5-rc.1，原生支持 Session Format V3 和 Cordis 4.0.2。不支持 DSH<= 0.1.2。 - Node.js 版本：要求
^22.19 || >=24。
開發與維護¶
若需從源碼構建或維護插件，可參考以下命令。
pnpm install
pnpm run build
注意事項¶
- 插件以當前 DSH 進程的權限運行，修改配置涉及系統級操作，請在安裝前檢查源碼與許可證。
- 更新會話設置或禁用工具/技能後無需重啓服務，修改將在下一條請求中立即生效。
結尾¶
dsh-session-settings 爲 DSH 用戶提供了細粒度的會話控制能力，通過 Web 界面簡化了模型路由、MCP 協議和技能調度的配置流程。更多細節可查閱其 GitHub 倉庫。
