DeepSeek Harness 插件

dsh-web-watchdog

Watchdog for the dsh web GUI: crash logging + exponential-backoff auto-restart supervisor + status panel(英文原文)

跳到安装方式

来源信息

GitHub 仓库
catsenior507/dsh-web-watchdog
最近更新
2026年8月16日
分类
插件开发工具
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/catsenior507/dsh-web-watchdog
插件名:dsh-web-watchdog
作者:catsenior507

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

🛡 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