dsh-classic-mode
Manifest validDSH sidebar button that opens the classic (DS-Bot-free) Harness profile in Safari, starting it when needed.
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 spawnsdsh --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 insidebar.footer.action, beside the sidebar's other plugin actions. The sidebar controls its placement and passes itswidestate: 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 callsGET /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, pointbrowserat a launcher you have, or read the returnedurlyourself.
Install
-
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 -
Append the entry list in
cordis.patch.ymlto the profile's bundle list, or let the package's own patch apply, then setconfig(see below). -
Restart DSH, or toggle the bundle in the Plugins page.
Configuration
cordis.patch.yml ships placeholders. Set every field for your machine:
| Field | Meaning |
|---|---|
cliPath | Absolute path to the dsh launcher. Required. Desktop example: /Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh. |
profile | Profile to launch. Default classic. |
port | Loopback port for the Web server. Default 3090. Keep it free. |
browser | Application 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/openanswers before DSH Connection authentication, so it rejects any request whoseOriginheader does not match the serving host (cross-site requests).- The route only accepts
GET; other methods return405. - 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/openroute.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
by StarMoon-win
Sidebar restart button for DeepSeek Harness Desktop: one click fully quits and reopens the app.
★ 0
MIT
JavaScript
Oct 20, 2026
dsh plugin --profile web add dsh-restartby Mudio233
Restart DeepSeek Harness from the sidebar, with confirmation and an automatic page reconnect.
★ 0
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-restart-buttonby Neptune810
A draggable one-press stop button for the DeepSeek Harness Web GUI. / DSH 一键结束服务按钮。
★ 0
MIT
JavaScript
Sep 23, 2026
dsh plugin --profile web add dsh-power-buttonby kkaktus463
Opens the DeepSeek Harness Web UI in a native window instead of a browser tab.
★ 0
MIT
JavaScript
Aug 23, 2026
dsh plugin --profile web add dsh-plugin-desktopby 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),
★ 2
↓ 40/wk
JavaScript
Aug 16, 2026
dsh plugin --profile web add dsh-power-buttonby Yingmoon0715
Drive the built-in browser inside the DSH right sidebar: open, navigate, read, click, fill, close.
★ 0
JavaScript
Oct 24, 2026
dsh plugin --profile web add rightbar-driver