dsh-deeplink — WebUI deep-link plugin
A DeepSeek Harness Web UI plugin that opens a specific project conversation directly from a URL query parameter, instead of always returning to the last session.
?session=<session-id> → open that conversation?workspace=<workspace-id> → open that project's latest/blank conversation- Persistent links: the address bar follows the current conversation, so you can copy/bookmark/share the link at any time
- Settings toggles to enable/disable jumping and address-bar following independently
- Ships a model prompt section so the model surfaces clickable deep links when a reply refers to another conversation or project
License: MIT
Features
- Reads
?session= / ?workspace= from the page URL and switches once the session/workspace list baseline is ready
session wins when both parameters are present- When the target session/workspace does not exist (or is archived/hidden), it silently falls back to the default behavior (restore the last session) — no errors, no impact on the page
- Persistent links: whenever the current session changes (deep-link switch or a manual switch in the UI), the address bar is rewritten to
?session=<current-session-id> via history.replaceState; when no session is current, the parameters are cleared. No history pollution, no reload
- Settings toggles: two independent switches (设置 → 插件 → 插件配置, shown as a card via the official
settings.plugin.item slot, keyed by the dsh-deeplink settings namespace) — jump (process ?session=/?workspace= on load, default on) and follow (address-bar following, default on), both persisted in localStorage
- The node half registers a global prompt section so the model knows deep links exist and can attach links when a reply refers to other conversations/projects
- Pure browser half + a lightweight node half; no cordis import, no peerDependencies
Install
The plugin is installed into a profile via the standard dsh plugin mechanism — no DSH source changes required.
# Official profile (ships dsh-base + dsh-web-app, which provide the systemPrompt/webServer services):
dsh plugin --profile web add github:qyw233/dsh-deeplink
# Or a local checkout:
dsh plugin --profile web add /path/to/dsh-deeplink
The repository ships its build output (lib/ is committed), so no additional build step is required after install.
After installing, restart the Web UI and refresh the browser page. The plugin appears in the browser boot graph (__DSH_BOOT__).
Usage
Append query parameters to the WebUI URL:
| Parameter | Meaning | Example |
|---|
?session=<session-id> | Open that conversation | http://127.0.0.1:3080/?session=session-304ae36e-1e66-453a-a946-2b0a9a2b173d |
?workspace=<workspace-id> | Open that project's latest/blank conversation | http://127.0.0.1:3080/?workspace=fc8b75ae-107c-4b6c-978c-276270b03b8b |
New window/tab behavior:
- Clicking a deep link inside a conversation: the GUI's markdown renderer adds
target="_blank" to all http(s) links, so a new tab opens and the plugin switches THAT tab to the target conversation.
- Pasting
?session=... into the current tab's address bar and pressing Enter: the current page switches.
Persistent links:
- After a deep link opens, the address bar updates to
?session=<actual-session-id> (the workspace parameter is consumed and removed).
- Manually switching conversations in the UI updates the address bar the same way.
- Switching to the "no session / new" state clears the parameters and returns the address bar to
/.
- Updates use
history.replaceState, so each conversation is not left in the browser back/forward history.
Settings
The plugin registers a 深链 card in the 插件配置 tab (设置 → 插件 → 插件配置, via the official settings.plugin.item slot, keyed by the dsh-deeplink settings namespace registered on the host) with two independent toggles (both default on, persisted in localStorage):
| Toggle | Key | Effect |
|---|
| 跳转到指定对话 | dsh-deeplink.jump | Process ?session= / ?workspace= deep links on page load. Read once per load — toggle it before opening a deep link. |
| 地址栏跟随 | dsh-deeplink.follow | Keep the address bar following the current session. Read on every sync, so toggling takes effect immediately. |
Model prompt
The node half registers a global prompt section (plugin:dsh-deeplink, order −97, after web-surface and before persona) that tells the model:
- This GUI supports
?session= / ?workspace= deep links (a click opens them in a new tab);
- When a reply refers to another conversation or project (an earlier discussion, a different workspace, a follow-up of another session), attach the corresponding link so the user can jump there in one click;
- How to discover real ids: read
$DSH_HOME/storages/workspace.json (the keys of tables.workspaces are workspace ids; each record's sessionIds lists its session ids), or list $DSH_HOME/sessions/<project>/ directories (each directory name is a session id);
- Only emit ids that actually exist; never invent one.
How to find ids
- Session id: the directory name under
~/.dsh/sessions/--<project>--/<session-id>/; or tables.workspaces[].sessionIds in ~/.dsh/storages/workspace.json.
- Workspace id: the key (UUID) of
tables.workspaces in ~/.dsh/storages/workspace.json.
Develop
- Browser half
lib/client.js: changes are picked up by the running server's HMR (stat-poll, ~0.5s); refresh the page to see them.
- Node half
lib/index.js: changes require restarting dsh web.
- This plugin has no build step;
lib/ is authored directly.
Version compatibility
The browser half is pure client: no cordis import, no peerDependencies, and depends only on the runtime-provided sessions / workspaces services and their list snapshots. The node half depends on the systemPrompt / webServer services (both provided by the dsh-base and web compositions), and registers its optional settings namespace through the stable ctx.settings.register() API. It has been adapted to the httpServer → webServer service rename and ships a dsh.bundle declaration (cordis.patch.yml) for the newer dsh plugin bundle mechanism.
License
MIT · Copyright (c) 2026 DSH Community Contributors
Changelog
2026-09-13 · v0.6.1 — Current DSH settings compatibility
- Replaced the removed
settingsNamespace / installSettingsSection named imports with direct optional-service registration through ctx.settings.register().
- Restored startup compatibility with current DSH releases while preserving the configurable-plugin card and browser-local toggle behavior.
2026-08-29 · v0.6.0 — Settings move to a configurable-plugin card
- The 深链 settings (two toggles) now appear in 设置 → 插件 → 插件配置 as a collapsible card, next to 终端 / Agent 循环 / 网页搜索, rendered through the official
settings.plugin.item slot and keyed by the dsh-deeplink settings namespace (same structure and YyYd_a_* classes as the built-in PluginCard).
- The node half registers the namespace via
installSettingsSection with a schemastery schema; card toggles still persist in localStorage.
- Dependency links (
schemastery, dsh-settings) are git-ignored — install via dsh plugin --profile web add github:qyw233/dsh-deeplink which links them at runtime.
2026-08-13 · v0.5.0 — Settings toggles
- Added a 深链 section in Settings with two independent toggles:
jump (deep-link jump, default on) and follow (address-bar following, default on), both persisted in localStorage.
2026-08-13 · v0.4.0 — Persistent links + newer-version compatibility
- Address bar follows the current session: after a deep-link switch or a manual switch, the URL is rewritten to
?session=<current-session-id> via history.replaceState; cleared when no session is current. No history pollution, no reload.
- Adapted to the
httpServer → webServer service rename.
- Added the
dsh.bundle declaration and cordis.patch.yml for the newer dsh plugin bundle mechanism.
2026-08-12 · v0.3.0 — Dropped the new-window parameter, unified new-tab open
- Reverted the
&new=1 window.open logic (the renderer already forces _blank on http links, so new would open two windows).
- Prompt and README aligned: a deep-link click opens a new tab.
2026-08-12 · v0.2.0 — New-window mode + model prompt (reverted)
- (Reverted)
&new=1 new-window mode.
- Node half registers the
plugin:dsh-deeplink prompt section so the model knows deep links exist and can attach links when referring to other conversations/projects.
2026-08-12 · v0.1.0 — Initial release
?session= / ?workspace= deep-link support; unknown targets fall back silently; read-only, never rewrites the URL.
