报错排查

解决 DeepSeek Harness 常见报错：API key 缺失、端口占用、插件解析失败、profile patch 冲突。

5 篇

dsh 的凭证存在哪、为什么 apiKeyEnv 填的是变量名不是 key、为什么 export 了但已在跑的进程读不到，以及怎么端到端验证一个自定义服务商。

npm 全局 bin 目录不在 PATH 上、安装其实失败了、或者你装进了一个已经不用的 Node 版本。怎么分辨，以及各自怎么修。

npm install -g 报 EACCES 的原因、为什么 sudo 会让事情更糟，以及两个干净的修法——把 npm prefix 指到你自己的目录，或者用 Node 版本管理器。

装好的 Cordis 插件为什么没出现在 agent 里：解析顺序、按 profile 隔离的 node_modules、缺一行 patch、或者被更高的 patch 层覆盖。用 --dump-config 定位。

DeepSeek Harness 网页端绑在 127.0.0.1:3080。怎么找出占用端口的进程、怎么正确传 --port（参数顺序有讲究）、以及怎么让换端口这件事固化下来。