Introduction

In the DSH Web GUI, there are times when you need to view the current host’s resource status directly on the page without switching to the terminal. dsh-top is a monitoring plugin for the dsh web GUI: it puts CPU, memory, disk, network, and Top process information into a floating panel, making it easy to view within the web page. Below are its features, installation methods, and points to note.

What is it

glenngit/dsh-top is an MIT-licensed DSH client plugin. It provides a system monitoring panel for the dsh web GUI, displaying real-time CPU, RAM, disk, network, and Top 6 processes.

Core Features

The capabilities listed below correspond to the information visible in the panel:

  • Floating, collapsible, draggable panel, fixed to the top-right corner
  • Real-time CPU usage and core count
  • Memory used/total and percentage bar
  • Disk used/total and percentage bar
  • Network download/upload throughput
  • Top 6 processes: PID, name, CPU%, MEM%
  • Dark theme and monospaced font
  • Filter transient monitoring processes

Installation and Enabling

First, install the plugin:

dsh plugin --profile web add dsh-top

After installation, restart the web application and refresh the page; the panel will appear in the top-right corner.

Typical Usage

After installation and enabling, you can perform the following operations:

  • Drag the panel via the title bar
  • Collapse or expand the panel via the - / + buttons
  • If you need to run tests, execute:
npm test

Use Cases and Notes

Suitable for users who need to quickly check host resources within the DSH web GUI. Before using, please note:

  • The plugin reads host status with the running permissions of the current dsh process; you should check the source code and license (MIT) before installing.
  • As a system monitor, it reads the host’s CPU, memory, disk, network, and process status.
  • CPU and memory use the Node os module and do not involve child processes; disk, network, and processes rely on platform collectors and display n/a when unavailable.
  • External collection commands use execFileSync with a static argv array, without using shell strings; all reads are read-only, no credentials are read, and data does not leave the host.
  • Each external collector has a 5-second timeout; if it fails, that section falls back to n/a.
  • Windows process CPU is a lifetime average percentage; MEM% comes from real RSS bytes.
  • The dsh.so static scan marks node:child_process as critical. This is a heuristic signal of process access, not a vulnerability.

Conclusion

After the steps above, dsh-top can put common system metrics into the top-right panel of the DSH web GUI. GitHub repository:

The DSH community directory is a separate site where you can search for the dsh-top entry (the specific directory page URL is not provided for this material).