DSH 插件管家(dsh-plugin-steward):查更新、自動升級與回滾的一體化管理

前言

DeepSeek Harness(DSH)把能力拆成大量插件,裝得多了之後,常見問題是:不知道哪些能更新、升級會不會把中文名沖掉、兩個插件功能重疊卻看不出來、磁盤上留了失效引用。手動 pnpm 或逐個在市場裏點,成本高,出錯也難回滾。

插件管家(dsh-plugin-steward)是維護者 lihao178 發佈的客戶端類插件:左側欄一個面板,外加同一套 CLI(dsh-pm / dsh-plugin-steward),零運行時依賴的純 Node 工具,專門圍繞「已裝插件」做查更新、自動安裝(裝前快照、失敗回滾)、體檢、查重和清理。

這是什麼

一句話:DSH 的插件 steward——更新檢查、帶快照回滾的自動更新、健康檢查、重複分析、清理,面板與命令行共用一套邏輯。

社區目錄站點與 DeepSeek / 幻方無官方從屬關係;DSH 生態本身是「一切皆插件」的思路,管家解決的是本機已裝插件的生命週期,不是替代官方應用商店。

核心功能

下面只列資料中明確描述的能力。

面板(三個主頁面)

打開 Harness 左側欄「插件市場」頁,標籤行最右側 「插件管家」:

  1. 我的插件:查看已裝列表、可更新項;點「更新」後,1.4.0 起面板內升級/安裝/卸載/停用後會自動重啓 Harness,無需手動關軟件。
  2. 有風險嗎:靜態掃描各插件代碼,提示誰會聯網、誰執行命令、誰可能觸及密鑰;只提示,不攔截。
  3. 設置:例如「全部打開 (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 … 即可。

典型用法

日常:開自動更新

  1. 安裝並進入左側 插件管家 → 設置。
  2. 點 「全部打開 (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 插件數量較多、需要統一查更新與自動升級、希望升級前快照與失敗回滾、想靜態掃一遍「聯網/執行命令」風險、需要查重和清理無效引用、關心升級後中文名與用法說明是否還在。

注意:

  1. 插件以當前 DSH 進程權限運行;安裝前請自行閱讀倉庫源碼與 MIT 許可證,確認可接受其掃描與自動修改 node_modules 的行爲。
  2. 「有風險嗎」爲靜態提示,不替代你自己的安全審查。
  3. 命令行 auto 等路徑仍可能提示手動重啓;與面板自動重啓行爲以 README 說明爲準。
  4. GitHub API 匿名限額下,check 對 GitHub 源插件會走緩存;可配置 GITHUB_TOKEN / GH_TOKEN / GITHUB_PAT。

結尾

插件管家把「查更新、自動裝、備份回滾、體檢、查重、清理」收到左欄與一套 CLI 裏,並針對 DSH 常見的 GitHub 裝包、中文名被升級沖掉、README 用法分散等問題做了專門處理。進一步瞭解可打開 SkillHub 目錄頁 與 GitHub 倉庫 README。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜