dsh-plugin-prune

dsh-plugin-prune

Prune dead plugins in DeepSeek Harness — measures the real usage of every plugin's tools and skills (calls, error rate, latency, cross-session use) plus your value ratings, and flags the plugins you can safely remove.

中文说明

What it does

This is a pure observer plugin: it registers no model tools and modifies no business state. It:

• Listens to tools/execute + tools/result and aggregates, per tool and per skill, the number of calls, error count, total/average dispatch duration, rendered output size, distinct using sessions, and per-day call counts (rolling 90-day window).
• Adds a 「插件体检 / Plugin Health」 tab inside Settings → Plugins with:
  • a plugin overview table joined with the shipped plugin inventory (pluginInventory Remote): status (ok/disabled/failed), contributed tool counts and real call statistics per installed plugin — flagging the never-used / failed / marked-useless ones, i.e. the direct answer to "which plugins can I remove";
  • a tool/skill detail table: calls, 7-day activity, error rate, average latency, last use, sessions, output size, machine suggestions (never called — likely a dead plugin, consider removing / high error rate / marked useless / active and reliable), and a one-click Useful / Neutral / Useless value rating per row.
• Persists the statistics as JSON at $DSH_HOME/dsh-plugin-prune.json (falls back to ~/.dsh/dsh-plugin-prune.json), so counts accumulate across restarts.

Note: statistics are only collected while the plugin is installed and running; past usage cannot be reconstructed.

Installation

# from npm
dsh plugin --profile web add dsh-plugin-prune

# from a git checkout
dsh plugin --profile web add github:<your-org>/dsh-plugin-prune

Restart dsh web and open Settings → Plugins → Plugin Health.

Compatibility: dsh >= 0.1.0-rc.5, Node ^22.19 || >=24, web profile. engines.dsh gates installation on older deployments.

Configuration (optional)

The patch row accepts optional config:

- id: plugin-prune
  name: 'dsh-plugin-prune'
  config:
    debounceMs: 2000   # persist debounce (>= 100)
    keepDays: 90       # per-day count window (>= 7)
    dataPath: ''       # absolute file override; empty = $DSH_HOME default

Honest limitations

• DeepSeek Harness exposes no first-class tool → plugin provenance. The “source plugin” column is best-effort: a static catalog for shipped official tools, stack-frame attribution for tools registered while this plugin runs, and a small table for well-known third-party tools. Anything else shows 「未知来源」 — the per-tool statistics themselves are always exact.
• UI-only plugins (themes, skins, layout tweaks) emit no tool calls, so they cannot be measured automatically. The value of such plugins remains a manual judgement.
• “Safe to remove” combines objective signals (frequency, error rate, latency, cross-session use) with your own rating; use both before uninstalling.

Privacy & security

• Everything stays on your machine: the stats file contains tool names, counters, timestamps and your ratings. Nothing is sent anywhere.
• Like every dsh plugin, this package is host code: review it before installing (it is small: ~800 lines total, no runtime dependencies beyond the dsh platform packages), and pin a version or commit.

Development

pnpm install
pnpm run check      # typecheck (host + client) and build

Layout: src/index.ts (host service) → lib/; src/client/ → the __ModuleLoader__ factory bundle at client/client.js. cordis.patch.yml inserts the host row; scripts/preflight.mjs guards the package-name wiring.

Publishing to other users

• npm

  npm publish --access public
  

  prepare builds on git installs; prepack runs the full check plus preflight. Publish a version only after pnpm run check passes.

• GitHub — push the repository and add the topic dsh-plugin so dsh-find-plugin and the community directories can discover it.

• awesome-dsh-plugin.com — submit the package to the community curated directory so the marketplace surfaces it.

• Changelog & tags — tag releases (v0.1.0); the marketplace and users alike prefer pinned versions over latest.

License

MIT