前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。隨着開發者安裝的插件增多，全局設置對話框中的分區會變得雜亂。dsh-settings-manager 旨在解決這一問題，提供一個無需修改上游代碼（deepseek-harness）就能管理其他插件在設置界面中放置的方案。
插件簡介¶
該插件由開發者 Yiklek 維護，屬於客戶端組件。它的核心價值在於統一管理設置導航欄的佈局，允許用戶對已註冊的設置分區進行顯示/隱藏、排序和重命名，並確保這些策略持久化保存。
核心功能¶
插件提供以下具體能力：
- 顯示/隱藏分區：在設置導航欄中直接控制分區的可見性，隱藏的分區將不再渲染。
- 排序與拖拽：支持上移、下移按鈕調整順序，也支持拖拽操作。鬆手後，分區會按插入位置重排，編號精確且無衝突。
- 行內改名：點擊鉛筆圖標進入編輯模式，修改設置導航的顯示名稱，內容頭仍由原插件控制。
- 導航滾動適配：修復了設置外殼導航欄無法滾動的問題，確保所有分區（包括排到末尾的）均可訪問。
- 窄屏適配：在 ≤520px 的視口下自動收窄導航欄並緊湊佈局，隱藏拖拽抓手。
- 多語言支持：內置簡體中文與英文，跟隨外殼語言切換。
- 信息展示：展示每個分區的 ID 與來源插件（registrant）。
- 策略持久化：所有更改通過 DSH 標準的 settings 命名空間（
settings-manager）持久化到服務端。
安裝與啓用¶
使用官方 CLI 進行安裝。
dsh plugin --profile web add dsh-settings-manager
安裝完成後，重啓 dsh web 進程即可生效。
典型用法¶
安裝後，進入全局設置界面，導航欄頂部會出現「設置編排」入口。在該面板中可以執行以下操作：
- 列出與查看：查看所有已註冊的設置分區（包含內置的 base 分區）。
- 隱藏/顯示：點擊開關切換分區可見性。
- 拖拽排序：按住行首抓手拖動分區，藍色指示線會顯示落點位置。
- 重命名：點擊鉛筆圖標修改導航名稱。
- 重置：清除單個分區或全部分區的自定義策略，恢復默認狀態。
適用場景與注意事項¶
該插件適合希望定製化 DeepSeek Harness 設置界面佈局的開發者或高級用戶。
- 本地保存：策略變更即時生效，並保存在瀏覽器本地。
- 自身保護：本插件自身的分區（
settings-manager）不可隱藏，確保管理入口始終可達。 - Base 分區優先：通用設置、模型、插件等 base 分區永遠先於第三方插件註冊，本插件通過讀路徑攔截覆蓋所有分區，不依賴加載順序。
- 圖標限制：導航圖標來自設置外殼的內置封閉列表，本插件僅顯示通用齒輪圖標。
- 空狀態處理：隱藏當前正在查看的分區時，內容區會顯示空佔位符，導航欄其餘項仍可點擊。
結語¶
dsh-settings-manager 讓用戶在不觸碰上游源碼的情況下，獲得了對 DSH 設置界面的完全控制權。這種輕量級的定製能力是 DSH 插件生態的重要補充。
