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

快速上手

dsh-web-ui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:zhu1090093659/dsh-web-ui#path:packages/dsh-web-ui-all

复制以上命令在 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。如果是源码开发模式，除 dsh plugin add 外还需 pnpm install && pnpm -r build && node scripts/link-profile.mjs，安装后重启 dsh web 才生效（README.md:24-30）。

只想装其中一两个插件，不想全家桶一起装，怎么办？

直接装对应独立子包即可（如 dsh plugin add @linxin666/dsh-client-ui-task-board），不必走本全家桶；本包安装会激活全部子插件，无法只挑其中一部分（README.md:38）。

跟同名独立插件包同时安装会冲突吗？

不会。本包聚合行 id 统一带 web-ui- 前缀（如 web-ui-task-board），独立装的仍用原 id（task-board），loader 不再拒绝重复 id。建议只保留一个来源，两个并存没有额外收益（README.md:39）。

profile 里按插件 id 写的配置行要怎么对应？

插件来自本全家桶时用 web-ui- 前缀（如 remote-web-ui 的 autoTunnel 配置行写成 web-ui-remote-web-ui），独立安装时仍用插件原 id（README.md:39）。

升级到新版本后新版没有生效，怎么排查？

改 profile 的 package.json 版本号后执行 pnpm install，顶层 node_modules/@linxin666/* 条目可能仍链接到旧版 store 目录。需要确认这些链接已指向新版（Windows: cmd /c rmdir 再 cmd /c mklink /J ），然后重启 dsh web（README.md:32-34）。

本包代码里到底装了什么自定义逻辑？

host 半区没有任何业务逻辑（src/index.ts:14 的 apply 是空函数）；浏览器半区只有一个 compat shim（src/client/index.ts:1-98），给 dsh web 外壳侧栏/中间/详情三列容器补上老式 data-pane / data-dsh-frame 属性，让按老选择器挂载的子插件能继续工作。

官方 dsh web 外壳升级后，本包还能正常工作吗？

可以。compat shim 用 MutationObserver 监听 DOM 变化，在下一帧合并重打属性（src/client/index.ts:60-71），React 重渲染重建列容器后会自动补回属性，幂等不会重复触发。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（package.json 无 dsh.engines；DSH 版本通过 @deepseek-ai/* SDK 依赖隐式锁定）
• Node: ^22.19 || >=24（据 packages/AGENTS.md:9，本包 package.json 未声明 engines）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则