DeepSeek Harness Web UI 连不上：发送按钮灰、命令列表 404 与远程插件面板空白

DeepSeek Harness Web UI 连不上，三个典型现象：发送按钮一直灰（没选工作区）、/api/commands/list 返回 404（命令注册异常）、远程访问插件面板空白（插件管理仅限本机）。 分别对应三个根因，按「选工作区 → 本机管理插件 → 重启 Web 服务验证」处理。

DeepSeek Harness Web UI 连不上的三个现象

三个报错现象不同、根因不同：按钮灰是状态问题、404 是接口问题、面板空白是访问方式问题。 逐一说明（来源）：

1. 发送按钮一直灰——打开 Web UI，输入框可输入但发送按钮不可点；多发生在刚启动或新建 profile 时；
2. /api/commands/list 返回 404——命令菜单为空，浏览器直接访问该接口返回 404；多发生在新装插件后；
3. 远程插件面板空白——从局域网 IP 或隧道访问 Web UI，「设置 → 插件」静默空白，无任何提示；
4. 三者都可能被误判为「Web UI 坏了」，但修复方向完全不同，先对号入座。

DeepSeek Harness Web UI 连不上根因：没选工作区 + 插件管理仅限本机 + 命令接口异常

三条根因：web profile 没选工作区禁用发送；插件管理与本机文件系统绑定、远程访问不提供；命令接口因插件注册未生效而 404。 展开说：

1. 没选工作区：web profile 要先选工作区才能发送——没有工作区，Agent 就没有可操作目录，发送被禁用（来源）；
2. 插件管理仅限本机：从另一台机器打开 Web UI 时插件面板静默空白——插件管理绑定本机文件系统，dsh web 默认只监听 127.0.0.1（来源），远程浏览器可以聊天，但插件的增删必须本机操作（来源）；
3. 命令接口异常：/api/commands/list 404 是插件清单自动发现机制坏了，命令没注册上（来源）——常见于插件装完未重启、或插件本身没激活。

解决 DeepSeek Harness Web UI 连不上：选工作区 → 本机管理插件 → 重启验证

按报错分流：按钮灰就选工作区，面板空白就回本机操作，404 就重装插件并重启服务。 逐步执行：

1. 选工作区（解决发送按钮灰）——在 Web UI 顶部找到「选择工作区」，点开并选中一个目录：
   • 点击「选择工作区」按钮；
   • 在文件选择器里选中一个项目目录（或新建一个空目录）；
   • 选中后发送按钮应恢复可点，输入框可正常输入。
2. 本机管理插件（解决远程面板空白）——回到运行 dsh 的那台机器，浏览器访问 http://127.0.0.1:3080，在「设置 → 插件」里做安装/卸载/更新；远程浏览器只用于查看与对话，插件的增删必须本机操作（来源）。
3. 重装插件并重启 Web 服务（解决 commands/list 404）——在「设置 → 插件」里把相关插件重装一次，然后在终端重启 Web 服务：
   bash

   # 在运行 dsh 的终端按 Ctrl+C 停止，再执行：
   dsh web
   

   等待终端出现 http://127.0.0.1:3080 提示后刷新浏览器。
4. 验证接口——浏览器访问 http://127.0.0.1:3080/api/commands/list：
   • 返回 200 与 JSON 数据 → 命令菜单恢复；
   • 仍 404 → 检查插件是否激活（见「DSH plugin 装了不激活」排查），仍未解决就把报错反馈（来源）。
5. 排除旧实例干扰——仍异常就检查端口占用：lsof -i :3080（macOS/Linux）或 netstat -ano | findstr :3080（Windows），杀掉旧进程重启，方法见「3080 端口被占用」排查。

DeepSeek Harness Web UI 修复后怎么验证？接口三查与整链对话

修复后先做三查：命令接口返回 200、服务正常监听、工作区已生效——再用一次真实对话收尾，全部通过才算连上。 按顺序执行：

1. 查命令接口——浏览器或终端访问：

   bash

   curl -i http://127.0.0.1:3080/api/commands/list
   

   返回 HTTP/1.1 200 与 JSON 数据即命令菜单恢复；仍 404 说明插件还没激活或没重启，回上节第 3 步。

2. 查服务监听：

   bash

   lsof -i :3080
   

   输出里 dsh 进程在 LISTEN 状态即服务正常；无输出或 PID 冲突说明还有旧实例问题，回上节第 5 步。

3. 查工作区已生效——Web UI 顶部「选择工作区」处已显示目录名，发送按钮恢复可点、不再是灰色。

4. 整链对话收尾——在会话里发一条测试消息，能正常发送并收到回复，即 Web UI 真正连上。

5. 远程场景复核（可选）——远程访问时「设置 → 插件」空白是设计如此：在 dsh 所在本机确认插件管理正常，远程浏览器能聊天即可。

注意事项：DeepSeek Harness Web UI 连不上先对号入座

1. 发送按钮灰先选工作区，别急着重装——这是最常被误修的状态问题。
2. 远程面板空白是设计如此，不是故障——插件管理请回本机。
3. /api/commands/list 404 先重装插件再重启服务，命令注册随插件激活生效。
4. 回本机用「设置 → 插件市场」（DSH Plugin Hub）管理插件最省事——可视化安装/卸载/更新，失败原因一目了然。
5. 其他安装报错可参考安装报错排查。

来源：dshbase 常见问题排错、DeepSeek Harness apps/web、DeepSeek Harness README