dsh-settings-nav-organizer：摺疊 DeepSeek Harness 設置面板中的插件條目

前言¶

在 DeepSeek Harness 中安裝插件後，設置側邊欄會隨着插件數量的增加而變長，每個插件都會增加一個獨立的導航條目。這導致面板顯得雜亂，難以快速定位核心設置。dsh-settings-nav-organizer 旨在解決這一問題。它將第三方插件和擴展條目摺疊到單個可摺疊的組中，並提供書籤式的自定義分組、快速搜索、可滾動導航以及 AI 自動分類功能，以保持設置面板的整潔。

核心功能¶

摺疊插件條目：將所有插件和擴展條目摺疊到一個名爲 Plugin entries (N) ▾ 的組行中，官方系統設置（通用設置、模型、插件、Agent 預設）保持頂部平鋪。
快速搜索：在導航欄頂部提供搜索框，輸入關鍵詞可實時過濾條目名稱和插件 ID，匹配項會高亮並自動展開對應組。
可滾動導航：當條目過多時，側邊欄支持滾動，避免條目被裁剪且無滾動條。
摺疊開關：在“分組管理”頁面提供開關，可一鍵開啓或關閉摺疊功能。
書籤式自定義組：支持創建命名組，像書籤文件夾一樣管理條目，並在導航中獨立展開或摺疊。
持久化配置：分組配置和摺疊開關狀態保存在 localStorage 中，重啓後保留。
自動更新：根據 settings.section ledger 實時重算條目數量和摺疊位置，插件註冊/註銷設置頁面時會自動反映在導航中。
當前部分保持可見：即使處於摺疊狀態，當前激活的頁面條目也會保持可見。
AI 自動分類：支持開啓 AI 自動分類模式，插件可根據市場分類、本地規則或 AI 模型自動歸類。
簡化的 AI 模型配置：提供預設模型下拉框（DeepSeek、OpenAI、Qwen 等），自動填充 API URL，支持測試配置並自動保存。
空閒插件自動修剪：掃描插件工具調用歷史，標記超過空閒閾值（默認 30 天）的插件，支持一鍵清理。
本地化支持：跟隨 UI 語言（中文/英文）顯示。

安裝與啓用¶

通過命令行安裝插件：

dsh plugin --profile web add dsh-settings-nav-organizer

安裝完成後，重啓 dsh 進程，並刷新瀏覽器頁面以加載插件。在設置面板中找到“分組管理”頁面，開啓“摺疊第三方插件入口”開關即可生效。

基礎用法¶

摺疊管理：打開設置面板，進入“分組管理”頁面。開啓頂部的“摺疊第三方插件入口”開關。此時，所有插件條目會摺疊到 Plugin entries (N) ▾ 行下，系統核心設置保持頂部平鋪。
手動展開/摺疊：點擊導航欄中的組行（如 Plugin entries 或自定義組），即可展開或摺疊其下的條目。
創建分組：在“分組管理”頁面，輸入組名稱並點擊“新建組”。
移動條目：在“未分組”區域，通過下拉菜單選擇目標分組，將條目移動進去。點擊組名右上角的“重命名”或“刪除”可管理分組（刪除分組會將條目移回未分組區）。

高級配置¶

AI 自動分類：
在“分組管理”頁面開啓“自動分類”開關。點擊配置區域，從預設模型下拉框選擇模型（如 DeepSeek），輸入 API Key 和 URL。點擊“測試配置”驗證連接，隨後點擊“分類未分組插件”。系統會依次使用市場分類標籤、本地啓發式規則和 AI 模型對插件進行歸類。
空閒插件修剪：
在“分組管理”頁面開啓“空閒插件自動修剪”開關。插件會掃描各插件的工具調用歷史。默認閾值爲 30 天，可在此處查看被標記爲空閒的插件列表。確認無誤後點擊清理按鈕即可移除。

注意事項¶

重啓與刷新：安裝或卸載插件後，必須重啓 dsh 並刷新瀏覽器頁面才能生效。
配置存儲：所有分組配置和摺疊狀態均存儲在 localStorage 的 dsh.settingsNavFold.v1 鍵下。
依賴關係：該插件依賴 settings.section ledger。
受保護組件：核心 DSH、本插件自身以及核心 UI 包受保護，不會被摺疊或列出。

該插件由 zhengjy01 維護，開源協議爲 MIT，源碼位於 GitHub。