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

快速上手

dsh-web-app

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @deepseek-ai/dsh-web-app

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

— 源: plugins.install

关键要点

• macOS: right-click the app in Finder and choose Open, then confirm in the dialog that appears. Alternatively run xattr -cr /Applications/DSHCode.app once in Terminal.
• Windows: click More info on the SmartScreen dialog, then Run anyway.
• LINUX DO — This project is continuously shared and discussed in the LINUX DO community.
• dsh-genui — Provides the built-in generative UI plugin.
• dsh-annotation — Provides the built-in selection-annotation workflow.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后怎么启动 Web 界面？

在终端运行 dsh --profile web 即可，插件默认绑定 127.0.0.1:3080，启动成功后会自动打开系统默认浏览器跳转到该 URL。

启动时报 “frontend dist not built” 怎么办？

该组合包只服务已构建好的前端资源。需要在仓库根目录先运行 pnpm run build 把前端产物生成出来，再启动 dsh --profile web。

能用 --host 0.0.0.0 让局域网设备访问吗？

暂不支持。CLI 会在解析时主动拒绝 --host 0.0.0.0；若要让局域网访问，请改用 --trusted-host 显式声明可信来源。

--trusted-host 是做什么的？

给浏览器端的 /api 跨域信任栅栏追加可信主机（host 或 host:port），可重复传入多值；未声明的主机请求会被拒绝。

想要远程 SSH 登录后自动开浏览器，为什么没生效？

检测到 SSH_CONNECTION 或 SSH_TTY 环境变量时，插件会自动跳过默认浏览器打开步骤，避免在远端机器上启动本地浏览器。

安装社区插件后没有立即生效？

正常。社区插件开关需要在 DSH 重启后才生效，运行时不会热插拔其路由与浏览器注册。

提示里多了一段 app:web-surface，是什么？

这是 web-runtime 注册的模型提示段落，告诉模型当前用户交互的是本机 Web 界面，并附上访问地址、刷新规则等上下文。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则