- 语言
- TypeScript
- License
- MIT
- 分支
- main
consoledeepseek-harnessdshdsh-plugindsh-repository-pluginplugin-managementui
薄控制台为 DSH Web 设置页提供「插件管理」面板 + 4 个 agent 工具，统一管理 profile 插件安装态（bundle 层栈与 insert 行），零官方源码改动。
$ dsh plugin --profile web add github:vlln/plugin-registry/packages/plugin/console在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
薄控制台把插件管理搬进 DSH Web 设置页：面板统一处理 bundle 与非 bundle 两种插件安装态，外加 4 个 agent 工具走同一份存储，全程不修改官方源码。
https://github.com/o/r / github.com/o/r / github:o/r 三种写法自动规范化），按包是否声明 dsh.bundle 自动分流：bundle 进层栈（重启生效），非 bundle 写 insert 行（配置 HMR 实时挂载）plugin_search / plugin_install / plugin_uninstall / plugin_status）通过 defineTool 注册，与面板写同一份安装态，支持命令行化批量运维$DSH_HOME/plugin-sources/lock.yml）+ 索引源集合（sources.yml，支持 hub catalog 与本地/URL 自定义源懒加载）cordis.patch.yml 的 insert 行；bundle 插件写 profile package.json 的 dependencies 与 dsh.profile.bundles 层栈cordis ^4.0.0-rc.7（host 半插件运行时）/ @deepseek-ai/dsh-tools ^0.1.0-rc.5（agent 工具注册 defineTool）/ react ^18.2.0（browser 半面板 UI）/ yaml ^2.4.0（profile patch 与 sources.yml 解析写入）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，导出 name = 'plugin-console' 与 inject = ['webServer', 'loader', 'tools', 'agentPresets']）/ packages/plugin/console/src/client/index.ts（Browser half，导出 name = 'plugin-console-client' 与 inject = ['slots']）/ 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.5 | peerDependencies 声明 @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 基线） |
| 平台 | Web | dsh.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/packages/plugin/console
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| 无 | - | 本插件未暴露 Cordis schema 配置项；行为参数（DSH_HOME 解析、profile 目录、registry 超时 15s、30 秒启动延迟预扫描、npm_config_registry 镜像兼容等）均为源码常量 | - |
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 路由里硬性禁止对 @vlln/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（30 秒最小间隔防抖），bundle 露出「更新」按钮，点后走 pnpm update；git/link 包标记为「本地」无 latest。
入门 — 装完即用，无配置项；高级用户通过 agent 工具接入自动化流程，无需读源码。
cordis.patch.yml 被删除为空时，HMR 会因 YAML 解析为 null 而 reload 失败——Node half 写入逻辑保留注释+[]模板的兜底结构（packages/plugin/console/src/index.ts:206-211）。@scope/name），profile patch name 字段必须加引号——YAML 中 @ 是保留指示符，裸写会导致 HMR 不生效（packages/plugin/console/src/index.ts:140-145）。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（packages/plugin/console/src/index.ts:382-403）。MutationObserver 监听 DOM 替换，仅匹配文本为「插件管理」的 tab（不会误改官方「插件」tab 的齿轮图标），曾因重名误换过图标（packages/plugin/console/src/client/index.ts:18-42）。agentPresets 服务可读，服务不可用时退化为普通已停用（packages/plugin/console/src/index.ts:484-498）。/api/plugin-console/versions/refresh 同一进程内不会重复打 registry），首次访问面板用启动 30 秒后的延迟预扫描填充缓存（packages/plugin/console/src/index.ts:538-570）。