前言¶
DeepSeek Harness 采用“一切皆插件”的架构，随着开发和使用，系统中往往堆积了大量工具和技能插件。开发者很难直观判断哪些插件是活跃的，哪些已经沦为“死插件”。dsh-plugin-prune 插件通过纯观察模式，收集每个插件工具和技能的真实调用数据、错误率、延迟以及跨会话使用情况，结合你的主观评分，标记出可以安全移除的插件。
这是什么¶
dsh-plugin-prune 是一个纯观察者插件，不注册模型工具，也不修改业务状态。它由 Octo-o-o-o 维护，开源协议为 MIT。其核心价值在于提供客观的量化指标，辅助决策哪些插件应当保留或卸载。
核心功能¶
该插件主要提供以下能力：
- 统计数据汇总：聚合工具和技能的调用次数、错误数、平均/总耗时、输出大小、活跃会话数，以及每日调用次数（90天滚动窗口）。
- 插件健康视图：在 Settings → Plugins 中新增 Plugin Health（插件体检） 标签页。提供概览表格，展示已安装插件的状态（正常/禁用/失败）、贡献的工具数及真实调用统计，自动标记从未使用、失败或被标记为无用的插件。
- 评分机制：在详情表格中，支持对每个插件进行“有用”、“中立”、“无用”的一键评分。
- 数据持久化：统计数据以 JSON 文件形式保存在
$DSH_HOME/dsh-plugin-prune.json，支持跨重启累计。
安装与启用¶
插件安装后需要重启 DeepSeek Harness 的 Web 进程才能生效。
dsh plugin --profile web add dsh-plugin-prune
安装完成后，重启 dsh web，进入 Settings → Plugins，找到 Plugin Health 标签页即可查看数据。
典型用法¶
- 进入 Settings → Plugins → Plugin Health 查看概览和详情表格。
- 在详情表格中，检查工具的 calls（调用次数）。如果某工具从未被调用，表格会提示“never called（从未调用）”，建议移除。
- 查看错误率或平均延迟。高错误率或异常延迟的工具可能存在问题。
- 针对不确定的插件，点击该行的评分按钮，标记为“Useful”、“Neutral”或“Useless”。
适用场景与注意¶
- 统计范围：统计数据仅在插件安装并运行期间收集，卸载插件后无法恢复历史数据。
- 来源信息：DeepSeek Harness 暴露没有第一类工具 -> 插件来源的映射。详情表中的“source plugin（来源插件）”列是尽力而为的：对于官方工具是静态目录，对于运行时注册的工具是栈帧追踪，对于第三方工具是知名列表，其他情况显示“未知来源”。工具层面的统计数据本身是准确的。
- UI 插件限制：仅用于 UI 样式或布局的插件不产生工具调用，无法通过此插件自动测量其价值，需手动判断。
- 隐私与安全：所有统计数据仅存储在本地机器的 JSON 文件中，不会上传到任何服务器。
- 依赖要求：需要
dsh >= 0.1.0-rc.5版本，以及 Node.js^22.19 || >=24环境。
总结¶
dsh-plugin-prune 解决了插件管理中的“盲人摸象”问题。通过将隐性的使用行为转化为显性的统计指标，它帮助开发者保持插件列表的整洁，避免冗余代码和配置的干扰。在使用前，请务必检查源码（GitHub 链接）并确认版本兼容性。
- GitHub 仓库：https://github.com/Octo-o-o-o/dsh-plugin-prune
- 社区目录：https://www.skillhub.cn/plugins/Octo-o-o-o/dsh-plugin-prune
