MiraculousGarfield/dsh-ops-health
One-click health check for the DSH Web GUI: a sidebar button runs the ops kit's check-health.ps1 through a plain HTTP route (independent of the tool registry) and renders a structured report card; colors follow the active theme, Windows/PowerShell.
Listed
2
Dev
Bundle verified
Preview
What it does
One-click health check for the DSH Web GUI: a sidebar button runs the ops kit's check-health.ps1 through a plain HTTP route (independent of the tool registry) and renders a structured report card; colors follow the active theme, Windows/PowerShell.
Best for
- Windows-based DSH Web GUI operators who want an accessible one-click health report.
- Troubleshooting workflows where the agent tool registry may be broken but the Web server still responds.
- Operators who want the existing PowerShell ops health checks rendered as a structured in-app report.
Not ideal for
- macOS or Linux installations; the PowerShell health-check implementation supports Windows only.
- Process-level DSH failures, because the Web button and its HTTP route are unavailable when the host process is down.
- Headless or non-Web deployments that cannot use the sidebar control and report card.
- Local-path installation on Windows when the path contains spaces, unless a short 8.3 path is used; Git URL installation avoids this issue.
README
dsh-ops-health
· Featured on the community-maintained Awesome DeepSeek Harness Plugin list
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.js |
host 面：注册 /ops/health 路由，spawn PowerShell（隐藏窗口、60s 超时） |
lib/client.js |
浏览器面：侧边栏按钮（流内插入设置区上方）+ 报告卡片，可逆清理 |
scripts/check-health.ps1 |
体检脚本副本（自包含；源在 dsh-ops 仓库根 scripts/） |
cordis.patch.yml |
bundle patch：一行 insert 挂载插件行 |
注意
- 官方
dsh plugin add在 Windows 下路径含空格会炸（cmd 按空格拆参数）： 用 git URL 无此问题；本地路径安装需用 8.3 短路径（形如C:\Users\SHORTNA~1\...） - 卸载后 node_modules 可能留死目录（pnpm 惰性清理），不影响运行
MIT License
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:MiraculousGarfield/dsh-ops-health in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.