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:

• glenngit/dsh-top

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).