dsh-plugin-runcat-inventory (Runcat Plugin Overview / 逃咪-插件总览)
中文 | English
Version: v1.2.0 · Changelog: CHANGELOG.en.md (中文)
A better DSH plugin list: table view, status filters, enable/disable switches (hot-applied), uninstall, update reminders, config viewer and copy, automatic zh/en UI switching.
Entry point: Settings → Runcat Plugin Overview (in the Settings left navigation; shown as 逃咪-插件总览 in Chinese).
Screenshot
Runcat Plugin Overview (English UI)
Features
| Capability | Description |
|---|
| Table view | 4 columns with fixed ratios: Name 36% / Status 15% / Source 21% / Actions 28% (name takes the largest share) |
| Entry point | Registered directly in Settings → Runcat Plugin Overview (left navigation, right after "Plugins") |
| Languages | Built-in Simplified Chinese / English; the UI follows the DSH environment (Settings → General → Language, or the browser language); the plugin's own description switches too |
| Runtime status | Enabled/Disabled + Cordis status (Mounted / Waiting for deps / Loading / Mount failed / Not mounted / Unloading) |
| Description / Version | Read from each package's package.json; the full description is shown in the expanded row (click "Details") |
| Source | Only this plugin shows its repository home page (https://github.com/runcat-tommy/dsh-plugin-runcat-inventory); others show the install method (local link / local path / GitHub / npm / built-in) |
| Details expansion | The "Details" button appears when a plugin has a description or a config; the expanded row shows the full description + config JSON, with one-click copy |
| Enable / Disable | Edits the profile's cordis.patch.yml (user override layer), hot-applied via HMR — no restart needed |
| Uninstall | "Uninstall" button in the Actions column with a confirm dialog; removes the dependency and bundle layer from the profile, effective after restarting the Web UI; cannot uninstall itself or built-in packages; uninstalled rows are marked "Uninstalled" in the list (dimmed, actions disabled) to avoid repeat operations |
| Update reminders | Checks the npm registry for the latest version (batched scan: 4 per batch, 200ms gap, 1h cache); when the plugin itself has a new version, a prominent card appears at the top of the panel (Update now / Not now); other plugins show vX → vY highlighting in the version column + an inline "Update" button + a top banner; updated plugins are marked "Restart to apply"; updating the plugin itself is supported |
| Search & filter | Keyword (combined search over name / id / description / source / version) + status filter |
| Sorting | Config order (default) / Name ↑ / Name ↓ |
| Width | No sticky columns; ←/→ arrow keys scroll horizontally; the Source column hides on narrow screens |
Structure
dsh-plugin-runcat-inventory/ # local folder name after git clone (same as the repo)
├── package.json # dsh.bundle.patch + dsh.client declarations
├── cordis.patch.yml # patch layer: inserts this plugin entry into the root entry list
├── lib/
│ ├── index.js # Host half: loader inventory + /runcat-api routes + patch file editing
│ └── client.js # Browser half: hand-written ModuleLoader bundle, table UI
├── test/
│ └── mock-test.mjs # host-half unit tests (node test/mock-test.mjs, 5 cases)
├── assets/
│ ├── preview-zh.png # Chinese-UI screenshot
│ └── preview-en.png # English-UI screenshot
├── CHANGELOG.md # changelog (Chinese)
├── CHANGELOG.en.md # changelog (English)
├── README.md # Chinese docs
└── README.en.md # English docs (this file)
Prerequisites
| Dependency | Required? | Notes |
|---|
| Node.js | ✅ Required | DSH itself is a Node program; install Node.js (suggest 20+ or the latest LTS; no strict minimum) |
| DSH CLI | ✅ Required | npm i -g @deepseek-ai/dsh |
| pnpm | ✅ Required | dsh plugin forwards to pnpm; without it you get pnpm not found on PATH; install with npm i -g pnpm |
| Git | ⚠️ Depends on method | Needed for Method B (GitHub source) or Method C (local development); not needed for Method A (npm) |
| Network | ⚠️ Depends on environment | Method A needs access to the npm registry; Methods B/C need access to GitHub — if direct connections fail, configure a git proxy, e.g. git config --global http.https://github.com.proxy http://127.0.0.1:7897 |
This plugin itself has zero dependencies: the host half only uses Node built-ins (plus lazily resolving js-yaml from the profile), and the browser half is a hand-written ModuleLoader bundle. Nothing extra to install.
Installation
Installs into the web profile (replace web with your profile name if different).
Method A: npm install (simplest, recommended)
dsh plugin --profile web add dsh-plugin-runcat-inventory
Pulls directly from the npm registry; the package is published at
https://www.npmjs.com/package/dsh-plugin-runcat-inventory
(if your npm/pnpm is configured with a mirror, wait for the mirror to sync).
Method B: install directly from GitHub
dsh plugin --profile web add github:runcat-tommy/dsh-plugin-runcat-inventory
pnpm pulls the repo directly from GitHub; this plugin has no build scripts, so no allowBuilds is needed.
Method C: local folder (for development/debugging)
git clone https://github.com/runcat-tommy/dsh-plugin-runcat-inventory.git
cd dsh-plugin-runcat-inventory
dsh plugin --profile web add .
dsh plugin add . links this folder into the profile via link: — dev-friendly: code changes take effect after restarting the Web UI, no reinstall needed.
Verify
dsh --profile web --dump-config should end with an entry whose id is runcat-inventory and name is dsh-plugin-runcat-inventory.
Then restart the Web UI and open Settings → Runcat Plugin Overview (in the left navigation; 逃咪-插件总览 in Chinese).
How it works
- Data: the host half iterates
ctx.loader.entries() (same as the official inventory); fiber status maps from FiberState; description/version are read from each package's package.json; source is derived from the profile's package.json dependency declarations.
- Enable/Disable: writes
{id, name, disabled: true} patches into ~/.dsh/profiles/web/cordis.patch.yml (to disable) or removes them (to enable). DSH watches this file via HMR (watchUserPatches) and hot-applies changes to the loader — plugins toggle instantly without a restart.
- Communication: the browser half fetches same-origin
/runcat-api routes; routes carry a loopback trust check (CSRF protection).
- Lazy js-yaml resolution: when installed via
link:, the plugin's real path is the workspace (no node_modules there), so at runtime js-yaml is resolved anchored at the profile directory.
Uninstall
dsh plugin --profile web remove dsh-plugin-runcat-inventory
Known limitations
- If
cordis.patch.yml contains !!js expressions, the enable/disable switch reports a failure (the file is never corrupted; it just cannot be auto-edited).
- The disable patch is matched and removed exactly as
{id, name, disabled: true} (three keys); conflicts with hand-written content are resolved by the "exactly three keys" rule.
Changelog
Full history in CHANGELOG.en.md (中文).
- v1.2.0 (2026-08-27): added update reminders — the plugin's own update is shown in a prominent card at the top of the panel (Update now / Not now); other plugins show
vX → vY highlighting in the version column + an inline "Update" button + a top banner; batched scanning (4/batch, 200ms gap, 1h cache); updated plugins are marked "Restart to apply"; updating the plugin itself is supported.
- v1.1.0 (2026-08-27): milestone — the version line moved to 1.x and the release was published to npm (https://www.npmjs.com/package/dsh-plugin-runcat-inventory), aggregating everything since 0.4.x (uninstall + "Uninstalled" markers, left-navigation entry, zh/en UI, npm install).
- v0.4.0 (2026-08-27): added uninstall (button in the Actions column + confirm dialog + cannot uninstall itself or built-ins); the entry point moved from the "Settings → Plugins" tab to the Settings left navigation (Settings → Runcat Plugin Overview).
- v0.3.8 (2026-08-27): installation gained "Method A: npm install" (simplest, recommended); the previous methods became B/C;
package.json gained a dsh.marketplace declaration (for the dsh-plugin-marketplace scanner).
- v0.3.7 (2026-08-27): added preview screenshots — the Chinese README shows the Chinese-UI screenshot, the English README shows the English-UI screenshot (
assets/ folder).
- v0.3.6 (2026-08-27): docs — added
CHANGELOG.en.md (English changelog) with language switcher links on both changelogs.
- v0.3.5 (2026-08-27): docs — added Method B (install from GitHub source); added
README.en.md (English docs) with language switcher links on both READMEs.
- v0.3.4 (2026-08-27): docs — folder name unified to
dsh-plugin-runcat-inventory; added the "Prerequisites" section.
- v0.3.3 (2026-08-27): the plugin's own description now follows the UI language (zh/en, in the Details row).
- v0.3.2 (2026-08-27): fix — only this plugin shows the repo URL; others show install methods again; Source column content wraps (long URLs no longer overflow into Actions).
- v0.3.1 (2026-08-27): fixed column ratios (Name 36% / Status 15% / Source 21% / Actions 28%); Source shows the repo URL for this plugin.
- v0.3.0 (2026-08-27): i18n — zh/en dictionaries via the DSH locale service; host errors become error codes; source becomes kind+spec.
