dsh-plugInOne

August 26, 2026 · View on GitHub

Renamed from dsh-settings-hub; the RPC namespace settingsHub and legacy data migration paths stay compatible.

English | 中文

界面示意图

A pure relay plugin for DSH that adds one Plugin settings nav row to the settings dialog and gathers every custom plugin's settings content into draggable top tabs, persisting the tab order to a JSON file.

The plugin never modifies any plugin's registration, component, or settings document. It only:

  1. Detects custom-plugin settings contributions from the live slot ledger:
    • settings.section pages that are not DSH builtin sections (general / models / plugins / agent-presets) — e.g. dsh-at-file, dsh-market, dsh-status-rotator, dsh-notification, dsh-better-sidebar;
    • settings.general.item rows contributed by plugins (e.g. dsh-peak-indicator);
    • settings.plugin.item cards contributed by plugins (e.g. dsh-peak-indicator, dsh-client-auto-continue, dshmarket).
  2. Adds one Plugin settings nav row whose page renders a horizontal tab strip. Tabs are manually draggable; the order is saved by the host half to data/order.json inside the deployed plugin folder and restored on the next load.
  3. Renders each plugin's original settings content inside its tab through a faithful port of the runtime slot-render composition (standard kit, t locale seat, inject business face, store seat, child renderSlot recursion) with per-entry error boundaries — semantically identical to the settings shell.
  4. Hides the collected content from its old seats by filtering the runtime views: the settings nav projection is filtered via a service prototype patch, and the renderer host (slots._host) is wrapped in a Proxy that filters entriesOf/entriesOfSlot. Plugin section rows disappear from the settings nav, plugin general rows from the General page, and plugin cards from the Plugins page — while the registrations themselves stay intact.

Layout

dsh-plugInOne/
├── package.json        # dsh.client.platform: web + dsh.bundle.patch
├── cordis.patch.yml    # loader insertion
├── dsh.plugin.json
├── lib/index.js        # host half: settingsHub/loadOrder + saveOrder (JSON file)
└── lib/client.js       # client bundle (hand-written, no build step)

Install (web profile)

node <DSH_HOME>/profiles/node_modules/@deepseek-ai/dsh/lib/bin.js plugin --profile web add "file:<repo path>"

Restart DSH afterwards (the plugin roster is loaded at boot), then hard-refresh the page (Ctrl+R).

If pnpm rejects the install because of its supply-chain policy (minimumReleaseAge), run pnpm directly inside the profile with the policy relaxed and add the plugin to dsh.profile.bundles manually:

pnpm add "file:<repo path>" --config.minimum-release-age=0

Verification after restart

  1. Open Settings from the sidebar foot → the left nav should contain only the builtin rows plus Plugin settings.
  2. Click Plugin settings → top tabs list each plugin; drag a tab to reorder; the order is saved to <plugin folder>\data\order.json (e.g. ~\.dsh\profiles\web\node_modules\dsh-plugInOne\data\order.json).
  3. Each tab shows that plugin's original settings content.
  4. The General page no longer shows plugin rows (e.g. peak-indicator), and the Plugins page no longer shows external plugin cards.

Notes / constraints

  • Requires the current settings slots (settings.section, settings.general.item, settings.plugin.item) and the slot renderer host — DSH ≥ 0.1.1-rc.2.
  • The builtin/core whitelists live at the top of lib/client.js: BUILTIN_SETTINGS_SECTION_IDS, CORE_GENERAL_ITEM_IDS, CORE_PLUGIN_CARD_KEYS. If the deployment adds another builtin page, keep them in sync.
  • If a plugin's section id and its plugin-card key differ, it shows as two tabs (e.g. dshmarket's market vs dsh-market); add an alias if you want them merged.
  • Degradation path: if a future runtime drops the hostFace/_host structure, the plugin loses hiding and aggregation but the aggregation row still shows content and the original seats remain untouched — it cannot break the page.
  • The client bundle hot-reloads (client-hmr polls), but the slots._host Proxy and the prototype patch only take effect on a fresh page load, so hard-refresh after editing.