dsh-performance-optimizer：为 DeepSeek Harness 提供宿主性能观测的 DSH plugin

它是做什么的？

它是 DeepSeek Harness（DSH）的性能观测插件，把宿主进程的 CPU、内存与 IO 指标变成用户和 Agent 都能直接读取的数据。它解决滚动卡顿、内存漂移和工具循环难以定位的问题，让性能排查不再靠猜。插件每秒采样一次 Node 进程的内存与 CPU 用量，保留 60 个样本的滚动缓冲，并通过设置页、悬浮 HUD 和原生工具三个入口对外呈现。整个组合包由 Weidows 维护，采用 MIT 协议，代码为 JavaScript。

核心功能

• 实时指标面板：在设置页的插件详情中挂载实时表格与 Canvas2D 图表，提供 CPU、RSS、Heap、Wall 四个标签页切换查看。
• 悬浮 HUD：开启 hudVisible 后，把指标浮层挂到页面 body 上，浏览界面时也能持续观察性能变化。
• 原生 Agent 工具：注册 performance_report 工具，Agent 在会话内按需调用即可拿到一份最新的 JSON 性能报告。
• 滚动采样缓冲：每秒采集一次 process.memoryUsage() 与 process.cpuUsage()，只保留最近 60 个样本，开销刻意保持极小。
• 细粒度采样字段：区分 rss、heapUsed、heapTotal、external 等字段，并同时记录时钟时间与单调时间，便于判断进程是否增长、V8 堆是否膨胀。

怎么使用这个插件？

在 DSH 的 Web 配置中启用该 DSH 插件并重启后，打开设置里的插件详情页即可看到实时指标表格与图表。想边用边看时，把 hudVisible 设为 true 打开悬浮 HUD；需要让 Agent 参与分析时，直接让它调用 performance_report 工具获取 JSON 报告。排查滚动卡顿或内存漂移时，对照 RSS 与 heapUsed 曲线的变化趋势即可判断问题来源。

报错怎么排查？

指标面板没有数据时，先确认 Web 配置已重启，再检查插件是否成功加载。悬浮 HUD 不出现，通常是 hudVisible 未开启。Agent 拿不到报告，则说明 performance_report 工具未注册成功，按官方说明修复后重试。