在 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 環境下運行以獲得完整功能，並注意其單用戶、本地綁定的安全模型。
