前言¶
在使用 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
