dsh-hide-sidebar
DeepSeek Harness 的移动端侧边栏抽屉：在窄屏 Web 视口中，56px 的折叠栏会替换为顶部切换按钮，点击后侧边栏会滑入并覆盖内容。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:winniesi/dsh-hide-sidebar#33daec7e5f61d1490eda8992206c1b6e9e696d0dHide Sidebar 以 dsh-hide-sidebar 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A mobile left sidebar for the DeepSeek Harness (dsh) Web GUI.
On a narrow viewport the 56px collapsed icon rail stops being a permanent fixture. Instead there is one button at the top of the frame: tap it, and the sidebar slides in over the content. Pick a session — or tap the scrim — and it slides away.
Wide viewports are untouched: the sidebar docks, resizes and collapses exactly as it shipped.
English | 中文
A phone showing the Harness conversation at full width, with a sidebar toggle button in the top-left corner and no icon railThe same page with the sidebar slid in over the content, dimmed by a scrim The plugin manager page on a phone: the floating toggle sits in a reserved left gutter
"Narrow" means the frame measures less than 1024px — the same breakpoint ui-layout uses for its own auto-collapse.
| Before | After | |
|---|---|---|
| Collapsed | A 56px icon rail permanently eats a seventh of the screen, on every page | The rail is gone; content gets the full width |
| Expanded | The sidebar takes a column and squeezes the content down to ~110px | The sidebar is a 280px drawer over the content; the content keeps its width |
| Opening | The little arrow on the rail | The button at the top left — inside the header on the Conversation, floating in the top-left corner on every other panel |
| Closing | The arrow again | The scrim, the sidebar's own collapse control, or just picking a session or a panel |
That last one is deliberate: a drawer that stays open hides the thing you just asked for. Closing is decided from stable hooks (data-row-key, data-slot) plus aria-expanded / aria-haspopup — never a generated class name or a translated label. So:
On wide viewports the plugin is inert: no button is rendered, and every layout rule is gated on html[data-dsh-hide-sidebar] — an attribute written only while the frame's measured width is below the breakpoint.
Requires dsh >= 0.2.0-rc.1 < 0.3.0-0. That range is checked at install and boot time through peerDependencies, and it has to spell out the prerelease: a ^0.2.0 range does not match 0.2.0-rc.2.
# From GitHub
dsh plugin --profile web add github:winniesi/dsh-hide-sidebar
# Or from a local checkout — pnpm creates a link, so edits only need a page reload
dsh plugin --profile web add /path/to/dsh-hide-sidebar
Then reload the browser page; no dsh restart is needed.
On the desktop app, use Settings → Plugins → Add plugin → Local directory instead and restart the app afterwards. There is no --profile desktop: that profile belongs to the Electron app.
Uninstall with dsh plugin --profile web remove dsh-hide-sidebar.
| Changed | Needed |
|---|---|
client.js (drawer, buttons, styles, copy) | Reload the browser page |
package.json / cordis.patch.yml | Usually recomposes through live reload |
index.js (the host half, currently empty) | Restart dsh |
Two halves. index.js is the host half and deliberately does nothing — this plugin touches no model, no filesystem and no transport; it exists only because a Loader row has to resolve to a plugin. Everything else lives in client.js, a hand-authored bundle: no build step, so components use React.createElement instead of JSX and the styling is one injected .dsh-hs- stylesheet.
ctx.layout.toggleSidebar() flips narrowExpanded.data-sidebar-collapsed attribute; nothing is stored twice.The frame receives its three tracks as an inline grid-template-columns. One !important rule turns the first track into 0px, but the sidebar column stays a grid item: taking it out of flow would shift the centre and right columns one track left (the centre would land on the 0px track). So the column stays put as a containing block and only the sidebar's own root becomes the absolutely positioned drawer:
[data-slot="root"] > div ← the frame, a three-track grid
├─ div (sidebar column) position:relative, 0 wide
│ └─ [data-slot="sidebar"] > * ← the drawer, absolute + translateX(-101%)
├─ centerCol
└─ rightbarCol
translateX(-101%), clipped by the frame's own overflow:hidden; open is translateX(0) on a single 0.26s easing curve.shell.overlay slot and uses the app's own modal mask tokens (--dsw-alias-bg-mask-1 plus --dsw-mask-blur), so light and dark follow along. Layering puts the drawer (z-index 30) above the overlay layer (20): the scrim dims the content, never the drawer.conversation.header.leading, so its button sits in the title row and costs no space;IconPanelLeftOutlineRegular, copied verbatim out of @deepseek-ai/dsh-client-ui-primitives — same 16px box, 1px stroke, rounded frame and colour token. The top-right "open right sidebar" control draws that very artwork mirrored (scaleX(-1)), so taking it unmirrored here is that icon turned 180°: the two corners read as one family. It is copied instead of imported because a profile-installed plugin must not depend on dsh's own packages, and a failed require would take the whole Web boot down with it; the offline check re-reads the installed artwork and fails if this copy ever drifts.shell.overlay, conversation.header.leading, ctx.layout.toggleSidebar(), ctx.slots, ctx.locale, plus ui-layout's own data-sidebar-collapsed attribute. No @deepseek-ai/* runtime import — a profile-installed plugin cannot resolve dsh's own node_modules — so the only dependency is React, alongside the browser's ResizeObserver, MutationObserver and :has().
npm test # = node test/smoke.mjs — offline, no browser needed
test/smoke.mjs loads client.js the way the module loader really does (through window.__ModuleLoader__.load), drives apply() with a stub context, then renders both seats with react-dom/server. It runs 49 assertions here (43 when dsh is not installed for the two comparisons below), covering the registration shape (two slots, the list-slot id, locale, the injected face, exports.inject), splitTracks edge cases (nested parentheses, empty, single track), the frame-state observer (notifies only on a real change), the rendered markup (no undefined, no NaN, aria-label/aria-expanded present) and the stylesheet's discipline: every layout rule gated on the root attribute, no literal colours, and every --dsw-* token it uses verified against the token list of the theme actually installed on this machine. The panel glyph is checked the same way: both SVG paths, the viewBox and the stroke width are compared against the artwork in the installed primitives bundle, so a copy that drifts from upstream fails the test instead of quietly looking wrong.
That last group exists because a component that throws inside a slot silently empties the whole slot in the browser, so awkward inputs are worth rendering. The two comparisons read files dsh itself installed; they are skipped with a note when dsh is absent, and a moved or renamed upstream icon prints a reminder instead of failing the suite — the plugin has no runtime dependency on that package, so its internals being reorganised is not this plugin's failure.
There is also a live check against a running GUI:
DSH_URL="http://127.0.0.1:3080/?token=…" node test/live-browser.mjs
It opens a 390×844 phone viewport and a 1440×900 wide viewport and asserts: the rail is off canvas while the inline style still asks for 56px, exactly one toggle seat is reachable at a time, the drawer opens flush to the left edge, the sidebar's own collapse control closes it, picking a session row dismisses it, a panel page gets the floating button and its 40px gutter, the wide layout is untouched, and the console stays clean. Screenshots land in test/artifacts/.
SIDEBAR_AUTO_COLLAPSE; deliberately not configurable.:has(): used to select the sidebar column and to detect the Conversation — Chrome 105+, Safari 15.4+, Firefox 121+, i.e. every current phone browser.touch-action:none strip along the drawer's edge would only swallow scroll gestures.dsh 0.2.x's public client seams, which are still moving fast. If a slot or attribute is renamed inside 0.2.x, the constants at the top of client.js are the only place that has to follow.MIT