常见问题与故障排查 - DeepSeek Harness
遇到问题时，先分清「卡在哪一步」：启动、配置、还是运行。下面是高频问题与排查思路。
启动相关
命令找不到 / 版本不兼容
- 确认已安装 Node.js（
^20.19 || >=22）；源码安装还需要 pnpm - 快速体验使用
npx @deepseek-ai/dsh web，从源码安装后使用pnpm dsh web - 若
npx缓存了旧版本，可先npx @deepseek-ai/dsh@latest web
npx @deepseek-ai/dsh web 卡住 / 长时间无输出
- 先分清是不是真的卡住：首次运行
npx会先从 npm 下载@deepseek-ai/dsh包到本地缓存，网络慢时终端会停在下载阶段、看起来像卡住——首次请多等一会儿，或先用npm view @deepseek-ai/dsh version测试 npm 连通性 - 切换 npm 镜像源（国内网络的常用解法）：
npm config set registry https://registry.npmmirror.com，然后重试npx @deepseek-ai/dsh web - 确认 Node 版本：
node -v需满足^20.19 || >=22，版本过低可能静默失败、无任何输出 - 绕开旧缓存：改用
npx @deepseek-ai/dsh@latest web，或清理 npx/npm 缓存后重试 - 检查是不是其实已经启动：浏览器直接打开默认地址
http://127.0.0.1:3080；若端口被占用或已有实例在运行，按下面「端口被占用 / 地址不对」处理 - 公司代理 / 防火墙：拦截 npm 下载同样表现为卡住，配置好代理或更换网络后重试
- 仍完全无输出时，
Ctrl+C终止后重跑一次；若依旧卡住，把运行方式、Node 版本与终端输出原文带到 GitHub Discussions 求助
端口被占用 / 地址不对
- 默认地址是
http://127.0.0.1:3080，以命令实际打印的地址为准 - 端口被占用时，按命令行帮助调整端口或释放占用
配置相关
模型没有响应
- 确认已在 设置 → 模型 输入 DeepSeek API 密钥并保存
- 模型路由立即可用、无需重启；若仍无响应，检查密钥有效性与其他提供方配置
会话输入框不可用
- 这是因为尚未选择工作区：点击「选择工作区」，添加启动 dsh 时所在的项目目录并选中它
运行相关
操作被要求审批
- 当操作在当前权限策略下需要审批时，Web UI 会先询问你——这是预期行为，按需批准或拒绝即可
兼容性变更
还能去哪里求助
- GitHub Discussions：使用问题、Bug 反馈、功能建议 → discussions
- 官方文档：架构、开发与指南 → docs
- 社区交流：Discord / 企微群，入口见官方 README
相关阅读
报 Bug 的小建议
附上：运行方式（npx / 源码）、Node.js 版本、报错信息原文——信息越完整，定位越快。