前言¶
DSH（DeepSeek Harness）採用「一切皆插件」的架構，插件運行在宿主進程中，負責擴展能力。在開發智能體應用時，宿主性能問題往往難以及時發現：滾動延遲、內存漂移、事件循環飽和等，可能導致工具調用卡頓、響應變慢，甚至進程崩潰。傳統方式需要開發者手動在宿主進程注入監控代碼，或依賴外部工具，調試成本較高。weidows/dsh-performance-optimizer 提供了一套輕量級方案，通過採樣 Node.js 的內存和 CPU 指標，並在 Settings、HUD 和原生工具三個層面暴露數據，讓用戶和智能體都能直接觀測宿主狀態。
是什麼¶
dsh-performance-optimizer 是一個 DSH bundle，暴露宿主範圍和事件循環層面的性能指標（CPU / 內存 / IO）。它以最小化方式實現：每秒採樣一次 process.memoryUsage() 和 process.cpuUsage()，保留 60 個樣本的滾動緩衝區，並通過 Settings 選項卡、可選懸浮 HUD 和原生工具三個接口向用戶和智能體提供數據。
核心功能¶
- Settings 選項卡：在插件詳情頁掛載
<perf-settings-tab>元素，提供實時表格和基於 Canvas2D 的圖表，展示 CPU、RSS、堆內存、牆鍾時間等指標。 - 懸浮 HUD：通過
hudVisible: true配置，在頁面掛載<perf-hud>元素，提供浮動的性能監控面板。 - 原生工具：註冊
performance_report工具，返回 JSON 格式的性能報告，包含最近採樣數據。
安裝與啓用¶
從本地路徑安裝：
npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-performance-optimizer
從 tarball 安裝：
npx @deepseek-ai/dsh plugin --profile web add ./dsh-performance-optimizer-0.1.0.tgz
安裝後重啓 Web profile 並打開插件設置頁面：
npx @deepseek-ai/dsh web
打開 http://127.0.0.1:3080/settings/plugins，在插件列表中找到 dsh-performance-optimizer 並啓用。
典型用法¶
在 Settings 選項卡中，可以切換 CPU / RSS / Heap / Wall 四個標籤，查看歷史曲線和實時數值。啓用 HUD 後，頁面右上角會出現浮動面板，顯示當前採樣數據。原生工具 performance_report 由智能體在會話中調用，返回類似以下 JSON：
{
"name": "performance_report",
"arguments": {},
"result": {
"kind": "json",
"value": {
"intervalMs": 1000,
"sampleCount": 42,
"latest": { "t": "2026-10-20T11:39:42.000Z", "rss": 314572800, "heapUsed": 134217728, "cpuMs": { "user": 1234.5, "system": 67.8 }, "wallDeltaMs": 1000, "uptimeMs": 3600000 },
"history": [ /* last 10 samples */ ],
"generatedAt": "2026-10-20T11:39:42.000Z"
}
}
}
適用場景與注意¶
該插件適合需要在 DSH 中持續監控宿主性能的開發者或智能體工程師。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證（MIT）。禁用插件時會自動清理採樣定時器、工具註冊和 UI 元素，不會遺留副作用。
短結尾¶
dsh-performance-optimizer 以輕量方式提供宿主性能觀測能力，幫助在 DSH 中識別滾動延遲、內存漂移等問題。更多細節可查看目錄頁：https://www.skillhub.cn/plugins/Weidows/dsh-performance-optimizer；源碼位於：https://github.com/Weidows/dsh-performance-optimizer。
