前言¶
在使用 DeepSeek Harness（DSH）開發智能體時，經常遇到電腦變慢、界面卡頓、資源佔用飆升的問題。在沒有監控工具的情況下，這些現象往往難以定位——是 DSH 本身的問題，還是某個插件？是 CPU、內存還是界面響應拖慢了整體？dsh-performance 插件就是爲回答這些問題而設計：它以側欄實時讀數爲基礎，用 CPU、內存、界面響應三軌聯動趨勢，以及「誰在佔用」一張表，給出結論並指向具體原因，最終可以導出診斷報告用於問題反饋。
這是什麼¶
dsh-performance 是一個輕量級插件，用於監控 DSH 的運行狀態。它通過 Windows 採集器讀取進程樹中的 CPU、內存和整機數據，再用 V8 分析器把後臺主線程的調用棧歸到各個插件，從而回答五個問題：
- 電腦慢，是不是 DSH 造成的？
- DSH 的哪一部分、它啓動的哪個程序在佔用資源？
- 剛纔卡的那一下是什麼時候、和什麼同時發生的？
- 長時間運行後，內存有沒有一直上漲？
- 哪個插件在佔用 DSH 後臺的 CPU 和內存？
插件由 Wanyi424 維護，目前版本爲 0.7.1，兼容 DSH 0.2 系列（^0.2.0-rc.2），在 0.2.0-rc.2 上實測過。採集器爲 Windows x64 程序，使用系統自帶的 .NET Framework 4.x。
核心功能¶
側欄實時讀數¶
側欄底部有「運行監控」一行，右側實時顯示 CPU 和內存合計。當數值需要留意時，圖標上會亮一個圓點、數字變色，懸停可查看原因。點擊可打開詳情頁；側欄收起時只留圖標。窗口不可見時自動暫停採集。
詳情頁結論與趨勢¶
詳情頁從上到下回答三個問題。頂欄可以切換時間範圍（5 分鐘、15 分鐘、1 小時）、複製診斷報告、打開「這些數字怎麼來的」。
- 有沒有問題：頂部給出結論。正常時只顯示「DSH 運行正常」；有需要留意的情況時變成一張卡片，點名原因，「查看原因」直接打開對應的詳情，「判斷依據」打開規則。
- 什麼時候、和什麼同時發生：趨勢展示。CPU、內存、界面響應三條軌道共用一條時間軸，最下方是程序啓停。每條軌道左側是當前值和參照：CPU 和內存是整機佔用，界面響應是最長一次卡頓。懸停時一根豎線貫穿三條軌道，提示框列出那一刻各部分的 CPU 和內存、DSH 合計和整機，以及「後臺」下面最忙的插件或部分。懸停期間時間軸不滾動，方向鍵可逐點查看。圖例和程序啓停條都可以點擊打開對應的詳情。
- 是誰：「誰在佔用」一張表，名稱、CPU、內存、趨勢、說明各佔一列。CPU 爲所選時間內的平均值，內存爲當前值。
詳情抽屜¶
點任何一行、圖例或程序條，詳情從右側浮出，背後的頁面原樣不動。內容順序固定：是什麼、CPU 與內存、趨勢、構成（包含的進程、後臺按插件拆分、最耗時的函數和佔內存的位置）、技術信息（PID、啓動時間、程序位置、可複製的命令行）。右上角有上下箭頭（或 K / J）可切換上一項、下一項。在詳情裏打開另一項時，左上角會出現返回。關閉方式爲 Esc 或點抽屜外，焦點回到原來那一行。
診斷報告複製¶
點擊「複製診斷報告」，會把結論、各部分、插件和程序的佔用、界面響應整理成 Markdown，可以直接粘貼到問題反饋中。只列出程序名，不含命令行和文件路徑。
安裝與啓用¶
在 DSH 左側「插件」→「添加插件」中選擇本地壓縮包：
D:\code\plugins\dsh\dsh-performance\dist\dsh-performance-0.7.1.tgz
啓用後完整退出並重啓 DSH。不需要 API Key，不調用模型，也不與 Agent 交互。
典型用法¶
打開 DSH 後，側欄底部會自動出現「運行監控」一行，右側顯示 CPU 和內存合計。如果某次對話結束後電腦明顯變慢，可以打開詳情頁，查看最近 5 分鐘或 15 分鐘的趨勢。
在趨勢圖中，觀察 CPU 和內存兩條軌道，如果某段時間同時飆升，說明 DSH 或其工具進程在佔用資源。點擊「誰在佔用」表中的某一行，右側會彈出抽屜，顯示該部分的 CPU、內存、趨勢和構成。如果看到某個插件在後臺佔用較高，可以點擊該行，進一步查看其調用棧，定位具體函數。
如果需要向開發者反饋問題，點擊「複製診斷報告」，將生成的 Markdown 粘貼到問題反饋中。
適用場景與注意¶
該插件適合需要排查 DSH 運行性能、定位資源佔用來源、分析界面卡頓原因的開發者。由於插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。插件僅適用於 Windows，需要 .NET Framework 4.x。界面響應指標需要 Windows 10/11 22H2 及 2023 年 9 月以後的累積更新。
短結尾¶
dsh-performance 提供了一套完整的 DSH 運行監控方案：從側欄實時讀數到三軌聯動趨勢，再到「誰在佔用」的細粒度拆分，最終導出診斷報告。它不依賴模型調用，不與 Agent 交互，開銷控制在整機 0.02% 左右。更多信息可訪問：https://www.skillhub.cn/plugins/Wanyi424/dsh-performance 和 https://github.com/Wanyi424/dsh-performance
