前言¶
DeepSeek Harness(DSH)把能力拆成大量插件,裝得多了之後,常見問題是:不知道哪些能更新、升級會不會把中文名沖掉、兩個插件功能重疊卻看不出來、磁盤上留了失效引用。手動 pnpm 或逐個在市場裏點,成本高,出錯也難回滾。
插件管家(dsh-plugin-steward)是維護者 lihao178 發佈的客戶端類插件:左側欄一個面板,外加同一套 CLI(dsh-pm / dsh-plugin-steward),零運行時依賴的純 Node 工具,專門圍繞「已裝插件」做查更新、自動安裝(裝前快照、失敗回滾)、體檢、查重和清理。
這是什麼¶
一句話:DSH 的插件 steward——更新檢查、帶快照回滾的自動更新、健康檢查、重複分析、清理,面板與命令行共用一套邏輯。
- 倉庫:github.com/lihao178/dsh-plugin-steward
- 目錄頁:skillhub.cn 插件條目
- 許可:MIT(見倉庫
package.json) - 宿主要求:
dsh引擎>=0.2.1-rc.3(見package.json的dsh.engines)
社區目錄站點與 DeepSeek / 幻方無官方從屬關係;DSH 生態本身是「一切皆插件」的思路,管家解決的是本機已裝插件的生命週期,不是替代官方應用商店。
核心功能¶
下面只列資料中明確描述的能力。
面板(三個主頁面)¶
打開 Harness 左側欄「插件市場」頁,標籤行最右側 「插件管家」:
- 我的插件:查看已裝列表、可更新項;點「更新」後,1.4.0 起面板內升級/安裝/卸載/停用後會自動重啓 Harness,無需手動關軟件。
- 有風險嗎:靜態掃描各插件代碼,提示誰會聯網、誰執行命令、誰可能觸及密鑰;只提示,不攔截。
- 設置:例如「全部打開 (N)」——爲所有市場插件開啓自動查新版 + 自動裝新版;有新版本時自動安裝,裝前備份,出錯回滾。
設置裏還有 備份還原;命令行也可用 snapshot list 查看備份。
命令行¶
入口示例(資料原文):
npx dsh-plugin-steward status
npx dsh-plugin-steward check
npx dsh-plugin-steward auto --write # 有新版本就裝, 裝前自動備份
Windows 開發目錄下可直接用內置 Node 的 dsh-pm.cmd(README 示例路徑爲 D:\智能\dsh-plugin-manager\dsh-pm.cmd),無參數進交互菜單。
常用子命令包括:status、list、check、update、auto、doctor、fix、dupes、clean、snapshot、schedule、report、daily、label 等。默認只預演;真正改磁盤需加 --write。通用參數含 --profile(默認 desktop)、--json、--only、--refresh。
分類與分組¶
工具區分 自創插件(link/file/workspace、@local/ 或路徑不在 node_modules 真目錄)、市場插件(自 npm 拉取)、宿主自帶(在 app.asar,不應判損)、缺失(配置引用但磁盤無且宿主不帶)。另按功能打 14 類標籤(如市場管理、記憶知識、搜索聯網等),可用 list --group <功能組> 篩選。
中文名與「怎麼用」¶
升級可能沖掉插件目錄內 locale/zh.json 的中文名;管家用 .state/labels.json 對賬,體檢可報 label-drift / label-wiped,fix --write 可寫回。面板會補 中文名 + 說明 + 來源;缺中文可經 API 或「補齊中文」批量從市場目錄填充。
1.5.0 起從各插件 README 按常見標題抽取 「怎麼用」 段落,存入登記表(非插件目錄,避免升級覆蓋);面板行內 ▸ 怎麼用 可展開,工具行有 補怎麼用。
更新源¶
除 npm dist-tags.latest 外,對 spec 中明寫的 github:owner/repo 等形式走 GitHub Releases(SemVer tag);結果緩存在 .state/github-cache.json。自更新時不先 remove,原地覆蓋並配合快照。
安裝與啓用¶
推薦(GitHub,資料原文):
dsh plugin --profile desktop add github:lihao178/dsh-plugin-steward
Harness 內(面板 + HTTP 接口):
plugin_manager action=install_bundle target=dsh-plugin-steward
或在插件市場搜索「插件管家」/ dsh-plugin-steward 安裝。
也可對 AI 說:「裝這個插件: github:lihao178/dsh-plugin-steward」,裝完重啓一次 Harness 以加載(面板內操作 1.4.0 起多數情況會自動重啓)。
只想 CLI、不要面板時,用上文 npx dsh-plugin-steward … 即可。
典型用法¶
日常:開自動更新¶
- 安裝並進入左側 插件管家 → 設置。
- 點 「全部打開 (N)」,之後市場插件會自動查新、裝新;裝前備份,失敗回滾。
手動查更與升級¶
dsh-pm.cmd check
dsh-pm.cmd update --write # 預演時不加 --write
體檢與修復¶
dsh-pm.cmd doctor
dsh-pm.cmd fix --write
查重與清理¶
dsh-pm.cmd dupes
dsh-pm.cmd clean --write # 默認僅預演
備份回滾¶
dsh-pm.cmd snapshot list
dsh-pm.cmd snapshot restore ...
出問題可在面板 設置 → 備份還原 退回插件管家自身上一備份。
適用場景與注意¶
適合:本機 DSH 插件數量較多、需要統一查更新與自動升級、希望升級前快照與失敗回滾、想靜態掃一遍「聯網/執行命令」風險、需要查重和清理無效引用、關心升級後中文名與用法說明是否還在。
注意:
- 插件以當前 DSH 進程權限運行;安裝前請自行閱讀倉庫源碼與 MIT 許可證,確認可接受其掃描與自動修改
node_modules的行爲。 - 「有風險嗎」爲靜態提示,不替代你自己的安全審查。
- 命令行
auto等路徑仍可能提示手動重啓;與面板自動重啓行爲以 README 說明爲準。 - GitHub API 匿名限額下,
check對 GitHub 源插件會走緩存;可配置GITHUB_TOKEN/GH_TOKEN/GITHUB_PAT。
結尾¶
插件管家把「查更新、自動裝、備份回滾、體檢、查重、清理」收到左欄與一套 CLI 裏,並針對 DSH 常見的 GitHub 裝包、中文名被升級沖掉、README 用法分散等問題做了專門處理。進一步瞭解可打開 SkillHub 目錄頁 與 GitHub 倉庫 README。