前言¶
在 DSH 的 Web GUI 裏，有時需要在頁面中直接查看當前主機的資源狀態，而不必切換到終端。dsh-top 是一個面向 dsh web GUI 的監控插件：它把 CPU、內存、磁盤、網絡和 Top 進程信息放進一個浮動面板裏，方便在網頁內查看。下面介紹它的功能、安裝方式和需要注意的點。
這是什麼¶
glenngit/dsh-top 是一個 MIT 許可的 DSH 客戶端插件。它爲 dsh 的 web GUI 提供系統監控面板，即時顯示 CPU、RAM、磁盤、網絡與 Top 6 進程。
核心功能¶
下面列出的能力都對應面板中可見的信息：
- 浮動、可摺疊、可拖拽的面板，固定在右上角
- 即時 CPU 使用率與核心數
- 內存已用/總量與百分比條
- 磁盤已用/總量與百分比條
- 網絡下載/上傳吞吐量
- Top 6 進程：PID、名稱、CPU%、MEM%
- 深色配色與等寬字體
- 過濾瞬態監控進程
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add dsh-top
安裝後重啓 web 應用並刷新頁面，面板會出現在右上角。
典型用法¶
安裝並啓用後，可以做這些操作：
- 通過標題欄拖動面板
- 通過
–/+按鈕摺疊或展開面板 - 如需運行測試，執行：
npm test
適用場景與注意¶
適合在 DSH web GUI 中使用、需要快速查看主機資源的人。使用前需要注意：
- 插件以當前
dsh進程的運行權限讀取主機狀態，安裝前應先檢查源碼和許可證（MIT）。 - 作爲系統監控，它會讀取主機 CPU、內存、磁盤、網絡與進程狀態。
- CPU 與內存使用 Node
os模塊且無子進程；磁盤、網絡、進程依賴平臺採集器，不可用時顯示n/a。 - 外部採集命令通過
execFileSync使用靜態 argv 數組，不使用 shell 字符串；所有讀取爲只讀，不讀取憑據，不將數據離開主機。 - 每個外部採集器有 5 秒超時，失敗時該部分降級爲
n/a。 - Windows 進程 CPU 爲生命週期平均百分比，MEM% 來自真實 RSS 字節。
dsh.so靜態掃描將node:child_process標記爲 critical，屬於進程訪問存在的啓發式信號，而非漏洞。
結尾¶
經過上面的步驟，dsh-top 可以把常用系統指標放進 DSH web GUI 的右上角面板中。GitHub 倉庫：
DSH 社區目錄爲獨立站點，可檢索 dsh-top 條目（本次資料未提供具體目錄頁 URL）。
