dsh-settings-nav-organizer
English | 中文
Declutter the DeepSeek Harness settings panel: with more plugins installed, the settings sidebar grows one entry per plugin. This plugin folds every plugin/extension entry into a single collapsible Plugin entries group row, lets you organize entries into bookmark-style named groups, and adds a fold toggle in General settings.
Features
-
One group row, right under the system settings — 通用设置 / Models / Plugins / Agent presets stay flat at the top; everything else (plugins, extensions, extra pages) folds under Plugin entries (N) ▾.
-
Instant search — a search box pinned at the top of the settings nav filters every entry by name (and plugin id) as you type; matches are highlighted and their groups are auto-expanded, and clearing the search restores the previous fold/group layout.
-
Scrollable nav — when there are many entries, the settings sidebar scrolls instead of clipping entries with no scrollbar.
-
Fold toggle — a switch at the top of the Groups page (折叠第三方插件入口) turns the whole folding behavior on/off: off restores the plain native nav with every entry flat.
-
Bookmark-style custom groups — create named groups (like bookmark folders), move any settings entry into a group, and expand/collapse each group in the nav independently. A Groups page in the Settings panel manages everything: create, rename, delete groups, and move entries in/out.
-
One-click expand/collapse — click a group row to unfold its entries below it; click again to fold them back. Ungrouped entries stay under the Plugin entries (N) ▾ row.
-
Persistent — group configuration and the fold toggle are stored in localStorage (dsh.settingsNavFold.v1), survives restarts.
-
Auto-updating — counts and fold positions are recomputed from the live settings.section ledger, so entries appear/disappear as plugins register or unregister their settings pages. No configuration.
-
Current section never disappears — the active plugin page stays visible even while folded.
-
Auto classification — a mode switch (AI auto / manual): with AI mode on, newly installed plugins are grouped automatically through three fallback layers — third-party market categories → local name-based heuristic rules → your AI model — so plugins are grouped even when the market misses them and no AI is configured.
-
AI model config made easy — model dropdown with presets (DeepSeek / OpenAI / Qwen / GLM / Kimi / Doubao): picking a preset model auto-fills its provider API URL, the URL+key auto-fetch the models available on your account, a Test config button verifies the whole setup with one request, and everything is saved automatically on input (no save button required).
-
Idle plugin auto-pruner — a new switch on the Groups page scans each plugin's tool-call history, flags plugins unused beyond an idle threshold (default 30 days), and lets you preview and one-click clean them (with a confirmation step). Core DSH, this plugin and the core UI bundle are auto-protected and never listed; plugins without detectable tools can still be checked manually.
-
Localized — follows the UI locale (中文 / English).
Install
# 方式一：npm 包（推荐，国内网络更稳定）
dsh plugin --profile web add dsh-settings-nav-organizer
# 方式二：GitHub 仓库
dsh plugin --profile web add github:zhengjy01/dsh-settings-nav-organizer
Restart dsh (the host half must load), then refresh the browser page. Open the Settings panel (gear icon at the sidebar foot).
Usage
Everything lives in the Settings panel (设置):
-
Fold toggle — open Groups (分组管理), the switch at the top is 折叠第三方插件入口 / Fold third-party plugin entries. On (default): plugin entries fold under the group rows; off: the nav goes back to plain native with every entry flat. The switch state is remembered across restarts.
-
Group rows in the nav — with the toggle on, the nav keeps the official entries (通用设置 / Models / Plugins / Agent presets, plus the Plugin manager page) flat at the top, followed by the Groups page, then a Plugin entries (N) ▾ row (and any custom group rows). Click a row to expand/collapse its entries below it.
-
Auto classification — in the Groups page, turn on the Auto classify switch (AI auto / manual), then configure your AI model:
- pick a preset model from the dropdown (the provider API URL is filled in automatically), enter your API key, confirm the URL, and hit Test config to verify;
- click Classify ungrouped plugins now — market tags are used first, then name-based rules, then your AI model;
- everything is saved automatically as you type.
-
Bookmark-style groups — in the Groups page:
- type a name and hit New group to create a group;
- in the Ungrouped section, pick a group from each entry's dropdown to move it in;
- inside a group card, use Rename / Delete / Remove to manage it (deleting a group moves its entries back to Ungrouped).
How it works
The settings nav list is rendered by the shipped panel and is not a slot, so the plugin:
- reads the
settings.section slot ledger (ctx.slots.entries) and sorts it exactly like the panel does;
- injects the group rows into the nav list DOM right after the last core entry (idempotent — no DOM change when already placed);
- marks plugin buttons with
data-snav-plugin / data-snav-group and drives visibility via a small stylesheet (the active aria-current row stays visible);
- follows the ledger and panel re-renders with a scoped
MutationObserver (with a storm watchdog), so the group stays correct as plugins come and go;
Everything is owned by the plugin fiber: styles, subscriptions, the observer, and the injected rows are removed when the plugin is stopped or uninstalled.
Uninstall
dsh plugin --profile web remove dsh-settings-nav-organizer
This stops the plugin, removes its row from cordis.patch.yml and its dependency from the profile package.json.
License
MIT
