dsh-plugin-prune（死插件修剪器）
修剪 DeepSeek Harness 里的死插件 —— 统计每个插件的工具/技能被*真实*使用了 多少次、错误率与耗时如何、跨多少个会话被使用，再加上你的价值评分，标出哪些插件 可以安全移除。
它做什么
这是一个纯观察型插件：不注册任何模型工具、不改变任何业务状态。它会：
- 监听
tools/execute+tools/result，按工具和技能聚合：调用次数、错误数、
总/平均执行耗时、渲染输出量、使用过的会话数、每日调用数（滚动 90 天窗口）。
- 在 设置 → 插件 → 「插件体检」 里增加一个标签页：
- 插件总览表：与官方插件清单（pluginInventory Remote）join，列出每个已安装 插件的状态（正常/禁用/加载失败）、贡献的工具数与真实调用统计，直接标出 "从未被使用 / 加载失败 / 已标无用" 的可疑插件——回答"哪些插件可以移除"。 - 工具/技能明细表：每个工具的调用次数、近7天调用、错误率、平均耗时、最近使用、 跨会话数、输出量，机器建议（从未被调用：很可能是死插件，建议移除 / 错误率高 / 已标无用 / 活跃可靠），每行可一键标记 有用 / 一般 / 无用。
- 把统计数据持久化为 JSON：
$DSH_HOME/dsh-plugin-prune.json
（无 DSH_HOME 时回退到 ~/.dsh/dsh-plugin-prune.json），重启后继续累计。
> 注意：统计只在插件安装且运行期间采集，历史使用无法回溯。
安装
# 从 npm 安装
dsh plugin --profile web add dsh-plugin-prune
# 从 git 仓库安装
dsh plugin --profile web add github:<your-org>/dsh-plugin-prune重启 dsh web，打开 设置 → 插件 → 插件体检。
兼容性：dsh >= 0.1.0-rc.5、Node ^22.19 || >=24、web 配置。
engines.dsh 会在更旧的部署上阻止安装。
可选配置
补丁行支持可选 config：
- id: plugin-prune
name: 'dsh-plugin-prune'
config:
debounceMs: 2000 # 持久化防抖（>= 100）
keepDays: 90 # 每日计数保留窗口（>= 7）
dataPath: '' # 文件绝对路径覆盖；留空 = $DSH_HOME 默认位置诚实的局限
- DeepSeek Harness 没有官方的"工具→插件"归属信息。"来源插件"一列是尽力识别：
官方内置工具靠静态目录、本插件运行期间新注册的工具靠调用栈解析、常见第三方 工具靠小型对照表；其余显示「未知来源」。统计数字本身始终是精确的。
- 纯 UI 插件（主题、皮肤、布局）不产生工具调用，无法自动测量，其价值只能人工判断。
- "可以安全移除"由客观信号（频率、错误率、耗时、跨会话使用）加你自己的评分共同
构成，卸载前请两者结合判断。
隐私与安全
- 数据全部留在本机：统计文件只包含工具名、计数、时间戳与你的评分，不上传任何内容。
- 和所有 dsh 插件一样，本包是宿主机代码：安装前请审查（代码量小：约 800 行，
除 dsh 平台包外无运行时依赖），并固定版本或 commit。
开发
pnpm install
pnpm run check # typecheck（host + client）+ 构建结构：src/index.ts（host 服务）→ lib/；src/client/ → 打包为 client/client.js（__ModuleLoader__ factory 产物）。cordis.patch.yml 插入 host 行；scripts/preflight.mjs 守护包名接线的一致性。
如何发布给其他用户
1. npm
``sh npm publish --access public ``
prepare 让 git 安装自动构建；prepack 会跑完整检查 + preflight。 只有在 pnpm run check 通过后再发布版本。
2. GitHub —— 推送仓库并加上 dsh-plugin topic，dsh-find-plugin 与社区目录就能发现它。
3. awesome-dsh-plugin.com —— 提交到社区精选目录，让插件市场展示。
4. 版本与 changelog —— 打 release 标签（如 v0.1.0）；比起 latest， 市场和用户都更喜欢固定版本。
License
MIT