DeepSeek Harness Web 界面无法启动

如果 npx @deepseek-ai/dsh web 直接退出、长时间无响应，或者显示已启动但页面打不开，请按下面的顺序检查。保留终端的原始输出，最早出现的错误通常比后续现象更有价值。

确认命令无误

准确运行官方软件包：

npx @deepseek-ai/dsh web

不要替换成名称相近的社区软件包。首次运行时，npx 可能会询问是否允许下载。

检查 Node.js 和 npm

node --version
npm --version

如果任一命令不存在，请安装当前 Node.js LTS 版本。如果 Node 版本较旧，升级后打开新的终端，再次检查版本，然后重试 Harness。

区分下载错误和启动错误

与软件包解析、注册表、DNS、证书或代理有关的信息，发生在 Harness 启动之前。请检查 npm 注册表和网络策略。公司网络的 TLS 检查也可能阻止 npm 下载；应采用组织批准的配置，不要通过关闭证书验证来绕过安全检查。

如果软件包已经下载，终端也打印了本地地址，启动器通常已经成功运行。

打开终端打印的本地地址

当前预览版通常使用 http://127.0.0.1:3080，但应以终端输出为准。把该地址复制到运行命令的同一台电脑上打开。127.0.0.1 指向当前机器，不会自动允许其他设备访问。

检查端口冲突

如果看到 “address already in use” 或 EADDRINUSE，说明请求的端口已被其他进程占用。停止之前运行的 Harness，或先查清哪个本地进程占用了端口。不要在不知道进程用途时直接结束它。

保持终端运行

关闭终端或按 Ctrl+C 会停止本地服务。如果页面曾经正常、随后无法访问，请重新运行命令，并保持该进程开启。

何时提交上游问题

如果在当前 Node.js 版本上使用准确命令仍能稳定复现，请收集操作系统、Node 版本、命令、完整错误输出和最小复现步骤。删除密钥、路径和仓库内容后，再提交到官方问题追踪器。