DeepSeek Harness (DSH) 是以 Profile 爲中心的 Agent 運行時,插件以 npm 包形式存在。管理這些插件的安裝、啓用、配置衝突和版本更新需要一套控制面。@dsh/plugin-manager 提供了這套控制面,它獨立於舊的 component-hub,專注於 Profile 事務和 Loader 真實驗證。
核心功能¶
1. 插件清單與分類¶
插件管理器讀取 Profile bundles,能夠區分插件的來源(官方 / 社區 / 未知來源)以及當前狀態(已安裝 / 已啓用)。
2. 衝突引擎¶
內置 7 類衝突檢測機制:
* 顯式聲明
* 重複 Service Provider
* 路由衝突
* 命令衝突
* 端口衝突
* 重複插件 ID
* 缺失依賴
* Node 版本不兼容
3. 事務處理¶
對於 toggle / install / uninstall 操作,執行標準事務流程:創建快照 → 校驗 → 修改配置。如果校驗失敗,系統會自動回滾,不依賴正則匹配 YAML。
4. 分層驗證¶
從語法到真實運行,分三層驗證:
* Syntax: 使用 node --check 檢查代碼語法。
* Config: 使用 dump-config 校驗配置。
* Loader: 啓動真實的 DSH 進程進行加載驗證。
5. 任務持久化¶
將 job 狀態落盤到 jobs.json,確保進程重啓後前端依然可以查詢安裝、卸載或更新任務的進度。
6. 發現市場¶
支持離線快照導入、手動錄入候選插件,並提供一鍵安裝的事務入口。
安裝¶
通過 pnpm 直接從 GitHub 安裝:
pnpm add github:123twtd/dsh-plugin-manager
典型用法¶
使用 CLI 添加社區插件:
dsh plugin --profile web add @liustack/modlens
注意事項¶
- 本插件獨立於舊
component-hub,不導入舊項目代碼,也不把組件市場 UI 當作管理器。 - 官方核心和核心 Service 不會自動關閉。
- 官方核心受保護:
@deepseek-ai/*不能通過本接口更新。