DSH Web UI 启动失败：从环境到端口逐项排查

先保存完整错误原文

不要只记录“打不开”。保存执行的命令、工作目录、第一条错误、最后一条错误、运行时版本和操作系统。截图适合保留界面，但可复制的错误文本更适合搜索和比较。

在公开求助前删除用户名、目录中的客户名称、Token、Cookie、内网地址和其他敏感信息。

确认命令和运行时

官方启动命令是 npx @deepseek-ai/dsh web，默认地址是 http://127.0.0.1:3080。0.1.0-rc.5 要求 Node.js ^22.19.0 || >=24.0.0。确认当前终端实际调用的是预期 Node.js，而不是系统中另一个旧版本。详细步骤见安装与 Web UI 指南。

排查端口和残留进程

如果日志提示端口被占用，先确认占用者是否是另一个仍在运行的 DSH 实例。不要为了释放端口批量结束不认识的系统进程。优先正常关闭旧实例，或使用 --port 选择另一个端口。具体命令与 Host 限制见3080 端口占用修复。

区分网络、权限和配置问题

下载依赖失败通常与网络、代理或证书有关；写入失败通常与目录权限或安全软件有关；启动后模型不可用则更可能是配置或凭据问题。一次只改变一个变量，并记录变化后的错误。

页面打开但输入框不可用时，先检查是否选择了 Workspace。启动后模型不可用时，按模型与 Provider 配置检查凭据和路由。

修复后重新执行一个最小任务，确认界面、日志和产物都正常。如果问题仍然存在，把脱敏后的环境、命令、错误和已尝试步骤一起提交，而不是重复执行未经理解的修复脚本。