前言¶
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。
