dsh-plugin-settings-float

DeepSeek Harness plugin that turns the settings dialog into a draggable, edge-resizable floating window, so you can keep the chat visible (and usable) while changing settings.

The native settings surface is a centered modal with a full-screen scrim: it covers the conversation and cannot be moved. This plugin keeps the same React tree but lifts the panel out of the modal — no scrim, a floating panel you can drag by its header and resize from any edge or corner.

⚠️ This is a DOM-level enhancement built against the current DSH settings shell. The upstream bundle is never modified, and if a DSH upgrade changes the settings markup the plugin simply stops applying (the settings page keeps working as the native modal). Treat it as a convenience layer, not a fork.

Features

• Draggable — grab the nav title or content header and move the window anywhere.
• Eight resize handles — drag any edge (↑↓←→) or corner (⤡ ⤢); opposite edges stay anchored.
• Chat stays alive — the dark scrim is removed and the overlay stops swallowing pointer events, so the conversation is visible and clickable behind the window.
• Remembers geometry — position and size persist in localStorage per browser profile.
• Reset shortcuts — double-click a header to snap back to the default spot; double-click a resize handle to restore the default size.
• Configurable — defaults, minimum size, enable switch and optional click-outside-to-close are exposed as a DSH plugin config card.

Install

dsh plugin --profile <your-profile> add dsh-plugin-settings-float

Then make sure the bundle is listed in the profile's package.json (the Plugins page does this for you when installed from the GUI):

"dsh": {
  "profile": {
    "bundles": [ "...", "dsh-plugin-settings-float" ]
  }
}

Restart the DSH host — client bundles are composed at boot, so a page refresh is not enough.

Usage

Action	Result
Drag nav title / content header	Move the window
Drag any edge or corner	Resize (min size applies, viewport-clamped)
Double-click a header	Reset position to the default spot (right side, vertically centered)
Double-click a resize handle	Reset size to the configured default
Esc / ✕	Close settings (unchanged)

Configuration

Open Settings → Plugins → Settings Float (the card is generated from the plugin schema), or set the row config in the profile patch:

- id: settings-float
  name: dsh-plugin-settings-float
  config:
    enabled: true
    defaultWidth: 760
    defaultHeight: 720
    minWidth: 480
    minHeight: 320
    closeOnOutsideClick: false

Key	Default	Meaning
enabled	true	false keeps the native centered modal
defaultWidth / defaultHeight	760 / 720	Initial size, used until the user resizes once
minWidth / minHeight	480 / 320	Smallest size the window can be dragged to
closeOnOutsideClick	false	Sends Escape when the chat behind the window is clicked

Compatibility

• Verified against DSH 0.2.1-rc.3 (desktop and web profile share the same settings shell).
• The panel is found by role="dialog" + settings-only children, with the release's hashed class only as a fast path — so a rename usually degrades gracefully instead of breaking.
• Requires a web-capable DSH surface (dsh.client platform web).

Privacy

• No network requests, no host-side changes, no telemetry.
• Only two localStorage keys are written: dsh.settings-float.pos.v1 and dsh.settings-float.size.v1.

Development

npm install
npm test        # jsdom smoke tests: mount, 8-direction resize, drag, reset, config

Layout:

lib/index.js     host row: plugin entry + Config schema (the settings card)
lib/client.js    browser half: DOM enhancement, drag & resize
test/            jsdom smoke tests driving real pointer events

The client bundle uses DSH's client-module ABI (window.__ModuleLoader__.load({ id, factory })); id must match the package name.

License

MIT