跳到主内容

plugin-registry

57Star6Fork1Issue0Watching

在 DSH Web 设置页嵌入「插件管理」面板与 4 个 agent 工具，按官方机制统一管理 profile 插件安装态：bundle 层栈与 insert 行启停、版本检查、增删查。

分类▣ 界面增强⌨ 开发者工具
机审证据5/5方法论数据来源安装命令持续维护DSH 版本风险扫描
机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科
vllnvlln
·vlln/plugin-registry
语言
TypeScript
License
MIT
分支
main
consoledeepseek-harnessdshdsh-plugindsh-repository-pluginplugin-managementui

安装

命令web profile
$ dsh plugin --profile web add github:vlln/plugin-registry

在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程

对话式安装

帮我安装 DeepSeek Harness 插件 vlln/plugin-registry：先查看仓库 https://github.com/vlln/plugin-registry 确认安全性，然后执行安装命令并验证插件加载成功。

把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。

一句话定位

在 DSH Web 设置页嵌入「插件管理」面板 + 4 个 agent 工具，0 patch 统一管理 profile 插件安装态：bundle 层栈、insert 行、启停与版本检查都走官方机制，不直接改源码。

核心能力

  • 在 DSH 设置页新增「插件管理」tab，列出全部已加载插件与版本状态，按「运行中 / 预设挂载 / 已停用」三态展示，并区分用户安装 / 官方内置 / 管理工具自身。
  • 一行安装入口：输入 npm 包名或 GitHub URL（含 https://github.com/o/r、github.com/o/r、github:o/r 三种写法自动规范化），按包是否声明 dsh.bundle 自动分流：bundle 进层栈（重启生效），非 bundle 写 insert 行（配置 HMR 实时挂载，无需重启）。
  • 已加载插件的运行时启停：停用/启用即时生效并持久化到 profile patch；bundle 形态支持更新（pnpm update）与卸载（pnpm remove + reconcile）。
  • 注册 4 个 agent 工具（plugin_search / plugin_install / plugin_uninstall / plugin_status），agent 与面板写同一份安装态，支持命令行化批量运维。
  • npm registry 版本检查：原生 fetch 查最新版（不走子进程，受限宿主也能用），6h 缓存 + 30 秒防抖，git/link 源自动识别为「本地」无 latest。

技术实现

  • 语言: TypeScript（Node half）+ TypeScript + React 18（Browser half）
  • 关键依赖: cordis ^4.0.0-rc.7（host 半插件运行时）/ react ^18.2.0（browser 半面板）/ @deepseek-ai/dsh-tools ^0.1.0-rc.5（agent 工具注册 defineTool）/ yaml ^2.4.0（profile patch 解析写入）
  • 架构模式: 官方 bundle 双半插件——Node half 通过 dsh.bundle.patch 注册 plugin-console cordis 插件，挂载到 web profile 的 webServer（/api/plugin-console 路由）+ loader（读 loader 树条目）+ tools（注册 4 个 agent 工具）+ agentPresets（preset 挂载标注）四个 inject 服务；Browser half 通过 dsh.client.inject 把 React 面板挂到 settings.section 插槽
  • 入口文件: packages/plugin/console/src/index.ts（Node half）/ packages/plugin/console/src/client/index.ts（Browser half）/ packages/plugin/console/cordis.patch.yml（bundle 注入声明）

适用场景

DSH 用户装了多个第三方 bundle 或非 bundle 插件，需要在 Web UI 集中查看/启停/更新，不想逐个手动改 profile 配置或重启服务。 agent 开发者需要在受控的 DSH 流程里自动安装/卸载插件（例如做 setup 流程、CI 内验证插件），希望走官方机制而非绕过 pnpm。 想做一个干净的环境试装不同插件组合，又不想每次都进 cordis.patch.yml 手写 YAML——面板+工具直接接管安装态读写。

前置依赖与兼容性

依赖最低版本说明
DSH^0.1.0-rc.5peerDependencies 声明 @deepseek-ai/dsh-tools ^0.1.0-rc.5；依赖 web profile 的 webServer / loader / tools / agentPresets 四个 inject 服务，对应 0811 之后官方移除 repository-plugins 机制的版本
Node未声明package.json 未声明 engines.node；devDependencies @types/node ^22.0.0，建议 Node ≥ 22（对齐 DSH 0811 host 基线）
平台Webdsh.client.platform: "web"；Node half 跨平台但仅在 web profile 组合下注册路由
原生模块无仅使用 node:fs / node:child_process / node:os / node:path 内建模块与浏览器 fetch，未引入 native binding

安装方式

dsh plugin --profile web add github:vlln/plugin-registry

配置项

配置类型说明默认值
无-本插件未暴露 Cordis schema 配置项；行为参数（DSH_HOME 解析、profile 目录、registry 超时、30 秒启动延迟预扫描等）均为源码常量-

常见问题

Q: 装好之后在 DSH Web 的哪里能看到管理面板？

A: 装好后刷新 Web 页面，进入设置页会多出一个名为「插件管理」的 tab（位于官方「插件」tab 旁），点击即加载面板。

Q: 非 bundle 插件安装完为什么不需要重启 DSH？

A: 面板走的是 profile cordis.patch.yml 的 insert 行写入；DSH 0811 起 profile-boot 挂载 watch-only HMR 实例，写行/删行实时生效。

Q: bundle 插件为什么装完还要重启 web？

A: bundle 插件装在 profile package.json 的 dependencies + dsh.profile.bundles 层栈里，层栈在启动时合成，运行时不能热插拔。

Q: agent 怎么用这套安装机制？需要切到面板吗？

A: 不必。Node half 同时注册 4 个 defineTool 工具（plugin_search / plugin_install / plugin_uninstall / plugin_status），与面板写同一份安装态。

Q: 面板显示的「运行中 / 预设挂载 / 已停用」三态怎么区分？

A: 运行中 = host 启用；预设挂载 = host 停用但 agent preset 仍挂载（0811 模型面工具走 preset 通道，停用 host 不等于工具消失）；已停用 = 完全停用。

Q: 能不能在面板里把这个管理工具自身停用或卸载？

A: 不能。Node half 在 toggle/remove 路由里硬性禁止对 @dsh-external/plugin-console 操作，返回 409——避免管理入口自毁。

Q: 安装失败时提示「pnpm add succeeded but X is not in the profile dependencies」是什么意思？

A: 通常是 git 源或路径源未真正落盘（pnpm 退出 0 但依赖未写入 package.json），不会继续写安装态以免假成功；改用明确包名或确认 git/路径可达后重试。

Q: 插件有新版本时怎么更新？

A: 面板点「检查更新」按钮触发 Node half 用原生 fetch 查 npm registry 6h 缓存（30 秒最小间隔防抖），bundle 露出「更新」按钮，点后走 pnpm update（重启生效）；git/link 包标记为「本地」无 latest。

上手难度

入门 — 装完即用，无配置项；高级用户通过 agent 工具接入自动化流程，无需读源码。

已知问题与限制

  • bundle 插件的安装/更新/卸载需要重启 web（层栈启动时合成），运行时仅支持启停；非 bundle 插件（insert 行）才实时挂载（packages/plugin/console/README.md:73-75）。
  • Node half 改动需要重启 web（ESM 缓存），Browser half 改动只需重装 + 刷新页面（packages/plugin/console/README.md:75）。
  • profile cordis.patch.yml 被删除为空时，HMR 会因 YAML 解析为 null 而 reload 失败——Node half 写入逻辑保留注释+[]模板的兜底结构（src/index.ts:206-211）。
  • 安装源字符串若是 npm scoped 包（如 @scope/name），profile patch name 字段必须加引号——YAML 中 @ 是保留指示符，裸写会导致 HMR 不生效（src/index.ts:140-145）。
  • Windows 下 pnpm / npm 命令通过 .cmd 批处理垫片调用会触发 libuv EINVAL，Node half 改为直接 spawn <node>\node_modules\npm\bin\npm-cli.js 或 %APPDATA%\npm\node_modules\pnpm\bin\pnpm.mjs JS 入口，入口找不到时回退 .cmd（src/index.ts:382-403）。
  • 浏览器面板自定义 tab 图标走 MutationObserver 监听 DOM 替换，仅匹配文本为「插件管理」的 tab（不会误改官方「插件」tab 的齿轮图标），曾因重名误换过图标（src/client/index.ts:18-42）。
  • 已加载插件的「预设挂载」标注依赖宿主 agentPresets 服务可读，服务不可用时退化为普通已停用（src/index.ts:484-498）。

查看使用指南 →

该插件的安装步骤、关键要点、FAQ 与兼容性说明（基于已收录字段派生）。

收录徽章

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/vlln/plugin-registry)

把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。

返回插件目录