常见问题与故障排查 - DeepSeek Harness
遇到问题时，先分清「卡在哪一步」：启动、配置、还是运行。下面是高频问题与排查思路。
启动相关
命令找不到 / 版本不兼容
- 确认已安装 Node.js（
^20.19 || >=22）；源码安装还需要 pnpm - 快速体验使用
npx @deepseek-ai/dsh web，从源码安装后使用pnpm dsh web - 若
npx缓存了旧版本，可先npx @deepseek-ai/dsh@latest web
端口被占用 / 地址不对
- 默认地址是
http://127.0.0.1:3080，以命令实际打印的地址为准 - 端口被占用时，按命令行帮助调整端口或释放占用
配置相关
模型没有响应
- 确认已在 设置 → 模型 输入 DeepSeek API 密钥并保存
- 模型路由立即可用、无需重启；若仍无响应，检查密钥有效性与其他提供方配置
会话输入框不可用
- 这是因为尚未选择工作区：点击「选择工作区」，添加启动 dsh 时所在的项目目录并选中它
运行相关
操作被要求审批
- 当操作在当前权限策略下需要审批时，Web UI 会先询问你——这是预期行为，按需批准或拒绝即可
兼容性变更
还能去哪里求助
- GitHub Discussions：使用问题、Bug 反馈、功能建议 → discussions
- 官方文档：架构、开发与指南 → docs
- 社区交流：Discord / 企微群，入口见官方 README
相关阅读
报 Bug 的小建议
附上：运行方式（npx / 源码）、Node.js 版本、报错信息原文——信息越完整，定位越快。