dsh-pinned-session-bar
一个 DSH（DeepSeek Harness）Web GUI 客户端插件：在侧边栏工作区列表上方提供专用的 Pinned 栏，汇总所有已固定的会话，并支持跨容器拖放。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:YubaiLoving/dsh-pinned-session-bar#71bccbdb184d89197bdd0dd97f268f9dc62f9270Pinned Session Bar 以 dsh-pinned-session-bar 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 中文
A client plugin for the DeepSeek Harness (DSH) Web GUI. It adds a dedicated Pinned bar directly above the sidebar's workspace / session list, collects every pinned session there, and lets you drag sessions between the bar and the workspace list.
ctx.workspaces.list → pinnedSessionIds) and lists every pinned session above the workspace list.ctx.workspaces.pinSession) and places it first.ctx.workspaces.unpinSession).localStorage: dsh.pinnedBar.order.v1).retainedBy.mainView > 0, suppressed while a global panel is open) and carries aria-current.✕ appears on row hover; identical to dragging the row out.localStorage: dsh.pinnedBar.collapsed.v1.The shipped session list is left untouched: pinned rows still appear at the top of their workspace groups. The bar is an additional, collected view — not a replacement.
plugin_manager install_bundle target="github:YubaiLoving/dsh-pinned-session-bar"
Or paste the same spec into the Plugins page of the Web GUI. DSH installs the package, enables the bundle, and the bar appears after the page reloads.
node_modules:~/.dsh/profiles/<profile>/node_modules/dsh-pinned-session-bar/
cordis.patch.yml, or declare the package in the profile's dsh.profile.bundles:- insert:
- id: ui-pinned-bar
name: 'dsh-pinned-session-bar'
| Concern | Approach |
|---|---|
| Extension point | Registers into the shell.overlay slot (list, root scope) and renders into the sidebar DOM through react-dom's createPortal |
| Mount position | A sibling node immediately before [data-slot="sidebar.workspaces"] — the top of the sidebar's region area, directly above the workspace list |
| Data | The shared Client services ctx.workspaces / ctx.sessions, not slot props |
| Drag protocol | Native HTML5 drag and drop — the same protocol the shipped browser uses for its own rows, which is what makes cross-container moves possible. A capture-phase dragstart on document identifies an outside row ([data-row-key^="session:"]), dragover keeps a drop legal anywhere, and drop turns "dropped back onto the list" into an unpin |
| Selected row | Same rule as ui-workspace: the session with retainedBy.mainView > 0; the panel share is read through the usePanelInfo standard prop (falls back to no highlight when absent) |
| Ordering | The Host owns pin membership; the bar owns only its presentation order (browser-local), exactly as the shipped browser keeps its own view state |
| Dependencies | Platform-seeded modules only: react and react-dom; icons are inline SVG |
| Robustness | MutationObserver + requestAnimationFrame re-asserts the mount point; the drag source lives in a ref so no React commit can race the gesture; the stylesheet is installed once and never torn down — a hot reload runs the outgoing fiber's disposers around the incoming fiber's startup, so tearing it down deletes the new instance's styles |
The bar mounts by DOM insertion because sidebar.workspaces is a single slot — replacing it would shadow the shipped browser — and the sidebar declares no list slot above it, so there is no additive seat to register into.
@deepseek-ai/dsh-web-app); developed and verified against DSH 0.2.0-rc.2.[data-slot="sidebar.workspaces"] and [data-row-key^="session:"].node test/smoke.mjs
The smoke test loads lib/client.js inside a stub of the browser module-loader frame (React, DOM, services) and exercises registration, ordering, the selected highlight, in-bar reordering, drop-to-pin, drop-to-unpin, collapse, open and keyboard paths. It cannot validate real layout or the live services, but it executes every path of the shipped bundle.
This repository carries the dsh-plugin GitHub topic, as the DeepSeek Harness documentation asks of plugin repositories.