wiyi/dsh-web-service-manager

dsh-web-service-manager

在 DeepSeek Harness 内部管理 dsh web 服务 —— 日常操作无需再开终端。Manage the dsh web service from inside DeepSeek Harness — no terminal needed for day-to-day operations.

MIT License
dsh-plugin
DSH 插件市场

中文

功能

- 状态面板(设置 → DSH Web 服务):运行状态、版本、端口、PID、会话运行时长。
- 重启:先把替换实例放进独立进程会话,再退役当前进程 —— 新服务不受旧进程优雅清理(SIGTERM → 根 fiber dispose)的影响。
- 停止:终止当前服务(面板所在的 GUI 会随之关闭)。
- 版本检查:与 npm registry 对比当前运行版本。
- 一键更新:发现新版本后,通过 npx 拉取最新 @deepseek-ai/dsh 并自动重启。

安装

从 GitHub 直接安装:
dsh plugin --profile web add github:wiyi/dsh-web-service-manager

发布 npm 后也可以:
dsh plugin --profile web add dsh-web-service-manager

重启一次 web 服务,然后打开 设置 → DSH Web 服务。

工作原理

宿主半提供 GET /dsh-web-manager/status、GET /dsh-web-manager/check、POST /dsh-web-manager/restart、POST /dsh-web-manager/update、POST /dsh-web-manager/stop;写操作要求同源请求。

重启与更新使用小型看门狗链:替换实例以独立进程会话(detached: true)启动,先于旧进程退役。因为 SIGTERM 会让 harness 销毁整个组合 —— 包括所有托管子进程;只有脱离进程组的替换实例能在这场清理中存活下来。

注意事项

- 停止会关掉你正在使用的 GUI;重新启动需在终端运行 npx @deepseek-ai/dsh web。
- 重启/更新后,等新实例接管端口,再手动刷新页面。
- 安装插件意味着以你的权限运行第三方代码。本插件会停止、启动和更新 web 服务进程,在重要环境安装前请阅读源码。

English

Features

- Status panel (Settings → DSH Web 服务): running state, version, port, PID, session uptime.
- Restart: detaches a replacement instance into its own process session before retiring the current one, so the new server survives the old process's graceful teardown.
- Stop: terminates the current service (this also closes the GUI the panel lives in).
- Version check: compares the running version with the npm registry.
- Update & restart: pulls the latest @deepseek-ai/dsh through npx and restarts on it.

Install

Directly from this repo:
dsh plugin --profile web add github:wiyi/dsh-web-service-manager

Or, once published to npm:
dsh plugin --profile web add dsh-web-service-manager

Restart the web service once, then open Settings → DSH Web 服务.

How it works

The host half serves GET /dsh-web-manager/status, GET /dsh-web-manager/check, POST /dsh-web-manager/restart, POST /dsh-web-manager/update, and POST /dsh-web-manager/stop. Mutating routes require a same-origin request.

Restart and update use a small watchdog chain: the replacement instance is spawned in its own process session (detached: true) before the current process is retired — on SIGTERM the harness disposes its whole composition, including every managed child process, and a detached replacement is the only child that survives that cleanup.

Notes
- 停止会结束你正在使用的 GUI；请从终端使用 npx @deepseek-ai/dsh web 再次启动它。
- 在重启或更新后，等新实例接管端口后刷新页面。
- 安装插件会以你自己的权限运行第三方代码。此插件会停止、启动和更新 Web 服务进程；在将其安装到任何重要位置之前，请先阅读源代码。

许可证

MIT