DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-session-quickbar

d

dsh-session-quickbar

Manifest valid

Takes over the quick-action strip on the right of every sidebar session row: choose per session which buttons show and in what order, reuse built-in star, todo, pin, archive and copy-id actions, and k

UI (client)hasBundlePatch

dsh-session-quickbar

English | 中文

One configurable quick-action strip on the right of every Session row in the DeepSeek Harness sidebar — plus a two-way channel between that strip and the Sessions that author plugins.

What it does

  • One owner for that seat. The strip registers itself in sidebar.workspaces.session.row.action and, in takeover mode (the default), hides the other entries in the same seat while it is present. What you configure is what the row shows, instead of whatever order the installed plugins happened to register in.
  • Built-in buttons that reuse existing data. Star reads and writes the session-stars route; the todo square reads and writes the session-todos route; pin and archive go through the public uiWorkspace service (a Session that is still working gets the same stop-and-archive confirmation). Copy ID is available but hidden by default.
  • Per-session layouts. A global default, plus an override per Session. Hidden buttons keep their place and can be switched back on; order is up/down in the settings page.
  • Customizable sidebar entries. The settings page lists the sidebar panel entries; unchecking one moves it out of the left rail and into the host's More menu, where it stays one click away. The choice persists in session-quickbar.json.
  • A plugin survey. The settings page lists the installed profile bundles that have a browser half and marks each one Built in, Registered, Available, or Not loaded, so it is obvious which plugins still need to adopt the bar. session_quickbar action=plugins returns the same survey to agents.
  • A real settings page. Sidebar panel list entry 快捷栏 / Quick bar, or right-click-free row menu entry 快捷栏设置… on any Session row. The page edits the global layout or one Session's layout, shows where each button comes from, and lists the channel's subscribed Sessions and recent messages.
  • Live everywhere. Layout changes are pushed over Server-Sent Events, so every open window re-renders without a reload.
  • A channel for plugin-authoring Sessions. session_quickbar (Host tool) lets any Session read or change a layout, register the button it is building, subscribe to changes, and message another Session. Every layout change is injected into subscribed Sessions as one short message, and registered owners hear where their button landed. Those Sessions answer with notify, so the bar and the Sessions that maintain it can talk both ways.

Where it lives

sidebar row (hovered)
┌──────────────────────────────────────────────────────────────┐
│ ● 会话标题                                 …   ★  ☑  ▣  📌  │
└──────────────────────────────────────────────────────────────┘
   Quick bar, order from the settings page

Settings page: left panel list → 快捷栏, or the Session row menu → 快捷栏设置….

Configuration

Open the settings page:

  • 全局默认 / Global default — the layout every Session inherits, plus the takeover switch.
  • 单个会话 / One session — pick a Session, then toggle and reorder just that row. 改用全局布局 drops the override.
  • 恢复默认 / Restore defaults — clears the explicit layout so the built-in default applies again: the todo square and the finish alert, two buttons.

The layout file is session-quickbar.json under $DSH_HOME. Deleting it restores the defaults. Turn the plugin off and the strip disappears; the star and todo plugins keep their own buttons.

What the takeover changes

While the strip is present and takeover is on, the CSS rule hides the other entries in the same slot — including the host's archive and pin buttons, which the bar re-draws itself. If the bar ever fails to render (or the plugin is disabled), the rule is inert and the original entries return. Set takeover off in the settings page to keep both sets (useful while a plugin has not migrated yet).

Action registration (for other plugins)

Any client plugin can contribute a button without touching this package:

const dispose = window.dshSessionQuickbar.register({
  id: 'my-button',
  owner: 'my-plugin',         // optional package name, shown as Registered on the survey
  labels: { zh: '我的按钮', en: 'My button' },
  hint: { zh: '一句话说明', en: 'One-line hint' },
  order: 120,
  icon: 'M3 8h10',            // 16×16 path data, optional when Component is set
  isActive: (sessionId) => false,
  onActivate: (sessionId) => { /* … */ },
  subscribe: (listener) => { /* call listener when isActive changes */ return () => {} },
})

Call dispose() when your plugin unloads. star, todo, archive, pin, and copy-id are reserved. A component instead of onActivate is also accepted (Component: ({ sessionId }) => …). The registration is reported to the Host registry so authoring Sessions and the session_quickbar tool can see it.

The full contract, including the Host tool and the migration steps for a plugin that already draws its own row button, is in CONTRACT.md.

Self-test

Open Settings → Plugins, pick this plugin, and its detail page shows a 自检 / Self-test section. Nothing runs until you click 运行自检 / Run self-test; each check is aborted after two seconds and one failure never hides the others.

  • Host route — /session-quickbar answers 200 with the layout document.
  • Client registry — window.dshSessionQuickbar exists and list() returns the action list.
  • Agent tool — session_quickbar is registered (probed through the read-only /session-quickbar/selftest route).
  • Session channel — the read-only sessions probe answers with its known-session count; no message is sent.

复制结果 / Copy result writes the same list as Markdown checkboxes.

Limitations

  • The strip only controls its own seat. Other rows, the row menu, and the conversation header are untouched.
  • The bar cannot call another plugin's React code except through the registry; an unmigrated plugin's button is hidden by takeover rather than adopted.
  • Channel targets resolve by exact Session id, exact title, or a unique title fragment. Titles are reported by the browser half when the settings page is open; without that, pass the exact id.
  • Queued messages are retried when the Session starts and by a 15-second sweep; each message gets at most three attempts with doubling backoff, and an abandoned message stays visible through session_quickbar action=messages state=pending.
  • Messages for a Session that is not loaded stay queued until it starts; they are then injected in order and wake it once, so the request is visible in its conversation. The settings page lists them under Session channel → Waiting for delivery, and a queued Session row carries an amber count; a notify also wakes a loaded idle Session by default (wake: false queues silently), while layout change notices never wake one.
  • Touch layouts keep the host's rule that only the pin action stays visible; the strip follows that rule.

Install from GitHub

dsh plugin --profile desktop add github:879745uhjun/dsh-session-quickbar

Reload the Web UI page after installing.

Comments

Loading…

Similar plugins

dsh-recent-sessions

by yfwu2020

DSH sidebar plugin: a floating recent-sessions sheet that blends into the sidebar

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 0

MIT

TypeScript

Oct 5, 2026

dsh plugin --profile web add @yfwu2020/dsh-recent-sessions

by NattoCB

Adds a Workspaces / Recent-sessions switcher above the sidebar list, with a pinned-sessions group, a per-row menu (pin/unpin, copy session id), title filtering, and browser-local pin storage with a on

UI & ExperienceSessions & MessagesManifest valid

★ 1

MIT

JavaScript

Sep 10, 2026

dsh plugin --profile web add dsh-plugin-sidebar-views

by Irrow627

DSH-plugin: open the session's workspace folder, a terminal, or VS Code straight from the conversation header — plus a settings dialog for their order and visibility.

Manifest valid

★ 0

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-quick-actions

Puts a todo checkbox on every sidebar session row and adds a dedicated Todo page that groups sessions as in progress, to do and done, with priority, due date and a note per session. Its HTTP routes ha

Sessions & MessagesManifest valid

★ 1

MIT

JavaScript

dsh plugin --profile web add dsh-session-todos

by yingrui96

An always-on attention pill in the session header. One glance shows how many sessions are waiting on you — approvals, questions, and failures — and what you already declined. Its HTTP routes have no D

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-attention-board

by ruanimal

Collapses the DSH Web sidebar panel menu (plugins, extensions, scheduled tasks, IM) from a vertical labelled list into a horizontal row of 36×36 icon buttons with hover tooltips; a Settings → General

UI & ExperienceManifest valid

★ 0

JavaScript

Sep 30, 2026

dsh plugin --profile web add dsh-sidebar-panel-buttons