- Início
- Plugins
- Melhorias de UI
- dsh-sidebar-session-tabs
dsh-sidebar-session-tabs
zekilou/dsh-sidebar-session-tabs
Filter tabs (all, running, needs me, pinned, one per tag, one per session source) and per-session tags for the sidebar session list; plugins can register sources to add rows from another machine or to filter native sessions by origin.
Instalar
dsh plugin --profile web add github:zekilou/dsh-sidebar-session-tabsREADME
dsh-sidebar-session-tabs
A community plugin for DeepSeek Harness that puts a filter tab strip above the sidebar's session list and lets you tag sessions.
English | 中文
Why this is a fork
The sidebar's browsing region is the single-occupant slot sidebar.workspaces. Its section header, search box, session tree, row menus and dialogs all live inside one component, and the slot declares no extension point between the header and the list — so a separate plugin cannot add a row there.
This package therefore ships a fork of @deepseek-ai/dsh-client-ui-workspace's Client bundle with the tab strip and tags added, and a patch that disables the shipped row so the two registrations cannot coexist. Everything else in the region is upstream code with its behaviour intact.
Features
- Filter tabs under the Workspaces header:
All,Running,Needs me,Pinned, plus one tab per user tag. Each tab carries a live count. +creates a tag tab; double-click renames it; right-click opens rename/delete. Deleting a tag also drops that tag's assignments; deleting the active tag falls back toAll.- Session row menu →
Tags…opens a dialog listing every tag as a checkbox, with an inline field that creates a tag and assigns it in one step. - Tag dots on rows — up to three colored dots per tagged session; the hover card lists the tag names.
- Auto-expand on filter — switching to a filter tab opens every workspace that still has matches; the saved expand/collapse state is not rewritten.
- Unchanged from upstream: the
session.searchshortcut and search results (including content search), drag reordering of sessions and workspaces, the manual/updated sort order, grouping modes, pin / rename / fork / archive / copy-id row actions and their hover buttons, workspace rename and delete, add workspace, the stop-and-archive confirmation, row notices, and the blank-session workspace picker.
Filter semantics:
| Tab | Shows |
|---|---|
All | The unfiltered list, exactly as upstream derives it |
Running | Sessions whose UI status reports running work (children included through their own status) |
Needs me | Sessions with a pending approval, plan review, or user question |
Pinned | Sessions in the registry-global pin set |
| a tag tab | Sessions carrying that tag |
The current blank draft stays visible in every tab, and archived sessions keep following the region's own archived filter rather than the tabs.
Contributing sessions from another source
The tab strip and the list are built from the local Session Controller, but the region also accepts foreign session sources: a small plugin of your own can contribute sessions that live somewhere else — another machine's harness behind SSH, a projection, a fixture — without forking this package.
// client.js of your plugin
window.__ModuleLoader__.load({
id: 'acme-remote-sessions',
factory(require) {
return {
inject: ['sidebarSessionSources'], // ← the service this package provides
apply(ctx) {
const dispose = ctx.sidebarSessionSources.register({
id: 'acme', // stable and unique; 'local' is reserved
label: 'Acme box', // group header text
accent: '#6f8ff5', // optional row dot color
getSnapshot: () => ({
groups: [{ id: 'g1', label: 'Acme box' }],
sessions: [
{ id: 'a1b2', title: 'Refactor the parser', updatedAt: Date.now(), group: 'g1', running: true },
],
}),
subscribe: (listener) => trackChange(listener), // optional; returns an unsubscribe
open: (session) => openOnTheOtherMachine(session), // required; the source owns navigation
})
ctx.effect(() => () => dispose(), 'acme: source')
},
}
},
})
What the region does with a registered source:
- One group section per source, headed with the source's
labeland its row count, so "which machine is this from" is structural rather than a label on every row. A source may declare several groups inside its section. - The same row geometry as local sessions — 32px, same hover, same title clip, same compact relative time. Rows are sorted by
updatedAtinside their group. - A tab in the filter strip, one per source that actually has rows, carrying that source's live count. Selecting it narrows the list to that source; the local groups disappear.
- Search — a foreign row whose title (or source label) matches the current query appears in the search results, tagged with its source.
- Hover card — full title, relative time, and the source name with its accent dot.
- Clicking a row calls your
open(session, row); the region never guesses what opening a remote session means. Ifopen()throws or returns a rejecting promise, it is logged and nothing else changes.
Filtering native sessions by origin (filterOnly)
If your plugin already merges remote sessions into the local list — so they arrive as ordinary rows in the normal workspace groups — you do not want a second copy of them. What you want is a filter dimension. Register a filterOnly source:
ctx.sidebarSessionSources.register({
id: 'zeki',
label: 'Your other machine',
filterOnly: true, // contributes no rows of its own
ownsNativeSession: (sessionId) => sessionId.startsWith('remote:zeki/'), // required
getSnapshot: () => ({ groups: [], sessions: [] }), // still required, still wins a tab
})
- The tab appears as soon as the source is registered, even while it has no rows — the strip is derived from the registry, not from contributed rows.
- Selecting it keeps the native rows that
ownsNativeSessionclaims and drops the rest. They are ordinary sessions, so clicking one goes through the normalsessions.retain()path: history, continuation, everything. - Its tab count is the number of native rows it claims.
filterOnlysources never produce a group section, so no empty group is rendered.- A source may combine both: contribute its own rows and claim native ones. Both land on the same tab.
ownsNativeSessionis called per visible row on each derivation. Keep it O(1) — an id prefix test, not a lookup that scans a remote list.- If it throws, that source's tab falls back to unfiltered rather than blanking the list. If a tab names a source that is no longer registered, the view falls back to unfiltered too.
A source without ownsNativeSession behaves exactly as before: its tab filters to its own contributed rows.
What a source cannot do, by design: rename, archive, pin, fork, drag-reorder, or tag a foreign row through the local actions. Those actions write to this machine's Workspace registry and session log, which do not own the remote session. A source that needs such an operation must expose its own affordance (for example a row menu item registered into sidebar.workspaces.session.menu.item, or its own control in the source's group header).
Failure handling: a source whose getSnapshot() throws, returns a non-object, or yields malformed rows is skipped (console.warn) and the rest of the list still renders. A duplicate id, a missing open, or getSnapshot is rejected at register() time with a thrown Error. With no source registered — which is every existing user — the region renders exactly what it rendered before this extension point existed, and no code path reads the registry.
Install
Prerequisites: a Harness profile that exposes the plugin_manager tool (the web profile does) and dsh 0.2.x.
-
Install the bundle — either ask the agent in the Harness, or call the
plugin_managertool:action: install_bundle target: github:Zekilou/dsh-sidebar-session-tabsA prebuilt tarball is attached to every release, which skips the build-approval step:
action: install_bundle target: https://github.com/Zekilou/dsh-sidebar-session-tabs/releases/download/v0.1.0/dsh-sidebar-session-tabs.tgzFrom a local clone, pass its absolute path instead.
-
Reload the Harness Web page once; the Client bundle registers on boot.
-
The session list now has the tab strip. The shipped browsing region is replaced by this package's row, which is why installing it disables
ui-workspace; removing or disabling this bundle restores the shipped region.
Compatibility
The bundle was forked from the 0.2.1-rc.5 Client bundle and its engines.dsh is >=0.2.1-rc.5 <0.3.0-0. A different Harness frontend may have changed the slot props, the CSS custom properties, or the uiWorkspace service shape this fork registers, so other versions are unsupported until the fork is re-synced.
Tags and the selected tab are client-local: they persist in localStorage under dsh.sidebarSessionTabs.v1 and do not travel between browsers, profiles, or machines. The session log is untouched — a tag is UI metadata, not a session event.
Maintenance: re-syncing the fork
Upstream changes to the browsing region do not reach this package automatically. To re-sync against a newer Harness:
- Copy the installed bundle:
cp <dsh>/node_modules/@deepseek-ai/dsh-client-ui-workspace/lib/client.js client.js. - Re-apply the identity renames (
client.jsheader comment,window.__ModuleLoader__.load({ id }), the CSStagId/dataset.pluginstrings) and restore thelocal/session-filter-tabsregion plus the file header. - Re-apply the integration points: the filter memos and tab row in
WorkspaceBrowser, the narrowedlist/workspacesarguments passed toSessionTree/FlatList,SessionNodeItem's tag dots and hover-card line,EmptySessions' filtered copy, thetabs.*/tags.*dictionary keys, and thesession-tagsmenu row plusworkspace.session-tagsdialog registrations inapply. - Bump the version, cut a release, and refresh the installed bundle.
License
MIT — see LICENSE. Forked portions are MIT-licensed by DeepSeek; what was copied and what was added is recorded in THIRD_PARTY_NOTICES.md.
Plugins relacionados
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
dsh-TUI
ccch1mneyyy/dsh-tui
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui