本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

plugin-registry

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @vlln/plugin-console

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 插件类型对比 — bundle 插件 vs 纯 cordis 插件：开发/分发/安装/管理四维 + 选型
• 官方 0809 覆盖度评估 — 官方机制覆盖度、转向决策（含 0811 repository 移除说明见 CHANGELOG）
• 薄控制台设计 — 统一管理安装态的设计
• 变更记录 / 路线图

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

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

装好后刷新 Web 页面，进入设置页会多出一个名为「插件管理」的 tab（与官方「插件」tab 并列但独立存在），点击即加载面板（packages/plugin/console/src/client/index.ts:45-57 / Panel.tsx:300）。

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

面板写入的是 profile cordis.patch.yml 的 insert 行；DSH 0811 起 profile-boot 挂载 watch-only HMR 实例，写行/删行实时生效，无需重启 web（packages/plugin/console/src/index.ts:94-145 / README.zh.md:74-78）。

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

bundle 插件装在 profile package.json 的 dependencies + dsh.profile.bundles 层栈里，层栈在启动时合成，运行时不能热插拔，必须重启 web 才生效（packages/plugin/console/src/index.ts:340-380 / README.zh.md:74-78）。

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

不必。Node half 同时注册 4 个 defineTool 工具（plugin_search / plugin_install / plugin_uninstall / plugin_status），与面板写同一份安装态，agent 可直接调用（packages/plugin/console/src/discovery/tools.ts:98-335）。

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

运行中 = host 启用；预设挂载 = host 停用但 agent preset 仍挂载（0811 起模型面工具走 preset 通道，停用 host 不等于工具消失）；已停用 = host 与 preset 都未挂载（packages/plugin/console/src/client/Panel.tsx:98-102）。

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

不能。Node half 在 toggle/remove 路由里硬性禁止对 @vlln/plugin-console 操作，返回 409——避免管理入口自毁（packages/plugin/console/src/index.ts:752-754 / 826-829）。

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

通常是 git 源或路径源未真正落盘（pnpm 退出 0 但依赖未写入 package.json），不会继续写安装态以免假成功；改用明确 npm 包名或确认 git/路径可达后重试（packages/plugin/console/src/index.ts:720-724 / discovery/tools.ts:196-199）。

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

面板点「检查更新」按钮触发 Node half 用原生 fetch 查 npm registry（30 秒最小间隔防抖），bundle 露出「更新」按钮，点后走 pnpm update；git/link 源标记为「本地」无 latest（packages/plugin/console/src/versions.ts:36-47 / Panel.tsx:208-226）。

— 源: plugin_wiki.faq_json

兼容性

• 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: 未在 packages/plugin/console/package.json 声明 engines.node（devDependencies 中 @types/node ^22.0.0，建议 Node ≥ 22）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则