前言¶
DeepSeek Harness (DSH) 的生態定位是“一切皆插件”。在開發或調試工作流時，若需在同一會話中驗證不同 Agent Preset 的表現，通常需要重啓會話或重新初始化。dsh-preset-switch 插件通過提供會話內的預設切換能力，解決了這一流程中斷的問題，允許用戶在運行中的會話中動態調整智能體配置。
插件簡介¶
該插件由開發者 aorucshiea 維護，旨在爲 DSH 提供可選的會話內智能體預設切換功能。它不改變 DSH 的核心架構，而是通過擴展命令和 HTTP 接口，繞過官方對空白會話預設的鎖定限制，實現靈活的運行時配置變更。
核心功能¶
- Slash-menu 交互：在瀏覽器端輸入
/preset時，會彈出一個帶搜索功能的二級菜單，支持直接鼠標選擇預設，無需手動輸入 ID。 - 鍵盤快捷鍵：除了菜單選擇，支持通過
/preset <number>直接通過序號切換，作爲菜單模式的鍵盤備選方案。 - 開關控制：提供
/preset-toggle on|off命令，用於全局啓用或禁用預設切換功能。 - HTTP 端點：提供 HTTP 接口，便於開發者將其集成到自定義的 UI 界面中。
- 繞過鎖定：插件能夠繞過官方的 blank-session 鎖定機制，允許在非空白會話中執行切換，但系統會顯示警告以提示潛在的工具調用不兼容問題。
安裝與啓用¶
安裝該插件需要使用 --profile web 參數，確保環境匹配。執行以下命令即可完成安裝：
dsh plugin --profile web add github:aorucshiea/dsh-preset-switch
安裝完成後，插件會隨 DSH 進程啓動，默認處於啓用狀態。
典型用法¶
插件安裝並生效後，可通過以下命令進行操作：
/preset # 查看當前預設列表及編號菜單
/preset <id> # 在空白會話中切換到指定 ID 的預設
/preset <number> # 通過菜單序號切換預設（等同於 <id>）
/preset-toggle on|off # 啓用或禁用該命令功能
適用場景與注意¶
- 適用場景：適合需要在同一次會話中快速測試不同角色、不同工具鏈配置的開發者，或需要在運行中動態調整 Agent 行爲的場景。
- 權限與安全：插件以當前 DSH 進程的權限運行，請確保安裝的源碼來源可信。
- 兼容性提示：由於插件繞過了官方的 blank-session 鎖定，切換時系統會顯示警告，提示舊的工具調用可能與新預設不匹配。在切換前請確認當前上下文是否允許這種變更。
結語¶
dsh-preset-switch 提供了一種輕量級的方案，讓 DeepSeek Harness 的會話管理更加靈活。該插件不存儲任何 API 密鑰或憑證。更多細節請參考項目倉庫或 DSH 插件目錄。
