DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-classic-mode

s

dsh-classic-mode

Manifest valid

DSH sidebar button that opens the classic (DS-Bot-free) Harness profile in Safari, starting it when needed.

UI (client)hasBundlePatch

dsh-classic-mode

A DeepSeek Harness (DSH) bundle that adds a DS Bot launcher to the classic sidebar footer. One click opens the configured Web profile in Safari, starting it when needed. The default profile name remains classic; install DS Bot into that profile to use its team interface.

中文说明

What it solves

The desktop app can use the classic Agent shell while a separate Web profile runs DS Bot for browser and tablet use. Both profiles share the data directory (~/.dsh). This bundle opens that Web instance without manually starting it or pasting its authenticated URL. The launcher does not install DS Bot or change either profile’s plugin selection.

  • Host half (index.js): reads ~/.dsh/classic-mode/state.json, reuses a live process started by this same host, otherwise spawns dsh --profile <profile> --no-open --port <port>, captures the ?token= URL from its output, writes state, and opens the browser. It also stops a server left over from a previous host run (see Stale instance cleanup).
  • Client half (client.js): registers the launcher in sidebar.footer.action, beside the sidebar's other plugin actions. The sidebar controls its placement and passes its wide state: expanded shows the icon and label; the collapsed rail shows only the icon. The launcher does not float over the conversation. A static DS Bot whale is embedded under Apache-2.0; no DS Bot or private Harness Client module is imported. The button calls GET /classic-mode/open. The independent DS Bot Web sidebar is not a launcher surface.

Requirements

  • DSH >=0.2.1-rc.3 <0.3.0 (Web or Desktop), Node >=22.19.
  • A second DSH profile with DS Bot enabled (default profile name classic).
  • macOS, for open -a <browser>. On other platforms, point browser at a launcher you have, or read the returned url yourself.

Install

  1. Add this package to a profile, either from a checkout or from GitHub:

    pnpm add link:/path/to/dsh-classic-mode
    # or: pnpm add github:shiyoungwoo/dsh-classic-mode
    
  2. Append the entry list in cordis.patch.yml to the profile's bundle list, or let the package's own patch apply, then set config (see below).

  3. Restart DSH, or toggle the bundle in the Plugins page.

Configuration

cordis.patch.yml ships placeholders. Set every field for your machine:

FieldMeaning
cliPathAbsolute path to the dsh launcher. Required. Desktop example: /Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh.
profileProfile to launch. Default classic.
portLoopback port for the Web server. Default 3090. Keep it free.
browserApplication name for open -a. Default Safari.

To keep machine paths out of the package, override the row in your own profile's cordis.patch.yml instead of editing this one:

- id: local-classic-mode
  name: '@local/dsh-classic-mode'
  config:
    cliPath: /Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh
    profile: classic
    port: 3090
    browser: Safari

Stale instance cleanup

The classic server is spawned detached, so it outlives the DSH host process that started it. After a DSH restart that leftover server still runs and still holds every Harness session it has open, so another DSH instance (the desktop app, another dsh web) reports those sessions as already in use until the leftover is gone.

The plugin records the host process id in state.json and stops such a leftover in two places:

  • when the bundle loads in a host process that did not start it;
  • when the button is clicked and the recorded server belongs to an earlier host process.

A process is only signalled when its command line carries this plugin's profile and port and names a DSH entry point; a stale pid that has been reused by an unrelated process is reported, not killed. A server started by the current host process is reused, never restarted.

Security notes

  • /classic-mode/open answers before DSH Connection authentication, so it rejects any request whose Origin header does not match the serving host (cross-site requests).
  • The route only accepts GET; other methods return 405.
  • The spawned server binds loopback and its token is stored in ~/.dsh/classic-mode/state.json (mode of your home directory). Do not copy that file into a repository.

Files

  • index.js — host: process supervision, state file, /classic-mode/open route.
  • client.js — client: sidebar button and fetch call.
  • cordis.patch.yml — bundle patch with placeholder config.
  • locale/zh.json, locale/en.json — localized plugin metadata.
  • DS-Bot-LICENSE — Apache-2.0 license for the embedded DS Bot whale artwork.

中文说明

这个插件在经典 Agent 界面的侧边栏底部插件区添加「DS Bot」按钮,图形使用 DS Bot 的鲸鱼。目标 Web 配置需已启用 DS Bot;配置名仍为 classic。点击后:若该实例未运行,就启动 dsh --profile classic --no-open --port 3090,从输出里取出带 token 的地址,再用 Safari 打开;已在运行则直接复用。

按钮由 sidebar.footer.action 挂载,位置随经典侧边栏布局变化。展开时显示图标和文字,折叠为窄栏时只显示图标,入口随侧边栏收起,不悬浮在对话区域。DS Bot Web 独立侧栏不挂载此入口。DS Bot 鲸鱼图形以静态形式内嵌,按 Apache-2.0 保留许可,不依赖桌面端安装 DS Bot。

配置项:cliPath(必填,dsh 启动器绝对路径)、profile(默认 classic)、port(默认 3090)、browser(默认 Safari)。仓库里的 cordis.patch.yml 只放占位值,请在你自己的 profile 补丁里按上面的 id: local-classic-mode 覆盖配置,避免把本机路径写进仓库。

残留实例清理:classic 服务是 detached 启动的,会活过启动它的 DSH 进程。DSH 重启后,这个残留服务仍在运行,并继续占用它打开的 Harness 会话,其他 DSH 实例(桌面端、另一个 dsh web)就会报「当前会话已被占用」。插件在 state.json 里记录启动它的宿主进程 PID,并在两处清理这种残留:插件在新宿主进程加载时;以及点击按钮时发现记录的实例属于更早的宿主进程。只有命令行同时带本插件的 profile、port 且是 DSH 入口进程才会被终止;PID 被无关进程复用时只报告、不终止。当前宿主进程自己启动的实例始终复用,不重启。

License

MIT for the launcher code. The embedded static whale artwork is adapted from DS Bot 0.2.6, with animation omitted, under Apache-2.0.

Comments

Loading…

Similar plugins

dsh-restart-plugin

by StarMoon-win

Sidebar restart button for DeepSeek Harness Desktop: one click fully quits and reopens the app.

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

Oct 20, 2026

dsh plugin --profile web add dsh-restart

by Mudio233

Restart DeepSeek Harness from the sidebar, with confirmation and an automatic page reconnect.

Manifest valid

★ 0

MIT

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-restart-button

by Neptune810

A draggable one-press stop button for the DeepSeek Harness Web GUI. / DSH 一键结束服务按钮。

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 0

MIT

JavaScript

Sep 23, 2026

dsh plugin --profile web add dsh-power-button

by kkaktus463

Opens the DeepSeek Harness Web UI in a native window instead of a browser tab.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Aug 23, 2026

dsh plugin --profile web add dsh-plugin-desktop

by huasheng33991

One-click start/stop button pinned to the window bottom-right corner: restarts DeepSeek Harness in place via a detached helper that relaunches the exact boot invocation (loopback same-origin guarded),

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 2

↓ 40/wk

JavaScript

Aug 16, 2026

dsh plugin --profile web add dsh-power-button

by Yingmoon0715

Drive the built-in browser inside the DSH right sidebar: open, navigate, read, click, fill, close.

Manifest valid

★ 0

JavaScript

Oct 24, 2026

dsh plugin --profile web add rightbar-driver