前言¶
在 DSH 的 Web GUI 里，有时需要在页面中直接查看当前主机的资源状态，而不必切换到终端。dsh-top 是一个面向 dsh web GUI 的监控插件：它把 CPU、内存、磁盘、网络和 Top 进程信息放进一个浮动面板里，方便在网页内查看。下面介绍它的功能、安装方式和需要注意的点。
这是什么¶
glenngit/dsh-top 是一个 MIT 许可的 DSH 客户端插件。它为 dsh 的 web GUI 提供系统监控面板，实时显示 CPU、RAM、磁盘、网络与 Top 6 进程。
核心功能¶
下面列出的能力都对应面板中可见的信息：
- 浮动、可折叠、可拖拽的面板，固定在右上角
- 实时 CPU 使用率与核心数
- 内存已用/总量与百分比条
- 磁盘已用/总量与百分比条
- 网络下载/上传吞吐量
- Top 6 进程：PID、名称、CPU%、MEM%
- 深色配色与等宽字体
- 过滤瞬态监控进程
安装与启用¶
先安装插件：
dsh plugin --profile web add dsh-top
安装后重启 web 应用并刷新页面，面板会出现在右上角。
典型用法¶
安装并启用后，可以做这些操作：
- 通过标题栏拖动面板
- 通过
–/+按钮折叠或展开面板 - 如需运行测试，执行：
npm test
适用场景与注意¶
适合在 DSH web GUI 中使用、需要快速查看主机资源的人。使用前需要注意：
- 插件以当前
dsh进程的运行权限读取主机状态，安装前应先检查源码和许可证（MIT）。 - 作为系统监控，它会读取主机 CPU、内存、磁盘、网络与进程状态。
- CPU 与内存使用 Node
os模块且无子进程；磁盘、网络、进程依赖平台采集器，不可用时显示n/a。 - 外部采集命令通过
execFileSync使用静态 argv 数组，不使用 shell 字符串；所有读取为只读，不读取凭据，不将数据离开主机。 - 每个外部采集器有 5 秒超时，失败时该部分降级为
n/a。 - Windows 进程 CPU 为生命周期平均百分比，MEM% 来自真实 RSS 字节。
dsh.so静态扫描将node:child_process标记为 critical，属于进程访问存在的启发式信号，而非漏洞。
结尾¶
经过上面的步骤，dsh-top 可以把常用系统指标放进 DSH web GUI 的右上角面板中。GitHub 仓库：
DSH 社区目录为独立站点，可检索 dsh-top 条目（本次资料未提供具体目录页 URL）。
