DSH 出现 MISSING_CREDENTIAL 或模型 401 怎么修复
区分 DeepSeek Harness 的 MISSING_CREDENTIAL、UNKNOWN_MODEL、模型目录 401、仅搜索 401 和网关请求兼容性问题，说明 0.2.0 账号登录后的网页搜索凭据，安全检查 API Key、Provider 与模型。
- 难度
- 入门
52DSH 内容库
按故障阶段排查 DeepSeek Harness 错误
按安装、启动、端口、Workspace、模型凭据和插件阶段查找 DeepSeek Harness（DSH）错误原因、修复步骤、验证与回滚方法。
当前收录 8 篇 · 持续复查版本与来源
带着错误来
粘贴错误原文，先缩小发生阶段
建议保留错误码和关键英文，不要粘贴 Token、Cookie、用户名或客户目录。
找到 8 篇相关排障内容
DSH Web UI 输入框不可用：先选择 Workspace
按未添加、未选中、选择报错与任务失败四种状态排查 DSH 工作区；保留 rc.1 操作，补充 0.1.7-alpha.1 首次默认工作区的触发条件。
- 适合
- 页面能打开但无法开始对话的用户
- 完成后
- 为当前 Session 选择明确的 Workspace、用只读任务确认访问范围
- 难度
- 入门
DSH Web UI 启动失败：从环境到端口逐项排查
DSH 安装卡住或 Web UI 打不开时，按 npx 下载、ETARGET、pnpm PATH、服务启动、浏览器连接和模型任务六个阶段排查。
- 适合
- DSH Web UI 无法打开或无法继续使用的用户
- 完成后
- 按症状确定错误发生阶段、进入对应的精确修复页面
- 难度
- 入门
DSH 升级后会话打不开：迁移失败、未知事件与恢复排查
区分 DSH 升级后旧会话迁移失败、新会话没反应、预设 prefix 缺失与 0.1.7-rc.1 会话被占用，按 provenance 等错误分流，提供备份边界和可复制的脱敏故障记录。
- 难度
- 中等
DeepSeek Harness 3080 端口占用：修改端口与 Host 限制
解决 DSH Web UI 默认 3080 端口占用，提供 Windows、macOS、Linux 只读检查命令、--port 修复、验证与回滚方法。
- 适合
- 终端明确报告 3080 地址被占用的用户
- 完成后
- 只读识别 3080 监听进程、安全停止旧 DSH 或切换新端口
- 难度
- 入门
DSH 提示 Node 版本不支持或 npx 找不到怎么办
解决 DeepSeek Harness 对 Node.js 版本范围不匹配、npx 不可用、终端 PATH 指向旧 Node 和固定版本 DSH 无法启动的问题。
- 难度
- 入门
Node.js 环境看似正常但 DSH 命令不可用怎么办
当 Node.js 能运行但 DeepSeek Harness（DSH）、npm 或 npx 命令不可用时，按版本、路径、终端和 npm 分发状态逐项定位问题。
- 难度
- 入门
DSH 安装 Git 插件被 allowBuilds 阻止怎么办
解释 DeepSeek Harness 安装 Git 插件时 pnpm allowBuilds 阻止 prepare 的原因，如何审阅精确包键、修改 Profile 配置、重试与回退。
- 难度
- 中等