第一步:装
只有一件事要确认:node版本够不够。0.2.2系列要 >=24.9.0,0.2.1系列不限。这一步百分之八十的失败都在这。
node -v npm i -g @deepseek-ai/dsh
卡点:看到EBADENGINE就当没事,装完起不来才回头查。看到这四个字母就该停。
第二步:启
启动会打印一行带token的地址。这一步的卡点不是命令写错,而是复制地址时只复制了域名——token丢了就401。
dsh web
卡点二:3080端口被上一次没退干净的进程占着。报错通常是EADDRINUSE或直接退出,先 netstat -ano | findstr :3080。
第三步:验
能打开界面不等于跑通,要能发出指令并拿回结果。最小冒烟任务用一句话就够:
列出当前目录下的文件和文件夹,只报数量和前三个名字
卡点:没配模型就发指令,会得到一个看起来像网络错误的报错。先去模型与网关那组把key配好,回头再验这一步。
三步都过之后再谈改配置、装插件。顺序反了,出问题时你分不清是环境坏还是插件坏。
一条命令自检(可选)
把关键信息一次打出来,出问题时直接贴这段的输出问人:
node -v && npm ls -g @deepseek-ai/dsh --depth=0 ; curl -sI http://127.0.0.1:3080/ | head -1
最后一行返回 HTTP/1.1 401 说明服务活着;返回connection refused说明没起来。