dsh-plugin-collapsible-steps
English | 中文
A DeepSeek Harness (DSH) Web plugin that folds every run of consecutive collapsible-card steps between messages into a single + N steps row. Click the row to collapse the run (hiding all but the most recent step) or expand it back. The shipped conversation cards and markdown answers are left untouched — the rows are annotated, never replaced.
What it does
- Adds a Collapse steps / Expand steps control to the session header, and a
- N steps row before every run of consecutive step nodes.
- Collapsing a row hides that run's rows (
display: none, so no empty gaps
are left behind) except the most recent one, which stays below the + N steps text; clicking + expands the run back.
- A "step" is any collapsible-card row —
tool-call,workflow-run,
command, command-input, compaction, context (context injection), manual-compaction, model-retry, and an assistant message's Think (reasoning) disclosure. The final text answer, user/steering messages, and turn notices act as group boundaries.
- The regular tool cards, reasoning sections, and markdown answer rendering
all remain the shipped DSH ones.
- A Collapsible steps card under Settings → Plugins controls whether runs
are collapsed by default.
Settings
The plugin registers a collapsible-steps settings namespace with one option:
collapseByDefault(boolean, defaulttrue) — collapse runs of steps by
default. Turn it off to keep runs expanded until you collapse them manually.
How it works
The slot system gives a plugin no way to wrap the shipped conversation cards, so instead of replacing the step renderers this plugin annotates the shipped DOM: it reads the conversation node order through the session hook, computes the runs of consecutive steps, and inserts the bracket headers directly into the existing flow (the node rows themselves are never moved, so the shipped view keeps reconciling normally).
Files
| File | Purpose |
|---|---|
lib/client.js | Browser half — the header control, bracket insertion, collapse state, and the settings card. |
lib/index.js | Host half — registers the collapsible-steps settings namespace. |
lib/invariant.js | Invariant registration. |
cordis.patch.yml | Composition patch that inserts the plugin row and its default config. |
package.json | Package metadata (dsh.bundle + dsh.client manifest). |
Install
dsh plugin --profile web add github:mervyn-teo/dsh-plugin-collapsible-stepsThen restart dsh web — host bundles load at boot.
Requirements
- DSH with the base conversation UI (
@deepseek-ai/dsh-client-ui-conversation)
mounted — the plugin inserts brackets into its chat flow.
