# dsh-system-monitor-plugin
[](https://github.com/JularDepick/dsh-system-monitor-plugin/tree/v0.1.0)
[](./COPYRIGHT)
[](./LICENSE)
[English]
| [简体中文](./README.md)
A plugin for dsh: monitor the resource utilization of dsh system processes and report the results to the user in the form of charts.
## Features
- Automatic collection: CPU usage percentage and memory usage (GB and percentage) of the dsh process and its child processes
- Handle reporting: a reporting tool allows the Agent to report process handles (e.g. subagent processes) that the plugin cannot identify on its own
- Panel-only display: monitoring data is shown on the plugin UI panel only and is not exposed to dsh
## Installation
Install this plugin into a dsh profile:
```sh
dsh plugin --profile add dsh-system-monitor-plugin
```
When distributing a tarball:
```sh
dsh plugin --profile add dsh-system-monitor-plugin-0.1.0.tgz
```
## Usage
After installation and startup, the plugin provides a "System Monitor" tab in the session-area tab bar of the Web UI, showing CPU usage and memory usage (GB and percentage) of monitored processes. Process handles that need to be monitored are reported by the Agent through the reporting tool during a session.
The format specification of the process reporting mechanism is documented in [Process Reporting Mechanism and Specification](docs/v0.1.0-进程汇报机制与规范.md) (Chinese).
## Related Links
- Plugin template used by this repository: https://github.com/JularDepick/dsh-plugin-dev-agent-template
- dsh official repository: https://github.com/deepseek-ai/deepseek-harness