DeepSeek Harness 排错
首次失败多半是环境问题，而不是「模型坏了」。按顺序查：Node 版本 → 拉包 → 本地端口 → API 凭证 → 工作区权限。命令与参数仍以官方 README 为准；本页把操作清单改写成可检索的排错页。装不上插件时配合安装页与插件指南。
找不到 node / engines 不满足
上游预览要求 Node.js ^22.19.0 或 >=24.0.0。先 node -v。没有二进制就从 nodejs.org 或系统包管理器装 LTS，并重开终端刷新 PATH。nvm/fnm 必须在同一 shell 里选好版本再跑 npx。过旧的 18/20 可能拉到包后在 engines 检查失败。
npx 很慢、404 或版本过旧
首次会拉大量 npm 依赖。网络不稳就换稳定线路。镜像落后官方时加 --registry=https://registry.npmjs.org。npx 缓存到老 rc 就清缓存。包名是 @deepseek-ai/dsh，不要写错 scope。
提示没有 pnpm
即便用 npx 启动，插件增删也常会调 pnpm。先 npm install -g pnpm，并保证全局 bin 在 PATH。源码安装路径是 pnpm install && pnpm run build && pnpm dsh web。
3080 被占用 / 打不开 UI
Web UI 常见地址是 http://127.0.0.1:3080/。端口被占就结束进程，或按上游文档换端口（社区常见 dsh web --port 8080）。第一次请留在 localhost。空白页也可能是浏览器扩展拦截本地脚本，换干净配置文件试一次。
发消息后 API 报错
本地 UI 默认不是本地推理，走 DeepSeek 路由需要平台密钥。核对模型 ID、额度、粘贴时有没有空格。无头/CLI 可能读 $DSH_HOME/.credentials.yaml（常为 ~/.dsh/.credentials.yaml）。Unix 上权限过宽可能导致运行时拒绝凭证文件，chmod 600。本站不发放密钥。
Agent 看不到文件 / 权限过宽
重新选择工作区根目录。在项目目录里启动 npx 有助于默认路径，但仍要在设置里确认。第一次不要指向整个用户主目录。macOS TCC、Windows 受控文件夹可能静默拦截写入。
插件 add 失败或没有变化
对照插件 README 的 dsh plugin add 行（github:owner/repo 还是 npm 名）。安装后重载 profile。Cordis 解析失败通常出现在启动 dsh 的终端，而不一定在聊天框。见插件指南与精选卡片。
升级后预览版行为变了
开发者预览会破坏兼容。评估时钉版本，重读 GitHub README，对比升级前后 Trajectory。不要假定上周博文里的 CLI 参数仍然有效。
还是不行
用完整报错字符串去 deepseek-ai/deepseek-harness 的 Discussions 搜。OS 一键命令回安装页；已知安装命令看社区插件；还在犹豫框架选型则看对比页。
相关 DeepSeek Harness 页面
重走安装步骤、若工具行为异常可查看运行模式，或在换框架前阅读 FAQ。