Back to directory

dsh-plugin-ya-workspace-sidebar

In a curated listMaintenance: Active

huanlinoto/dsh-plugin-ya-workspace-sidebar

DSH Web 工作区侧栏替代插件:顶部最近会话 + Workspace→Session 二级菜单与面包屑导航,复用原生 Host 能力。

View on GitHub
$ dsh plugin --profile web add @huanlin/dsh-plugin-ya-workspace-sidebar

14

stars

0

forks

TypeScript

Language

NOASSERTION

License

2026-08-10

Created

2026-11-07

Last push

DSH Web plugin bundle (TypeScript) that swaps the built-in workspace sidebar for a recent-session list, a Workspace → Session menu, breadcrumbs and right-click housekeeping menus.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-14

License

NOASSERTION

01What can it help you accomplish?

  • Find and reopen any recent DSH Web session without hunting through workspace folders

    A top section of global recent sessions rendered with virtual scrolling — the full list, not a capped top five

    DSH Web users who work across many workspaces and sessions every day

  • Get from breadcrumb to the right session in one sidebar instead of two panels

    A Workspace → Session two-level menu under the recent list, with a draggable divider (arrow-key nudge, double-click reset) between the two areas

    Users who keep several workspaces open and want the session list grouped by day

  • Do everyday session housekeeping — pin, rename, mark unread, copy a path — from the sidebar

    Right-click menus on session and workspace rows with pin, rename, unread dot, open in file explorer, and copy path / task path / log path / session ID

    Developers who jump between a session, its working directory and its log file

02How to install into DeepSeek Harness

Prerequisites

  • A DSH Web profile — the README always installs with `--profile web`
  • For local development, a checkout of the plugin and `pnpm` to run `pnpm run build`

Installation steps

  1. 01

    Install from npm (the README's recommended path): `dsh plugin --profile web add @huanlin/dsh-plugin-ya-workspace-sidebar`

    $ dsh plugin --profile web add @huanlin/dsh-plugin-ya-workspace-sidebar

  2. 02

    For local development with hot reload: `dsh plugin --profile web add "link:D:/Projects/deepseek-harness/ya-workspace-sidebar"`

    $ dsh plugin --profile web add "link:D:/Projects/deepseek-harness/ya-workspace-sidebar"

  3. 03

    After changing the source, re-run `pnpm run build`, restart `dsh web` and hard-refresh the browser

    $ dsh web

Verify the integration

  • After a build, confirm `lib/index.js`, `lib/client.js` and `lib/types/` exist and that `lib/client.js` is wrapped in `window.__ModuleLoader__.load()`
  • The DSH Web UI starts with the replacement sidebar: recent sessions on top, Workspace → Session menu below

03DSH integration and capability boundaries

DSH integrationNative runtime

DSH Web plugin bundle: `cordis.patch.yml` disables the built-in `ui-workspace` and inserts `@huanlin/dsh-plugin-ya-workspace-sidebar`, whose client entry also supplies its own stand-in for the `ctx.uiWorkspace` service

  • Global recent-session list with virtual scrolling

    the DSH Web session history→a full recent-session list above the workspace menu, with pinned rows floating above the date groups

  • Workspace → Session two-level menu and breadcrumbs

    the selected workspace→a two-level Workspace → Session menu plus breadcrumb navigation, with sessions grouped as today / yesterday / earlier

    the divider position is draggable and can be nudged with the arrow keys or reset by double-click
  • Session and workspace context menus

    a session row or a workspace row→session menu: pin, rename, mark unread, open working directory in explorer, copy path / task path / log path / session ID; workspace menu: new session, open in explorer, copy path, rename, delete

    pin and unread marks are stored locally in the browseropening a session clears its unread dot automatically
  • `ctx.uiWorkspace` stand-in for official DSH packages

    calls from `ui-sidebar`, `ui-conversation`, `ui-agent-preset` and the directory picker→reuse / new-session navigation, current / recent fallback, archive cleanup and the startup auto-selection strategy, so those entries do not stay pending

    passes through newer official parameters such as `StartSessionOptions` (`agentPreset`, draft content) and `forkSession`'s `allowMigration`

04Who is it for? When not to use it?

Good for

  • DSH Web users who work across many workspaces and sessions every day
  • Users who keep several workspaces open and want the session list grouped by day
  • Developers who jump between a session, its working directory and its log file

Not for

  • The plugin targets DSH Web builds from v0.1.2-alpha.1 onwards, where the official `ui-sidebar` / `ui-conversation` / `ui-agent-preset` packages inject `ctx.uiWorkspace`; parameter pass-through follows dsh 0.2.1-alpha.5 semantics.

05Compatibility, maintenance and safety notes

  • The plugin targets DSH Web builds from v0.1.2-alpha.1 onwards, where the official `ui-sidebar` / `ui-conversation` / `ui-agent-preset` packages inject `ctx.uiWorkspace`; parameter pass-through follows dsh 0.2.1-alpha.5 semantics.
  • Task path and log path menu entries only work on file-based (jsonl) persistence; on sqlite-style deployments such as `@morlay/better-session` those items are disabled automatically.
  • The browser bundle is pre-built into `lib/client.js`, so `lib/` must be committed when the repo is published, and any source change requires a rebuild plus a `dsh web` restart and hard browser refresh.
  • It replaces the sidebar UI only: search, adding a workspace, rename, delete, fork and archive still call DSH's native host capabilities, and the `dsh/` folder is a type/behaviour reference the plugin never modifies.
2026-08-102026-11-07Not specified by the author

NOASSERTION · README evidence only, no GitHub release, no security audit

06Frequently asked questions

How do I install ya-workspace-sidebar into DeepSeek Harness?

Run `dsh plugin --profile web add @huanlin/dsh-plugin-ya-workspace-sidebar` — the README always targets the `web` profile. For local development, install from a link instead (`dsh plugin --profile web add "link:D:/Projects/deepseek-harness/ya-workspace-sidebar"`), then re-run `pnpm run build`, restart `dsh web` and hard-refresh the browser after source changes.

Does it disable the built-in DSH sidebar?

Yes. The plugin ships as a bundle whose `cordis.patch.yml` disables the official `ui-workspace` and inserts `@huanlin/dsh-plugin-ya-workspace-sidebar`. Its client entry also provides its own stand-in for the `ctx.uiWorkspace` service that official packages inject — otherwise those entries would stay pending and deadlock WebUI startup.

Which actions still go through DSH itself?

Search, adding a workspace, rename, delete, fork and archive keep using DSH's native host capabilities. The plugin replaces the sidebar UI and adds local pin and unread marks; it does not reimplement those host operations.

Why are some copy-path menu items greyed out?

Task path and log path only exist on file-based (jsonl) persistence. On sqlite-style deployments such as `@morlay/better-session` those menu entries are disabled automatically, while copying the plain path and session ID still works.

Is the repo ready to run from source as-is?

Only if `lib/` is present: the browser bundle is pre-built into `lib/client.js`, so the repo must ship `lib/`. After a build, confirm `lib/index.js`, `lib/client.js` and `lib/types/` exist and that `lib/client.js` is wrapped in `window.__ModuleLoader__.load()`.

08Data and sources

  • Author-claimedgithub.com17256f51c95b…

    插件采用 bundle 形式,`cordis.patch.yml` 会禁用官方 `ui-workspace` 并插入 `@huanlin/dsh-plugin-ya-workspace-sidebar`。

  • Author-claimedgithub.com17256f51c95b…

    dsh plugin --profile web add @huanlin/dsh-plugin-ya-workspace-sidebar

  • Author-claimedgithub.com17256f51c95b…

    本插件 client entry 通过 `src/client/navigation.ts` 自供该服务的替身(含复用/新建会话导航、current/recent 回退、归档清理与启动自动选择策略),否则这些条目会永久 pending 导致…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-14. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.