在 DSH 环境中运行任务时，需要实时掌握 CPU、GPU、内存和磁盘的负载情况。传统的任务管理器仅展示瞬时占用，难以定位资源占用主体、预估负载持续时长或预判资源耗尽时间。本插件在 DSH 侧栏提供一个实时监控面板，将硬件状态集中展示，并支持下钻到具体应用、容量预测与阈值告警。
插件信息¶
- 名称：
weihaobin0818-lgtm/dsh-system-monitor - 类型：客户端
- 维护者：weihaobin0818-lgtm
- 许可证：MIT
- 核心价值：DSH 侧栏实时硬件监控，支持下钻分析、容量预测与数据导出。
核心功能¶
插件提供以下功能：
- 实时监控与可视化：支持 CPU、GPU、内存、磁盘状态。提供环形仪表、趋势图、热力图，每秒自动刷新，支持舒适与紧凑两种密度。
- 按应用归因：点击环形仪表下钻，显示应用图标及资源占用明细，可展开到单个进程。
- 预测功能：基于斜率预测磁盘写满时间和内存耗尽时间。
- 阈值告警：支持持续检测，避免瞬时抖动导致的误报。
- 数据导出：支持 CSV、JSON、NDJSON 三种格式导出。
- 历史记录：NDJSON 滚动落盘，默认保留 7 天，上限一年。
- 自定义时间范围：预设 1/5/30 分钟，也可输入任意分钟数（最多 3 小时）。
安装与启用¶
安装插件需要使用官方安装命令：
dsh plugin install dsh-system-monitor
安装后，需要启动带 Web 界面的 profile 以启用侧栏功能：
dsh web
典型用法¶
- 查看概览：侧栏会显示实时仪表盘，包含 CPU、GPU、内存和磁盘的状态。
- 下钻分析：点击任意环形仪表，查看具体应用和进程的资源占用情况。
- 监控时间：使用预设的 1、5、30 分钟时间范围进行监控。
- 导出数据：支持导出监控数据为 CSV、JSON 或 NDJSON 格式。
适用场景与注意¶
平台限制¶
完整功能仅支持 Windows 10 / 11。
在 Linux 和 macOS 上仍可安装运行，但会降级为 Node 原生读数：仅能读取 CPU、内存和根卷。GPU、按进程归因、图标、磁盘吞吐等功能不可用，对应面板会被隐藏。
权限与安全¶
- 权限：不需要管理员权限，全部读取当前用户会话数据。
- 安全模型：绑定到 127.0.0.1，未认证，仅适用于单用户机器。
- 依赖：纯 Node 实现，零运行时依赖；Node 版本要求 20 或更高（Harness 运行时已满足）。
其他注意事项¶
- 协议版本不匹配时需重启 DSH。
- 导出功能支持 CSV、JSON 和 NDJSON 三种格式。
总结¶
该插件通过侧栏集成解决了在 DSH 中实时监控硬件负载与定位应用资源占用的需求。安装并启动 Web 界面后，即可在侧栏查看实时仪表盘并进行下钻分析。使用前请确认在 Windows 环境下运行以获得完整功能，并注意其单用户、本地绑定的安全模型。
