前言¶
DSH(DeepSeek Harness)的插件生态正在快速扩张。安装几十个插件后,容易出现问题:哪些插件实际上是损坏或静默失败的?哪些拖慢了会话?是否运行了重复或冲突的插件?目前缺乏统一的健康检查机制。dsh-perfscope 旨在填补这一空白,提供一键式的健康检查与评分。
插件定位¶
dsh-perfscope 是一个本地扫描工具,用于检查已安装插件的健康状况。它提供 0-100 的健康分数,并允许生成报告和执行安全修复。这是一个开源项目(MIT 许可证),由 Evhye38496 维护。
核心能力¶
- 健康评分:提供 0-100 的健康分数。
- 本地扫描:仅本地扫描,数据不离开机器。
- 一键修复:修复写入
cordis.patch.yml,并提供一键撤销功能。 - 离线分析:支持离线 JSONL 会话分析。
- 报告生成:支持 Markdown 和 HTML 格式报告。
- Web UI:提供设置面板。
安装与启用¶
使用官方命令安装插件:
dsh plugin --profile web add dsh-perfscope
安装后重启 dsh web,在设置中找到 dsh-perfscope。
命令行使用¶
在命令行中扫描并生成报告:
npx dsh-perfscope scan --profile web --format markdown --out report.md
npx dsh-perfscope scan --profile web --format html --out scorecard.html
对问题插件执行修复(禁用)并撤销修复:
npx dsh-perfscope fix --profile web --disable broken-plugin
npx dsh-perfscope fix --profile web --undo
技术细节¶
- 环境要求:Node.js 版本需在
^22.19.0或24+。 - 目标版本:适配
dsh 0.1.0-rc.8。 - 运行方式:读取本地插件树和遥测数据,不涉及数据上传。
- 项目性质:非官方开源项目。