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

快速上手

dsh-web-ui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-client-ui-plugin-manager

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

— 源: plugins.install

关键要点

• Web 终端：xterm.js 远程终端，实时输出，窗口大小自适应；
• 文件传输：SFTP 上传 / 下载，有进度条，能浏览远程目录；
• 端口转发：本地隧道直连远程内网服务（数据库、API、管理后台），只监听 127.0.0.1；
• 集群执行：一条命令并发跑多台主机，按别名 / 环境 / 标签过滤；
• Agent 直连：Agent 和面板共用同一份主机配置，对话里说一句「连一下 xxx 看看状态」，智能体就去执行远程命令。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完为什么设置页里看不到"插件管理"标签？

需要先重启 dsh web。启停开关与安装动作都在下一次手动重启后才生效，web 端没有壳内重启能力。

局域网或远程访问网页时这个标签能用吗？

不能。网关所有路由都只接受本机回环请求（socket 地址 + Host 头 + 同源标记四重门禁），非本机访问直接返回 403，与官方安装器 Tab 同一边界。

从 npm 和从 git 仓库安装有什么区别？

两者都走官方 dsh plugin CLI 完成，但 git 源需要克隆仓库，可能耗时数分钟并以后台任务运行，列表里有进度条可看；host 进程的 PATH 里必须能找到 dsh 命令，否则会被网关拒绝。

安装后下次启动挂了怎么办？

官方运行时会有"启动失败环"挂在该插件下，可点"让 Agent 修复"一键拉起修复会话（工作区就是插件安装根），或点"复制错误"取走报错。npm 运行时没有失败环，只有安装错误本身会带修复转交。

安装时显示的"冲突"是什么？能不能撤销？

冲突就是这次安装实际改动的产品行或 profile 行，可一键撤销回到操作前的状态；如果撤销不了或不想手动处理，每条冲突都能"让 Agent 修复"由 AI 自动处理。

别的插件想调用本插件的能力要怎么做？

通过 cordis 服务名 pluginManager 注入：ctx.inject(['pluginManager'], cb) 后读 ctx.pluginManager，可拿到 list/install/uninstall/status/onChange 这五个方法，onChange 在每次成功的安装/更新/卸载/启用变更后回调。

启停开关会不会让某些插件再也起不来？

在 npm 运行时上，启停是通过在 profile 的 cordis.patch.yml 写入 disabled 覆盖行实现的，但这条路径没有官方桌面写入器经过充分锻炼，建议谨慎用于那些"全家桶聚合包以 patch 行挂载"的插件；官方运行时不受此限制。

怎么彻底卸载？

用 dsh plugin --profile web remove 对应的包名后重启 dsh web 即可。本插件没有自己的配置命名空间，不需要再清理配置文件。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+（peerDependencies 锁 @deepseek-ai/dsh-client-* 为 ^0.1.0-rc.8；package.json 未声明 engines）
• Node: 未声明（package.json 无 engines 字段；monorepo 共享约束要求 Node ^22.19 || >=24）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则