前言¶
在 DSH 里長時間跑智能體或本地任務時，任務欄或系統自帶的瞬時佔用率往往只能回答「此刻忙不忙」，很難回答「過去幾小時是不是一直頂在閾值上」「內存是不是長期接近打滿」「CPU 負載高時頻率是否被壓下去」。需要盯實時儀表盤，也容易漏掉間歇性但持續的問題。
下面介紹社區插件 dsh-resource-monitor（維護者 XiaoLuoMin，GitHub：XiaoLuoMin/dsh-resource-monitor）。它是 DeepSeek Harness（DSH）的客戶端側欄插件：每分鐘採樣一次本機資源，保留約 30 天曆史，用「連續超閾值多久」來歸納長期高佔用、內存喫緊和降頻，而不是隻展示需要一直盯着的實時儀表。
這是什麼¶
dsh-resource-monitor 在 DSH 側欄增加 tab「資源監控」，會話標題欄也有對應入口。Host 端負責採樣與持久化，Client 端負責圖表、結論與異常列表；數據落在用戶目錄下的 JSONL 文件中。插件面向 Windows 本機（頻率等指標依賴 Windows 性能計數器），在 community 目錄中歸類爲客戶端插件。
核心功能¶
界面與刷新¶
側欄打開「資源監控」後，面板自上而下大致爲：
- KPI 行：當前 CPU、當前內存（已用/總量 GB）、當前頻率。
- 結論框：所選時間區間的平均/峯值，以及超閾值累計分鐘、降頻分鐘等摘要。
- CPU 曲線（含 85% 告警參考線）。
- 內存曲線（含 90% 告警參考線）。
- 頻率曲線（含 70% 降頻參考線）。
- 異常列表（近 7 天事件）。
支持 24 小時 / 7 天 視圖切換，界面約 30 秒 自動刷新；快照由 Host 提供 API（README 中說明爲 POST /api/resource-monitor.snapshot）。
採樣與保留¶
| 項目 | 規則 |
|---|---|
| 採樣間隔 | 60 秒 |
| 歷史保留 | 30 天（samples.jsonl，追加寫入） |
| CPU 告警 | ≥ 85%，且連續 ≥ 10 分鐘 |
| 內存告警 | ≥ 90%，且連續 ≥ 10 分鐘 |
| 降頻告警 | CPU ≥ 50% 且頻率 ≤ 最高頻率的 70%，且連續 ≥ 5 分鐘 |
數據來源說明¶
- CPU / 內存：Node
os.cpus()時間差、os.totalmem()/os.freemem()。 - 頻率：Windows 性能計數器
\Processor Information(_Total)\% of Maximum Frequency。 - 磁盤讀寫、網絡速率仍會寫入歷史（分別來自
\PhysicalDisk(_Total)與Get-NetAdapterStatistics的採樣），但當前版本不再在側欄繪圖（1.1.1 變更：移除磁盤與網絡曲線）。
磁盤與網絡相關數值每次採樣會啓動一個 powershell.exe 子進程（約 2–4 秒，異步，不阻塞 UI）。
不採集溫度¶
Windows 上讀取 CPU 核心溫度通常需要內核驅動。本插件不附帶、也不加載驅動，改用「當前頻率相對最高頻率的比例」推斷降頻，README 說明該信號直接反映降頻事實，且不需要驅動或提權。
安裝與啓用¶
在已配置 DSH desktop profile 的環境中，按 README 安裝：
dsh plugin --profile desktop add github:XiaoLuoMin/dsh-resource-monitor
安裝完成後重啓 DSH 應用，以便 Host 與 Client 兩半都重新加載插件。
卸載：
dsh plugin --profile desktop remove dsh-resource-monitor
package.json 中當前版本爲 1.1.2，許可證 MIT；運行環境要求 Node ^22.19.0 || >=24.0.0，peer 依賴 @deepseek-ai/cordis ~4.0.4。
典型用法¶
- 按上一節命令安裝並重啓 DSH。
- 在側欄選擇「資源監控」，或在會話標題欄使用入口按鈕。
- 在 24h / 7d 之間切換，查看 KPI、結論框與三條資源曲線。
- 在異常列表中查看近 7 天內符合規則的 CPU 長時間高佔用、內存接近上限、負載下降頻等條目。
歷史數據文件位置：
%USERPROFILE%\.dsh\data\resource-monitor\samples.jsonl
每行一個 JSON 對象，對應一分鐘樣本；刪除該文件即可清空歷史。
適用場景與注意¶
適合：在 Windows 上用 DSH desktop 長時間開發或跑本地任務，希望從側欄回顧「是否曾長時間高 CPU / 高內存 / 降頻」，而不只依賴瞬時任務管理器數值。
注意：
- 插件以當前 DSH 進程權限運行，會週期性調用 Node 與 PowerShell 讀取本機性能數據；安裝前應閱讀 倉庫源碼 與 MIT 許可證，確認符合你的安全策略。
- 判定規則固定（如 CPU 85% 連續 10 分鐘），不能從 README 推斷存在額外配置文件項；若有需求應通過 Issue 或自行 fork。
- DSH 生態強調「一切皆插件」；社區目錄頁（skillhub.cn 條目）爲獨立站點展示，與 DeepSeek / 幻方無官方從屬關係，本文僅作插件能力說明。
結尾¶
dsh-resource-monitor 把「每分鐘一條、保留 30 天」的採樣與「連續超閾值」規則結合起來，在 DSH 側欄給出 CPU、內存、頻率的歷史視圖和近 7 天異常列表，適合需要事後覈對資源壓力而非只盯實時數的場景。
