dsh-app-controls
Manifest validDeepSeek Harness Web GUI toolbar + KDE tray + plugin settings: tray toggle, per-feature visibility, remembered default window size, check/update DSH, quit/restart.
dsh-app-controls
Adds two controls to the DeepSeek Harness (DSH) Web GUI: quit the local dsh web service and check / update DSH. The update flow installs a newer version through a staging copy and an atomic swap, shows a progress dialog, then exits the service and closes the window.
Plugin information
| Field | Value |
|---|---|
| Name | dsh-app-controls (DeepSeek Harness app controls) |
| Version | 0.4.0 |
| Author | Tianrun Gu (@MiraculousGu) |
| Environment | DeepSeek Harness 0.2.2-rc.x Web profile (currently 0.2.2-rc.3); Linux + KDE desktop, Chrome --app window; Node.js 20+ |
| Features | ① Check and update DSH: confirm, download/install in the background, progress dialog with phase / percent / elapsed time / npm activity, atomic swap, exit and close the window. ② Quit DSH: confirm, gracefully stop the whole local dsh web service, and close the window. ③ KDE system tray (tray/dsh-tray.py): status, open, check/update, restart, stop, logs, copy URL and notifications. ④ Plugin settings: tray on/off, per-feature visibility and a remembered default window size. |
| Repository | https://github.com/MiraculousGu/dsh-app-controls |
| License | MIT |
Where the buttons appear
- While a conversation is open: the right side of the conversation title bar.
- Main interface / Plugins page / other pages: a floating control at the top-right of the window (just left of the right-sidebar toggle).
- Only one entry point is shown at a time — the two placements never duplicate each other.
Features
Check and update DeepSeek Harness
- Queries the npm registry and determines the newest version allowed by the running installation (this install tracks
^0.2.2-rc.1, which currently resolves to0.2.2-rc.3). - Shows the current → new version in a dialog; after confirmation a progress dialog appears with phase, percentage, elapsed time and the latest npm activity line.
- Installs the new version into a staging copy of the installation root, verifies the version, then atomically swaps it in. The live files stay untouched until that final swap.
- On success the service exits and the window closes; relaunch with the desktop shortcut to run the new version.
The install-phase percentage is estimated from the previous successful update duration (npm exposes no fine-grained progress). The phase, elapsed time and npm log line are real.
Quit DeepSeek Harness
After a confirmation dialog it calls DSH's appExit(0) to gracefully shut down the whole local service (HTTP/WebSocket, session flush, child processes), then closes the window automatically. In a normal browser tab (where scripts cannot close the tab) the screen shows a manual-close hint instead.
KDE system tray (tray/dsh-tray.py)
A PyQt5 tray helper shows the service in the KDE panel and controls it without opening the Web GUI:
- Tooltip: state, installed version, address, uptime, update availability and update progress.
- Left click: open/focus the Web GUI (starts the service if needed).
- Right-click menu: Open, Open Plugins, Plugin settings, Check for updates / Update to vX, Restart service, Stop service (the open page closes its window itself), Open logs, Copy URL, Quit tray.
- Notifications: update available/completed, service stopped, start failure.
- The helper talks to the host over
~/.local/state/dsh-app-controls/control.sock(mode 0600); no browser token or cookie is stored in it.
Prerequisites: Python 3 + PyQt5 (python3-pyqt5 on Arch/CachyOS) and a KDE
Plasma session (xembedsniproxy is part of the default Plasma 6 session).
Start it with python3 tray/dsh-tray.py, diagnose with
python3 tray/dsh-tray.py --check, and enable autostart from the tray menu.
Plugin settings
Open Plugins → DeepSeek Harness 应用控制 and use the settings section at the bottom (the tray menu's Plugin settings opens it too):
- System tray icon — enables/disables the tray helper and its login autostart.
- Button visibility — check/update button, quit button, conversation-header entry and main-interface top-right entry.
- Default window size — width/height, Remember current size and Use automatic size. Applied the next time a window opens.
Settings live in ~/.local/state/dsh-app-controls/settings.json and are shared by the host, tray and launcher. Tray enable/disable and the window size are applied on the next DSH start/window launch; button visibility changes immediately. The launcher uses a dedicated Chrome profile (~/.local/share/dsh-web-chrome) so the saved --window-size is reliably applied; DSH authentication is still seeded by the launch token.
Install
# From a local directory (link: install)
dsh plugin --profile web add /path/to/dsh-app-controls
# Or from GitHub (git spec, when supported)
dsh plugin --profile web add github:MiraculousGu/dsh-app-controls
Restart dsh web once after installing (or wait for HMR recomposition and refresh the page). Uninstall with:
dsh plugin --profile web remove dsh-app-controls
Security and limitations
- The buttons call exact routes below
/api; they inherit DSH's Host/Origin fence, signed browser cookie and owner-peer checks. Unauthenticated requests receive 401. - Quit and update are refused when the deployment accepts non-loopback authorities (
trustedHosts/ remote access). - Quitting or updating interrupts every open session and any in-flight agent turn; persisted session history is kept.
- The update targets the installation root of the running process. This project's desktop launcher uses the stable directory
~/.local/share/dsh-runtime, so updates are not reverted by npx'slatest-tag resolution. - The main-interface overlay is hidden automatically whenever the conversation-header controls are mounted (CSS
:has()).
Development and tests
No build step: the client half is a hand-written lazy-CJS bundle.
node test/mock.test.mjs
Logs: ~/.local/state/dsh-app-controls/app-controls.log.
License
MIT © 2026 Tianrun Gu. See LICENSE.
Language / 语言: English · 中文
中文说明
为 DeepSeek Harness(DSH)Web 界面增加两个控制:「退出本地 dsh web 服务」和「检查并更新 DSH」。更新通过副本安装 + 原子切换完成,带进度弹窗,完成后退出服务并自动关窗。
插件信息
| 项目 | 内容 |
|---|---|
| 名称 | dsh-app-controls(DeepSeek Harness 应用控制) |
| 版本 | 0.4.0 |
| 作者 | Tianrun Gu(@MiraculousGu) |
| 适用环境 | DeepSeek Harness 0.2.2-rc.x 的 Web profile(当前 0.2.2-rc.3);Linux + KDE 桌面、Chrome --app 应用窗口;Node.js 20+ |
| 功能 | ① 检查并更新 DSH:确认后后台下载安装,进度弹窗显示阶段 / 百分比 / 已用时 / npm 活动日志,完成后原子切换、退出服务并自动关窗。② 退出 DSH:确认后优雅结束整个本地 dsh web 服务并自动关窗。③ KDE 系统托盘(tray/dsh-tray.py):状态、打开、检查/更新、重启、停止、日志、复制地址与通知。④ 插件设置:托盘开关、各功能显示/隐藏,以及可记住的默认启动窗口大小。 |
| 仓库 | https://github.com/MiraculousGu/dsh-app-controls |
| 许可证 | MIT |
按钮位置
- 对话打开时:对话标题栏右侧的工具区。
- 主界面 / 插件页等其他页面:窗口右上角的悬浮控件(位于右侧边栏开关左侧)。
- 同一时间只显示一处,不会重复出现。
功能
检查并更新 DeepSeek Harness
- 查询 npm registry,确定当前安装允许更新的最新版本(本安装跟踪
^0.2.2-rc.1,当前解析为0.2.2-rc.3)。 - 弹窗显示当前版本 → 新版本;确认后进入进度弹窗(阶段、百分比、已用时、npm 活动日志)。
- 把新版本安装到安装根目录的副本中,校验版本后原子切换;切换前运行中的文件不受影响。
- 成功后自动退出服务并关闭窗口,用桌面快捷方式重新启动即为新版本。
安装阶段的百分比按上一次成功更新的耗时估算(npm 不提供细粒度进度);阶段、耗时与 npm 日志是真实信息。
退出 DeepSeek Harness
确认后调用 DSH 的 appExit(0) 优雅结束整个本地服务(关闭 HTTP/WebSocket、落盘会话、终止子进程),随后自动关闭窗口。若窗口是普通浏览器标签页(脚本不允许关闭),会显示手动关闭提示。
KDE 系统托盘(tray/dsh-tray.py)
一个 PyQt5 托盘 helper,在 KDE 面板里显示服务状态并直接控制,不需要打开网页:
- Tooltip:状态、版本、地址、运行时长、可更新版本与更新进度;
- 左键:打开/聚焦 Web 界面(服务未运行时先启动);
- 右键菜单:打开、打开插件管理、插件设置、检查更新 / 更新到 vX、重启服务、停止服务(打开中的页面会自行关闭窗口)、打开日志、复制访问地址、退出托盘;
- 通知:更新可用/完成、服务停止、启动失败;
- 托盘通过
~/.local/state/dsh-app-controls/control.sock(权限 0600)与宿主通信,不保存浏览器 token/cookie。
前置条件:Python 3 + PyQt5(Arch/CachyOS 上是 python3-pyqt5)、KDE Plasma 会话(xembedsniproxy 属于默认 Plasma 6 会话)。启动:python3 tray/dsh-tray.py;诊断:python3 tray/dsh-tray.py --check;开机自启可在托盘菜单里切换。
插件设置
打开 插件 → DeepSeek Harness 应用控制,使用详情底部的设置区(托盘菜单的 插件设置 也会打开这里):
- 系统托盘图标:启用/停用托盘 helper 及登录自启;
- 按钮显示:检查更新按钮、退出按钮、对话标题栏入口、主界面右上角入口;
- 默认启动窗口大小:宽度/高度、记住当前窗口大小、恢复自动;下次打开窗口时生效。
设置保存在 ~/.local/state/dsh-app-controls/settings.json,由宿主、托盘和启动器共享。托盘开关与窗口大小在下次启动 DSH / 打开窗口时生效,按钮显示/隐藏立即生效。启动器使用独立的 Chrome 配置目录(~/.local/share/dsh-web-chrome),确保保存的 --window-size 可靠生效;DSH 鉴权仍通过启动令牌完成。
安装
# 本地目录安装(link: 方式)
dsh plugin --profile web add /path/to/dsh-app-controls
# 或从 GitHub 安装(支持 git spec 时)
dsh plugin --profile web add github:MiraculousGu/dsh-app-controls
安装后重启一次 dsh web(或等待 HMR 重组并刷新页面)。卸载:
dsh plugin --profile web remove dsh-app-controls
安全与限制
- 按钮对应的路由位于
/api下,继承 DSH 的 Host/Origin 防护、签名 cookie 与 owner 校验;未认证请求返回 401。 - 当部署允许非本机 authority(
trustedHosts/ 远程访问)时,退出与更新会被拒绝。 - 退出或更新会中断所有会话与正在生成的回合;会话历史已持久化。
- 更新目标为当前进程所在的安装根目录。本项目的桌面启动器使用稳定目录
~/.local/share/dsh-runtime,因此不会被 npx 的latest标签校验回退。 - 当会话标题栏控件挂载时,主界面右上角的悬浮控件会通过 CSS
:has()自动隐藏。
开发与测试
无构建步骤:客户端半为手写 lazy-CJS bundle。
node test/mock.test.mjs
日志:~/.local/state/dsh-app-controls/app-controls.log。
许可证
MIT © 2026 Tianrun Gu,详见 LICENSE。
Comments
Loading…
Similar plugins
by xiaokang6
DeepSeek Harness Web GUI admin plugin: manual restart + auto version check (header button + settings page)
★ 0
MIT
JavaScript
Aug 18, 2026
dsh plugin --profile web add dsh-adminby cheng-wj
DSH plugin: restart / update / inspect the DeepSeek Harness desktop app from the model side (Windows)
★ 0
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-app-controlby zizhongfeiyang
A DeepSeek Harness web UI plugin for customizing and managing the settings navigation drawer. DeepSeek Harness 设置抽屉插件,用于自定义和管理设置页左侧导航栏,可隐藏/显示各设置栏目,修改即时生效。
★ 3
MIT
JavaScript
Sep 30, 2026
dsh plugin --profile web add dsh-settings-drawerby 13520rygvv
DSH desktop plugin: a one-click restart button in Settings, plus a customizable shortcut.
★ 1
JavaScript
Oct 27, 2026
dsh plugin --profile web add @local/dsh-restart-buttonWindows system-tray launcher for DeepSeek Harness Web: start, stop, restart, open the Web UI, tail logs, live status icon, and a launch-at-login toggle.
★ 0
dsh plugin --profile web add dsh-trayby kvker
DeepSeek Harness plugin: remember the desktop window position and size across launches.
★ 0
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-window-state