DeepSeek Harness plugin

dsh-web-watchdog

Watchdog for the dsh web GUI: crash logging + exponential-backoff auto-restart supervisor + status panel

Jump to install

Source facts

Repository
catsenior507/dsh-web-watchdog
Latest update
Aug 16, 2026
Category
Development & Runtime
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/catsenior507/dsh-web-watchdog
Plugin: dsh-web-watchdog
Author: catsenior507

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

🛡 dsh-web-watchdog

DeepSeek Harness Web GUI 的看护插件: 崩溃记录 + 指数退避自动重启 + 状态面板。

dsh web(dsh web,默认 http://127.0.0.1:3080)在 Windows 上偶发崩溃 (Node 24 libuv 退出断言、原生 TS 类型剥离等)。本插件在宿主进程内托管一个 脱离进程的 PowerShell 监督进程

  • 📜 崩溃记录:宿主异常退出(退出码 != 0)时,把退出码、宿主 stderr/stdout

末尾、Windows 事件日志追加到 crash.log

  • 🔁 自动重启:按指数退避(默认 10s 起、上限 600s、连续最多 10 次)自动拉起

node --no-warnings <bin> web;宿主正常退出(exit 0)不重启;

  • 计划重启:面板按钮或 POST /api/watchdog/restart 写请求标记,监督进程

在 2 秒内完成「停旧进程 → 拉新进程」;

  • 🤝 监督进程交接:重启后新宿主会拉起自己的监督进程,旧监督进程检测到

pid 文件被接管后自动退出,避免双重监督。

安装

npm install
npm run build
dsh plugin --profile web add link:<本目录绝对路径>
# 重启 dsh web 后生效;右下角出现 🛡 按钮

面板 / API

端点说明
GET /api/watchdog/status宿主 PID、监督进程状态、配置、崩溃记录尾部
GET /api/watchdog/log?lines=60崩溃日志尾部
POST /api/watchdog/restart计划重启(浏览器会短暂断线,监督进程自动拉起)
GET /api/health插件健康检查
curl http://127.0.0.1:4795/api/watchdog/status
curl -X POST http://127.0.0.1:4795/api/watchdog/restart

配置

首次运行在数据目录(默认 %USERPROFILE%\.dsh\web-watchdog,可用环境变量 DSH_WATCHDOG_DATA / DSH_WATCHDOG_PORT 覆盖)生成 config.json

  • supervisor.nodePath / binPath / restartArgs:重启命令(自动探测,可覆盖);
  • supervisor.maxRestarts / backoffStartSec / backoffMaxSec:重启策略;
  • 崩溃记录:<数据目录>/crash.log,宿主日志:<数据目录>/web-logs/

开发 / 自测

  • npm run build —— tsdown 产出 host half(lib/index.js)与 browser half(lib/client.js);
  • node test-isolated.mjs —— 隔离端到端测试:监督进程拉起、崩溃记录、自动重启、

计划重启、监督交接(不接触真实 dsh web 进程)。

  • node test-deployment.mjs —— 真实部署形态端到端测试:假宿主通过插件的 WMI 机制拉起监督进程,

再用 Stop-Process -Force 硬杀宿主,验证监督进程独立存活、恢复宿主环境、写崩溃记录并自动拉起新宿主。

License

MIT