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/*不能通过本接口更新。