前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構，隨着插件生態的擴展，手動維護配置、查看運行狀態和排查問題變得繁瑣。現有的插件管理方式缺乏直觀的集中視圖。dsh-plugin-runcat-inventory 旨在解決這一問題，它提供了一個統一的儀表盤，幫助開發者快速瀏覽、管理和維護 DSH 插件。
它是什麼¶
這是一個由 runcat-tommy 維護的 DSH 插件。它提供了比原生列表更友好的表格視圖、狀態過濾、啓用/停用開關（熱生效）、卸載功能、更新提醒、配置查看與複製，以及中英雙語界面自動切換。
核心功能¶
- 表格視圖：採用 4 列固定比例佈局（名稱 36% / 狀態 15% / 來源 21% / 操作 28%）。
- 狀態與信息：顯示“已啓用/已停用”狀態，並映射 Cordis 狀態（如已掛載、等待依賴、加載中）；描述和版本從各包
package.json讀取；來源顯示倉庫地址或安裝方式。 - 啓用 / 停用（熱生效）：通過編輯 profile 的
cordis.patch.yml實現，DSH 的 HMR 機制會自動應用更改，無需重啓 Web UI。 - 卸載：操作列提供“卸載”按鈕和二次確認，從 profile 移除依賴與 bundle 層，重啓 Web UI 後生效。
- 更新提醒：檢測 npm registry 的 latest 版本。本插件自身更新在面板頂部顯示醒目卡片；其他插件在版本列顯示
vX → vY高亮。 - 搜索與排序：支持關鍵字聯合搜索（名稱/id/描述/來源/版本），支持按配置順序或名稱排序。
- 多語言：內置簡體中文/English 雙語，界面語言跟隨 DSH 環境（設置 → 通用 → Language）自動切換。
安裝與啓用¶
在安裝前，請確保已安裝 Node.js、DSH CLI 和 pnpm（dsh plugin 命令依賴 pnpm）。
使用 npm 安裝（推薦）：
dsh plugin --profile web add dsh-plugin-runcat-inventory
安裝完成後，重啓 Web UI。進入 設置 → 逃咪-插件總覽（英文環境顯示 Runcat Plugin Overview）即可查看。
驗證與使用¶
- 驗證安裝：執行
dsh --profile web --dump-config，在輸出末尾確認存在id爲runcat-inventory、name爲dsh-plugin-runcat-inventory的條目。 - 啓用 / 停用：編輯
~/.dsh/profiles/web/cordis.patch.yml，添加或移除條目即可熱生效。 - 卸載：執行以下命令移除插件：
dsh plugin --profile web remove dsh-plugin-runcat-inventory
已知限制¶
- 零依賴：本插件自身不依賴任何外部包。
- JS 表達式衝突：若
cordis.patch.yml中包含!!js表達式，啓用/停用功能會提示失敗。 - 停用匹配邏輯：停用補丁時按
{id, name, disabled: true}精確匹配移除；若與用戶手寫內容衝突，以“恰好三個鍵”的格式爲準。
總結¶
dsh-plugin-runcat-inventory 通過表格化視圖和熱生效配置，簡化了 DSH 插件的生命週期管理。對於需要頻繁調試或管理大量插件的開發者，它能顯著提升效率。
