MiraculousGarfield/dsh-ops-health1

dsh-ops-health

One-click health check for a dsh deployment: a sidebar button runs the ops kit's check-health.ps1 (hidden PowerShell) through a plain HTTP route and renders a structured report. The route is independent of the tool registry, so the button still works when agent tool calls break.

AI Analysis

核心用途是提供不依赖 Agent 工具注册表的独立系统体检。适合 Windows 平台下的运维人员,在 Agent 崩溃时仍能排查进程故障。

Package
dsh-ops-health
Version
0.1.0
Last updated
Aug 15, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:MiraculousGarfield/dsh-ops-health

dsh-ops-health

DeepSeek Harness 一键健康检查插件:侧边栏「🩺 健康检查」按钮 → 纯 HTTP 路由 /ops/health → 隐藏窗口跑 check-health.ps1(8 项体检)→ 结构化报告卡片。

  • 按钮配色跟随主题(--dsw-alias-brand-primary,皮肤覆盖时跟随皮肤)
  • 路由直接注册在 webServer 上,不经过工具注册表:agent 工具调用崩了按钮仍可用; 进程级故障时按钮同样不可用,兜底仍是独立脚本(见 dsh-ops 工具箱)
  • 体检逻辑是 PowerShell,仅支持 Windows;其他平台按钮会显示"通道不可用"提示

安装

dsh plugin --profile web add github:MiraculousGarfield/dsh-ops-health
# 重启 dsh 服务(bundles 是启动期组合的),刷新页面即可看到按钮

卸载

dsh plugin --profile web remove dsh-ops-health
# 重启 dsh 服务生效

结构

文件说明
lib/index.jshost 面:注册 /ops/health 路由,spawn PowerShell(隐藏窗口、60s 超时)
lib/client.js浏览器面:侧边栏按钮(流内插入设置区上方)+ 报告卡片,可逆清理
scripts/check-health.ps1体检脚本副本(自包含;源在 dsh-ops 仓库根 scripts/
cordis.patch.ymlbundle patch:一行 insert 挂载插件行

注意

  • 官方 dsh plugin add 在 Windows 下路径含空格会炸(cmd 按空格拆参数): 用 git URL 无此问题;本地路径安装需用 8.3 短路径(形如 C:\Users\SHORTNA~1\...
  • 卸载后 node_modules 可能留死目录(pnpm 惰性清理),不影响运行

MIT License