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

快速上手

dsh-web-ui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-client-ui-skill-explorer

复制以上命令在 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，bundle 注入在启动阶段完成，热加载不会刷新侧边栏。重启后入口会出现在「New Session」按钮与工作区浏览器之间。

为什么系统内置或运行时注册的 skill 没有启用/禁用开关和删除按钮？

这两类 skill 来自 ctx.skills 注册表，没有可编辑的文件。插件只信任文件系统扫描产出的路径，所以面板上隐藏这些控件，写路由也会以 404 拒绝。

删除按钮不见了，这个 skill 不能删吗？

是的。通过符号链接挂载进来的 skill 不能删除（删除会把链接目标的 SKILL.md 移出原位，越出当前 skill 根）。面板会隐藏删除按钮，delete 路由收到请求也会返回 400。启用/禁用对这类 skill 仍然有效。

在手机或局域网其他设备上访问 DSH 时，技能中心能用吗？

默认不能。路由只接受 loopback 请求或浏览器同源标记，未配对的局域网客户端会先收到 403。如果同时安装了 dsh-remote-web-ui 并完成设备配对，配对设备的 cookie 是额外放行路径。

创建的 skill 立即生效吗？

是的。官方 dsh-skill-filesystem 提供方会热扫描新文件，模型目录即时刷新，无需重启 DSH。新技能的内容会被作为指令注入模型上下文，请避免写入敏感信息。

与官方 dsh-skill-filesystem 是什么关系？

skill-explorer 是纯 GUI 管理层，只读取并展示官方约定的 skill 文件，启用/禁用通过改写 frontmatter 的 disable-model-invocation 触发热刷新。它不修改 skill 的加载或注入语义，官方提供方仍是事实源。

项目级 skill 和用户级 skill 有什么区别？

项目级 skill（写入项目根目录下的 .dsh/skills/）仅当前项目可见，便于跟代码一起版本管理；用户级 skill（写入 ~/.dsh/skills/）本机所有项目共享，适合存放跨项目的通用指令。

创建 skill 时内容大小有限制吗？

有。表单提交时正文内容（不含 frontmatter）超过 64KB 会被拒绝，提示「content exceeds 64KB limit」。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8+（依赖 @deepseek-ai/dsh-client-runtime / dsh-host-webserver ^0.1.0-rc.8）
• Node: ^22.19 || >=24（packages/AGENTS.md 约定）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则