DSH 报错修复中心
把终端里的完整报错原文输入搜索框，先在本页查看最快处理方式，再打开对应页面。每个页面只处理一个主要错误码或症状。
本页内容
每个错误页都从报错原文开始，再给最快修复、原因、源码依据、操作步骤和验证结果。搜索时优先粘贴 EADDRINUSE、MISSING_CREDENTIAL、UNKNOWN_MODEL、401、npm.ps1 等原始错误。
可以直接粘贴一整行终端报错。搜索在浏览器本地完成，不会上传你输入的错误文本。
MISSING_CREDENTIAL 错误
为当前会话使用的模型服务商保存凭据，再重新选择模型并重试。
UNKNOWN_MODEL 错误
选择当前模型服务商中真实存在的 Model ID，或先添加该模型再重试。
401 Authentication Failed
核对 Key、模型服务商 Base URL 和环境变量凭据，并把“获取模型”与聊天请求分开测试。
EADDRINUSE: address already in use 127.0.0.1:3080
找出占用 3080 的进程，或确认 Windows 保留端口冲突；只结束已确认的旧进程，否则直接换端口。
127.0.0.1:3080 无法打开
先确认 DSH 在本机还是远程服务器运行，再打开终端打印的准确地址，或建立 SSH 端口转发。
'node' Is Not Recognized
安装 DSH 支持的 Node.js，重新打开终端刷新 PATH，再确认 Node 可用。
npm / npx Is Not Recognized
修复 Node.js 安装或 PATH，直到 node、npm 和 npx 能在同一终端正常运行。
npm.ps1 Cannot Be Loaded
优先直接使用 Windows 的 .cmd 命令，不改执行策略；个人电脑也可以在确认风险后只调整 CurrentUser。
Browser Did Not Open Automatically
手动打开终端打印的本地 URL；自动拉起浏览器不是必要条件，SSH 还需要端口转发。
Select Model / 输入框不可用
完成三个必要设置：保存模型服务商凭据、选择工作区、选择模型。
Workspace Permission Denied
使用普通用户拥有的小型测试文件夹，先在 DSH 外确认读写正常，再检查当前权限设置。
GitHub 社区报错案例
桌面端启动失败、装插件后崩溃、主会话正常但子代理认证失败：查看 12 条原始记录整理的 11 个案例，核对适用版本与真实反馈。
打开社区案例库 →
按这个顺序排查
- 01
复制完整报错
保留终端最后一条有效错误、错误代码和你实际执行的命令，不要只写“打不开”或“不能用”。
- 02
匹配错误原文
优先匹配错误码和原句，例如 EADDRINUSE、MISSING_CREDENTIAL、UNKNOWN_MODEL、npm.ps1 cannot be loaded。
- 03
一次只改一处
每次只改一个设置，然后重新测试。这样才能知道到底是哪一步解决了问题。
- 04
改完只做一个简单测试
先在普通测试文件夹运行无害的小任务，不要第一步就在生产仓库、整个 Home 或敏感目录测试。
搜索不到这个报错怎么办
打开完整问题排查页，并记录操作系统、node --version、DSH 版本、启动命令和错误全文。提交到官方社区前，先删除 API Key、私有仓库名、用户名和敏感路径。