dsh-sidebar-tags
为 DeepSeek Harness 侧边栏提供彩色会话标签：可从会话行标记任意会话，一眼查看标签，并通过专用侧边栏面板按标签筛选完整历史记录。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ysefu/dsh-sidebar-tags#9b10a713fbf38fe023efd207392542ea35699ddfSidebar Tags 以 dsh-sidebar-tags 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Colored session tags for the DeepSeek Harness sidebar. Tag any session from its own row, see the tag at a glance, and filter your whole history by tag from a dedicated sidebar panel.
A long-running Harness install turns into hundreds of sessions across several workspaces. The sidebar can show them, search them and archive them, but there is no way to say "this one is a client deliverable" or "come back to this on Friday" — and no way to get those sessions back as a set.
This plugin adds exactly that layer, and nothing else:
| Tags on the row | A colored dot (plus +n) at the start of the session row |
| Tag from the row | An entry in the row's "…" menu and a hover button, both a one-click picker |
| Tag on hover | The hover card lists the session's tags and its note |
| Tag panel | A sidebar panel: per-tag counts, one-click filtering, full-text search over titles and notes, jump to session, create/rename/recolor/delete tags, export/import a backup |
It is a pure client-side plugin: no host routes, no files outside the browser, no
model-facing content, no changes to any shipped Harness file. Data lives in
localStorage and can be exported as JSON at any time.
# from npm (once published)
dsh plugin --profile <profile> add dsh-sidebar-tags
# from a checkout of this repository
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-sidebar-tags
Then restart that profile (or reload the Web GUI). The plugin appears in the sidebar as Session tags.
Uninstall:
dsh plugin --profile <profile> remove dsh-sidebar-tags
Six tags ship with the plugin (To do / Doing / Important / Reference / Archivable / Idea); all of them can be renamed, recolored or deleted, and new ones can be created in the panel.
| Harness | Status |
|---|---|
0.2.0-rc.2 | tested (see "How this was verified") |
0.2.0-rc.1 | expected compatible (same slot contract) |
| older lines | the plugin stays dormant and logs nothing; the seats it needs did not exist |
The plugin contributes only to seats the shell declares
(sidebar.panellist, the keyed main, sidebar.session.row.leading,
sidebar.session.row.hover, sidebar.workspaces.session.menu.item,
sidebar.workspaces.session.row.action) and every registration goes through
ctx.slots.inject. A shell without a seat never runs the callback, so a future
Harness that renames a seat degrades to "this one feature is missing" instead of
breaking the boot.
sidebar.session.row.leading only while a row's primary state is idle; a row
that is running, waiting for approval or carrying an unread completion shows
the host's own status dot there instead. The tags are still visible in the
hover card, the row menu and the panel.localStorage is per browser profile. Clearing site data clears tags;
private windows start empty. Export a backup if that matters.Everything below is runnable from a checkout with plain Node (no bundler, no network):
node scripts/build.mjs # bundle + manifest guard (34 invariants)
node scripts/test.mjs # 34 unit tests, in one process
node --test "tests/**/*.test.mjs" # the same tests through Node's own runner
scripts/verify-browser.mjs <gui-url> drives a headless Chromium over the
DevTools protocol against a live instance and asserts that the stylesheet is
injected, the panel row exists, selecting it mounts the panel, and the panel
renders — useful in CI with a browser available. lab/index.html (served by
node tools/serve.mjs) renders the same bundle in a stand-in shell so the UI can
be inspected without installing anything.
State that has actually been observed, not just intended:
link: install, and the host
serves dsh-sidebar-tags/client.js in the profile's boot graph;scripts/build.mjs and the unit suite pass on Node 24;Not yet observed: a click-through of the rendered panel inside a real Harness
window. The environment this plugin was written in had no browser that could
start (sandbox) — that check is the first thing to run on a normal desktop, and
scripts/verify-browser.mjs automates it.
sidebar.panellist ──► panel row (icon) ┐
main (key = sidebar-tags) ──► the panel page │ registered with ctx.slots.inject,
sidebar.session.row.leading ──► the row dot │ so load order never matters and a
sidebar.session.row.hover ──► tags + note │ shell without the seat stays quiet
sidebar.workspaces.session.menu.item ──► picker │
sidebar.workspaces.session.row.action ──► picker┘
localStorage ──► TagsDb ──► snapshot store ──► components (React.useSyncExternalStore)
▲
pure functions: validate, migrate, toggle, prune, filter
Panel data comes from the Harness' own Cordis stores (sessions.list,
uiSession.sessionStatus, workspaces.list) read through getSnapshot() and
subscribe() — the same observables the shipped sidebar reads, so no extra
polling, RPC or duplicate cache exists.
lib/client.js is hand-written CommonJS wrapped in the one call the Harness
loader expects:
window.__ModuleLoader__.load({ id: 'dsh-sidebar-tags', factory: (require) => { … } })
The only module it requires is react, which every shell provides. That means
the published artifact is the source: a checkout is installable and reviewable
as-is, git diff shows behaviour, and there is no toolchain to trust or keep
current. scripts/build.mjs replaces a bundler with a structural check —
wrapper shape, bundle id versus package name, patch row versus package name,
region index versus file body, and syntax. The trade-off is no TypeScript and no
tree-shaking, which a plugin of this size does not miss; if that changes, the
module boundaries are already laid out as @region sections for a move to
tsdown.
lib/index.js host half (inert: the plugin is browser-only)
lib/client.js browser half — the shipped bundle
cordis.patch.yml the bundle patch layer that mounts the plugin
scripts/build.mjs bundle and manifest guard
scripts/test.mjs in-process test entry
scripts/verify-browser.mjs headless-Chromium smoke check
scripts/sandbox-install.mjs install into a throwaway profile
scripts/publish-github.mjs create + push the repository over the REST API (no git needed)
tests/ 34 unit tests + the fake-shell harness
lab/index.html stand-in shell that renders the bundle in a browser
tools/serve.mjs throwaway static server for the lab
Issues and PRs are welcome. Please run node scripts/build.mjs && node scripts/test.mjs before opening a PR; CI runs both plus the browser smoke check.
MIT — see LICENSE.