DeepSeek Harness Web UI 打不开、白屏怎么办？DSH plugin 界面无法访问排查

故障排查发布于 2026-08-21作者: DSH Plugin 插件中心
DeepSeek HarnessDSH pluginWeb UI 打不开白屏端口 3080
DeepSeek Harness Web UI 打不开，先确认进程与端口：默认在 http://127.0.0.1:3080，被占用就换端口；白屏先看工作区有没有选中，再看浏览器控制台报错；界面类 DSH plugin 冲突也要排查。

DeepSeek Harness Web UI 打不开，先确认进程在跑、端口没换；白屏先看工作区有没有选中，再看浏览器控制台报错与界面类 DSH plugin 冲突。

概览

Web UI 访问链路按「进程 → 端口 → 页面 → 工作区 → 插件」排。 打不开多在前两段，白屏多在后三段。先按现象分：浏览器提示「连接被拒绝」多为进程没起或端口不对；一直转圈、超时多为网络或代理问题；页面能开但空白则查工作区与插件。dsh web 是 --profile web 的别名，默认开在 http://127.0.0.1:3080（来源）。DSH 还在开发者预览阶段，界面细节可能变化，以官方文档为准；端口、白屏这类高频问题也汇总在《DSH 常见问题排查》里，可以先对照速查。

DeepSeek Harness Web UI 打不开：先确认进程与端口

默认地址是 http://127.0.0.1:3080，打不开先确认进程在跑、端口没被占。 排查三点：

  1. 进程在跑：启动 npx @deepseek-ai/dsh web 时留意终端打印的访问地址，别用错端口。
  2. 端口被占：换端口启动，--port 是 Web 应用自己的参数、跟在 profile 后面（来源）：
bash
dsh --profile web --port 8080
  1. 地址核对：确认访问的是 http://127.0.0.1:3080 而不是旧端口；远程或容器部署时要用对应的局域网/映射地址，127.0.0.1 只指向本机。
  2. 端口占用：换端口前先确认 3080 是不是被别的程序占了——macOS / Linux 用 lsof -i :3080，Windows 用 netstat -ano | findstr 3080；确认被占再换端口，避免换了端口问题依旧。

如果 DSH 进程本身都启动不起来（启动即报错退出），先别查端口——这是安装或依赖问题，看《DeepSeek Harness 安装报错排查》。

DeepSeek Harness Web UI 白屏：先看工作区，再看浏览器控制台

页面能开但白屏，先确认工作区选中，再看控制台报错。 两条顺序：

  1. 工作区：新的 Web UI 在添加工作区前不会选中任何工作区，需要先点选择工作区加入项目目录，会话输入框才可用（来源）。这一步没做，UI 看起来就像"坏了"。
  2. 浏览器控制台：按 F12 看报错——资源加载失败多为网络或缓存问题，JS 报错多为插件或版本问题；清缓存强刷（macOS 上 Cmd+Shift+R，Windows/Linux 上 Ctrl+Shift+R）排除旧缓存干扰。

排完这两步还白屏，再开一个无痕窗口访问（排除浏览器扩展干扰），并打开控制台的 Network 面板看失败请求——标红的请求会直接告诉你是哪部分前端资源没加载出来。如果报错集中在模型相关请求（401、404 之类），界面本身未必有问题，转看《DeepSeek Harness 模型连不上排查》。

界面类 DSH plugin 冲突排查

白屏且控制台有 JS 报错时，考虑界面类插件冲突。 界面类插件（侧边栏、终端 UI、主题等）会改动 UI 渲染，多个同时加载可能互相覆盖。排查步骤：

  1. 执行 dsh --dump-config，看当前加载了哪些界面类插件（来源）。
  2. 用 dsh plugin --profile web remove <插件包名> 逐个卸掉界面类插件，每卸一个刷新页面看是否恢复。
  3. 恢复后再逐个装回，定位冲突组合，保留不冲突的那个。

每步只动一个插件、卸一个刷新一次；别一次卸多个，否则定位不到是谁在冲突。卸载顺序建议从最近安装的界面类插件开始，最近装的通常是冲突源。

界面类插件（侧边栏、终端 UI 等）在 DSH Plugin Hub 的 interface 分类下人工精选——排查界面异常时，先回看 Hub 里装过哪些界面插件，按上面的冲突思路处理。

注意事项

  1. Web UI 一直修不好、任务又急：直接走 headless 模式，dsh --profile headless "你的任务" 会新建会话、跑完打印结果然后退出，全程不依赖浏览器（来源）。
  2. 换端口不影响会话数据，会话仍按项目存放在 ~/.dsh/sessions。
  3. 白屏大多不是 DSH 坏了，是工作区没选中或界面插件冲突。
  4. 换端口后浏览器可能缓存旧地址，用新地址访问并清缓存强刷一次。

来源：官方 Quickstart、dsh CLI README

常见问题

DeepSeek Harness Web UI 打不开怎么办？

先确认进程在跑、地址是 http://127.0.0.1:3080；端口被占用就换端口启动，执行 dsh --profile web --port 8080，--port 是 Web 应用的参数、跟在 profile 后面。

页面能打开但白屏？

先点「选择工作区」加入项目目录，会话输入框才可用；再看浏览器控制台（F12）的报错，清缓存强刷（Cmd/Ctrl+Shift+R）排除旧缓存干扰。

白屏可能是插件引起的吗？

可能。界面类插件会改 UI 渲染，多个同时加载会互相覆盖导致白屏；用 dsh --dump-config 查看加载了哪些界面类插件，逐个卸载定位冲突组合。

Web UI 一直修不好，任务还急着跑怎么办？

直接走 headless 模式：dsh --profile headless "你的任务"，DSH 会新建一个会话、跑完把最终答案打印到终端然后退出，全程不依赖浏览器。

来源