Harness 常见问题

终端找不到 node、npm 或 npx

先安装符合要求的 Node.js，再关闭并重新打开终端。仍然找不到时，记录完整提示和系统版本，请负责人检查安装路径。不要通过关闭系统安全策略或使用 sudo 来绕过问题。

Windows 若提示 npx.ps1 无法执行，可以在同一目录改用命令提示符（Command Prompt）运行启动命令，不必直接更改系统的 PowerShell 执行策略。

浏览器打不开，或提示端口已被占用

先看启动终端是否还在运行、有没有报错。只有服务启动后，本地地址才可访问；停止服务后刷新页面失败是正常的。

提示 EADDRINUSE 表示端口已被其他进程占用。先确认是否已启动过 Harness；不要随意结束不认识的进程。需要另开服务时，可使用下面的命令换一个端口，并访问这次打印的地址。

npx @deepseek-ai/dsh web --port 3081

页面打开了，却不能输入任务

先检查是否选中了工作区，再检查是否选中了可用模型。一个新启动的页面不会因为终端在项目目录就自动选好工作区。

如果你删除过供应商，原来的默认模型可能已失效。重新选模型并新建会话，再发一次只读请求。

密钥、模型或网络报错

• MISSING_CREDENTIAL：到设置的模型页面确认密钥已保存，不要把密钥当消息发给 AI。
• UNKNOWN_MODEL：重新选择已配置的模型；自定义网关请负责人确认模型 ID。
• 401 或认证失败：核对密钥来源及配套服务。余额、额度或限流问题由密钥所有者检查。
• 超时或连接失败：先核对网络和服务地址，保留原始报错；不要一次改动地址、协议、模型与代理。

想请人帮忙，需要提供什么

不要附上整个凭据文件或真实 API 密钥。页面与文档不一致时，附上不含敏感信息的截图；请先确认所用版本，不要反复重装或清空配置。

本教程核对的是官方文档与 npm 包信息，未替你运行真实模型请求。不同系统和预览版本可能仍需单独排查。

操作系统：
Node.js 版本（node --version）：
启动命令：
终端显示的 Harness 版本（如有）：
出错步骤：
完整报错（遮盖密钥、个人信息和私有地址）：
已尝试的检查：