# dsh-toomuch-plugins **Makes room in the DSH Web sidebar.** · *Too many plugins, too little room.* [![license](https://img.shields.io/github/license/rivenshanghai/dsh-toomuch-plugins)](https://github.com/rivenshanghai/dsh-toomuch-plugins/blob/main/LICENSE) [![npm](https://img.shields.io/npm/v/dsh-toomuch-plugins)](https://www.npmjs.com/package/dsh-toomuch-plugins) [![node](https://img.shields.io/badge/node-%E2%89%A520-brightgreen)](https://nodejs.org) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-blue)](https://github.com/rivenshanghai/dsh-toomuch-plugins) [![topic](https://img.shields.io/badge/topic-dsh--plugin-8A2BE2)](https://github.com/topics/dsh-plugin) [English](README.md) | [简体中文](README.zh-CN.md)

--- A small plugin set that gives the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) Web sidebar some breathing room. It ships one plugin today: | Plugin | What it does | | --- | --- | | Sidebar panel collapse | Collapses the "global panels" column above the workspace into one toggle in the sidebar footer, plus a display settings page | ## Why The DSH Web sidebar stacks, from top to bottom: brand row → new session → **global panel entries** → workspace → settings. Every plugin that adds a sidebar entry adds a row to that column: plugins, plugin market, schedules, MCP studio, context, skill manager, system monitor… Seven rows are roughly 280px, which squeezes the workspace region down to a few sessions. This plugin does exactly one thing: **collapse that column of global panel entries**, and bring it back when you need it. ## Highlights - **Collapsed by default** — the workspace gets ~280px back as soon as the plugin is installed. - **One toggle** in the sidebar footer, right above "settings". - **Remembered** in `localStorage`; survives reloads and restarts. - **Nothing else is touched** — no panel, no workspace, no host behaviour; only the display of the list element the sidebar already renders. - **Themed** with `--dsw-alias-*` tokens only, so it follows the DSH theme. - **Rail-friendly** — in the narrow 56px rail the toggle becomes a round icon button. - **Grid display** — in Settings → Built-in plugins, switch the entry list to icons only (panel names become hover tooltips) with 2–4 icons per row. Bundles that skip the panel-list slot and inject their own sidebar buttons (the `data-dsh-*-entry` convention, e.g. 今日值得读 / 全局搜索 / 容器) are adopted into the grid too, and put back in place when the grid turns off. - **Keep some entries while collapsed** — list mode keeps the first 0–5 entries visible while the panels are collapsed; grid mode keeps the first 0–3 rows (rows × icons). Default 0, i.e. everything collapsed. - **Plugin display order** — pick panels one by one from a dropdown on the settings page; the list order is the sidebar order (lossless CSS `order` overrides). Capped at 20, duplicates dropped on save. The dropdown also lists slot-skipping sidebar entries (今日值得读 / 全局搜索 / 容器 and other `data-dsh-*-entry` followers); listed ones are adopted into the list so the order really applies, and released when the order is cleared. - **Click counting** — panel clicks accumulate into `~/.dsh/plugins/dsh-toomuch-plugins/click-counts.json`, (silently skipped when the remote is unavailable). - **Icon size** — pick small (12px), medium (the sidebar's own size, the default) or large (24px); the list and grid icons scale right away and the choice survives reloads. - **Off by default** — grid mode is opt-in; the preference lives in `localStorage` alongside the collapse state and survives reloads. ## Screenshots Grid display — icons only, panel names as hover tooltips, 2–4 icons per row: ![Sidebar panel list in grid display mode](docs/grid-dsh-toomuch-plugins.png) The "Sidebar panel display" settings page (Settings → Built-in plugins) — grid mode, icons per row, and how many rows stay visible while collapsed: ![Sidebar panel display settings page](docs/grid-setup-dsh-toomuch-plugins.png) ## Install The plugin is a repository-root package: it declares the `dsh.bundle` manifest, so DSH can install it straight from npm or GitHub. ```sh # from npm (prebuilt — no build approval step) dsh plugin --profile web add dsh-toomuch-plugins # from GitHub dsh plugin --profile web add github:rivenshanghai/dsh-toomuch-plugins # or from a local clone git clone https://github.com/rivenshanghai/dsh-toomuch-plugins.git dsh plugin --profile web add /path/to/dsh-toomuch-plugins ``` `dsh plugin` forwards to `pnpm` inside the profile. After the install, **enable the plugin** in DSH's plugin settings (it is written into the profile's `dsh.profile.bundles`), then refresh the page. From the plugin market, once listed: open **Settings → Plugin Market** in DSH and search for `dsh-toomuch-plugins`. **Verify:** the sidebar footer gains a "Collapse global panels / Expand global panels" row above "settings", and the global panel column is gone. Settings → Built-in plugins gains a "Sidebar panel display" page for grid mode, icons-per-row, how many entries (list) or rows (grid) stay visible while collapsed, the custom plugin display order (up to 20 entries), and the icon size (small / medium / large). Requirements: DSH (DeepSeek Harness) with a `web` profile; Node.js ≥ 20. ## How it works `src/client.js` does the following: 1. registers a toggle into the sidebar footer slot `sidebar.footer.action` (the row next to "settings"); 2. walks up from its own root node to find the sidebar root's direct `

` child — the global panel list — and toggles its `display`; 3. remembers the choice in `localStorage`; 4. registers a settings page through the `settings.plugins.tab` slot (Settings → Built-in plugins) where grid mode, the 2–4 icons-per-row choice and the three icon sizes (small / medium / large) live; 5. applies grid mode to the same `

`: a marker class plus a columns CSS variable, the label span hidden, and each entry's `aria-label` mirrored into the native `title` as the hover tooltip (DSH's own tooltip is disabled in the wide sidebar, and the label is not rendered there either); 6. applies the custom display order as CSS `order` overrides on the `

`'s direct children (lossless — React's DOM reconciliation is never fought), and makes the collapsed limit keep the first N entries *visually*; 7. mounts a hand-rolled Typert remote contribution (the dsh-cost-meter pattern) and reports panel clicks to the host half, which accumulates them into `click-counts.json` . The host half (`src/index.js`) only provides that one `spcClicks` service: a prototype method plus a written-out `typertRemote` binding, picked up by the gateway's src-descriptor fallback — no generated manifest, no DSH internals. The basis is DSH's own `@deepseek-ai/dsh-client-ui-sidebar`: `nav.panelList` is a direct child of the sidebar root, so walking up from the footer button always reaches it. Styling uses only `--dsw-alias-*` theme variables, and the stylesheet rides inside the component, so unmounting removes it. No DSH internal package is imported, and no DSH file is modified. The full contract is written down in [docs/design.md](docs/design.md). ## Repository layout ``` . ├── package.json plugin manifest: dsh.bundle.patch + dsh.client ├── cordis.patch.yml inserts the loader row into the profile ├── src/ │ ├── index.js Host half: spcClicks remote service → click-counts.json │ └── client.js Client half: footer toggle + collapse/expand + grid + display order + click reporting ├── test/smoke.js zero-dependency smoke check (node test/smoke.js) ├── locale/{en,zh}.json title and description in the plugin list ├── docs/ design notes, market submission, pre-submit checklist ├── icon.svg icon ├── CHANGELOG.md └── LICENSE ``` ## Known limits - It collapses the **global panel entries** column only. The brand row, new session and settings are left alone — the brand row's "collapse sidebar" button is the only entry point on Linux / Windows, so hiding it would lose a feature. - With no global panels installed, the sidebar never renders that `

` and the toggle is a harmless no-op. - Verified on DSH Web (Linux) only. ## Plugin market DSH plugins are listed in the [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) catalog, which aggregates the repositories carrying the **`dsh-plugin`** GitHub topic. Add that topic to this repository, then open a one-file pull request against that catalog: the entry file is `data/plugins/__.yml`, with a `category`, a one-line `description.en` and an optional `description.zh` (the catalog's contributing guide has the exact rules). ## Related plugins - [dsh-sidebar-quiet](https://www.npmjs.com/package/dsh-sidebar-quiet) — folds the sidebar **footer** rows (balance / import / memory / sign out) into one line - [dsh-sidebar-buttons](https://github.com/lywusichen/dsh-sidebar-buttons) — manage sidebar footer buttons: drag to reorder, show / fold into More / hide - [dsh-sidebar-pins](https://github.com/AndreyTepaykin/dsh-sidebar-pins) — a collapsible pinned-sessions block above the settings row - [dsh-sidebar-drawer](https://github.com/1dustycy/dsh-sidebar-drawer) — an edge-hover drawer that expands the sidebar - [dsh-plugin-sidebar-visibility](https://github.com/Robert-Wang-08/dsh-plugin-sidebar-visibility) — hide / collapse at the workspace level ## Contributing Bug reports and pull requests are welcome. Please include your DSH version, the browser, and whether the toggle appeared in the sidebar footer. Keep the change focused: this plugin does one thing, and the DOM contract it relies on is documented in [docs/design.md](docs/design.md). ## License MIT © [rivenshanghai](https://github.com/rivenshanghai) — see [LICENSE](LICENSE).