前言¶
跑 DeepSeek Harness（DSH）時，本機變慢往往要另開終端：htop、Activity Monitor、任務管理器，或 ncdu 查磁盤。對住在瀏覽器裏的工作流來說，這意味着頻繁切上下文。dsh-server-resources 在 DSH 右側欄增加 Resources 頁籤，用只讀方式彙總 CPU、RAM、swap、磁盤佔用，以及進程、目錄、文件的排行，面向 Linux、macOS、Windows，不額外安裝監控服務。下面介紹它的定位、能力、安裝方式與使用注意。
這是什麼¶
維護者爲 brungcm。插件全名 dsh-server-resources，npm 包名與此相同，當前發佈版本爲 0.3.0（MIT 許可證，零 npm 依賴）。它歸類爲 DSH 客戶端插件：界面在 Web 側欄展示，數據來自運行 DSH 的那臺主機上的系統命令與內核接口。
一句話定位：在 DSH 裏回答「是 CPU、內存、swap 還是磁盤」「哪個程序在喫資源」「磁盤被誰佔滿」，無需 SSH 或系統自帶圖形監控。
核心功能¶
面板與操作系統能力對齊：某 OS 無法提供的指標會隱藏，而不是填零。三大平臺共有的能力包括：
- 儀表盤：CPU、RAM、swap / 頁面文件、最滿磁盤，綠→琥珀→紅指示。
- 歷史曲線：近幾分鐘 CPU、RAM。
- Per-core 條形圖：便於發現單核打滿而平均值仍偏低的情況。
- 進程排行：CPU、RAM 消耗前列；可按程序聚合（如
claude ×4）或按 PID、用戶、命令行列出。 - 磁盤頁：各卷、最大目錄（可點進下鑽）、較大文件（約 20 MB～1 GB）。
- 主題：跟隨 DSH 明暗主題。
平臺差異（摘自官方功能表）：
| 能力 | Linux | macOS | Windows |
|---|---|---|---|
| 進程 swap 排行 | ✅ | — | ✅（committed memory） |
| I/O wait · steal · page cache | ✅ | 僅 cache | — |
| Pressure (PSI) | ✅ | — | — |
Linux 側依賴 /proc、df、du、find 等常見工具；macOS 用 sysctl、vm_stat、ps 等；Windows 通過 PowerShell（優先 pwsh 7+）調用 Get-CimInstance。各平臺具體命令見倉庫內 docs/PLATFORMS.md。
安裝與啓用¶
依賴 dsh-better-sidebar ≥ 0.30（面板渲染在其側欄內）以及 Node.js ≥ 20。
任選一種安裝方式：
# 從 npm
dsh plugin --profile <your-profile> add dsh-server-resources
# 或從 GitHub
dsh plugin --profile <your-profile> add github:brungcm/dsh-server-resources
安裝完成後，打開右側欄的 + 菜單，選擇 Resources 即可出現資源頁。
典型用法¶
- 日常在 DSH 中開發或運維時，保持 Resources 頁籤打開，觀察儀表盤與近幾分鐘歷史，判斷瓶頸在 CPU 還是內存。
- 切換到 Processes，按 CPU 或 RAM 排序，確認是單個 PID 還是同一程序的多個實例。
- 磁盤告急時進入 Disk，查看各卷佔用，點進大目錄下鑽，對照大文件列表清理（插件本身只讀，不會刪除或改配置）。
- Linux 上若關心調度 stall，可查看 PSI 相關指標（內核支持時）。
路由經 DSH 連接層提供，僅登錄所有者可達；請勿在未鑑權的情況下把 DSH 暴露到公網。
設計與安全邊界¶
官方強調的設計原則包括：
- 只讀：不殺進程、不刪文件、不改設置；無額外網絡依賴。
- 對機器溫和：磁盤掃描低優先級、串行執行，單次最長約 150 s，帶緩存與隊列上限；概覽採樣頻率受限；標籤頁隱藏時停止輪詢。
- 路徑防護：Linux/macOS 不掃描
/proc、/sys等；Windows 僅接受盤符路徑，拒絕 UNC 等；遍歷不跟符號鏈接。
命令行可見性：Processes 會顯示命令行，參數裏可能含密鑰；常見形態會打碼，但不保證全部。若需完全隱藏，在 DSH 服務端環境中設置：
export DSR_HIDE_COMMAND_LINES=1
內容與本地 ps、任務管理器等同級敏感，請按最小權限運行 DSH。
限制與適用場景¶
- 數字描述的是 運行 DSH 進程的那臺主機；容器 cgroup 限額不在面板內。
- macOS 單進程 CPU 爲系統自己的衰減平均，突發可能滯後；無 per-process swap。
- Windows 單次採樣約 1～2 s，刷新間隔比 Linux/macOS 更長；殺軟可能對重複的
powershell -EncodedCommand告警。
適合：在本機或內網已部署 DSH、希望少切工具就能確認資源佔用的開發者與運維。安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認與自身安全策略一致；插件以 DSH 進程權限讀取系統信息。
社區目錄 skillhub.cn 上的條目 與 GitHub 同源，屬於 DSH「一切皆插件」生態中的第三方收錄，並非 DeepSeek 或幻方官方應用商店。
小結¶
dsh-server-resources 把本機資源觀測收進 DSH 側欄：Resources 頁籤、跨 Linux / macOS / Windows、只讀且無 npm 運行時依賴。裝好 dsh-better-sidebar 與插件後，從側欄 + 啓用即可。進一步細節見 https://github.com/brungcm/dsh-server-resources。
