跳到正文
MyDSH我的 DSH 实战笔记
English
独立维护,非DeepSeek官方;与mydsh.dev等其他MyDSH站点无关联。

首页/起步与安装/安装与启动

三步跑通清单:每一步最容易卡在哪

只想尽快看到界面,不想读完整手册。这页把「装、启、验」压成三步,每步标出真实卡点。

已核验版本与环境核验日期2026-11-14
宿主版本
0.2.2-rc.1 / 0.2.1-rc.5 / 源码checkout三条路
核验日期
2026-11-14

可复制指令

node -v && npm ls -g @deepseek-ai/dsh --depth=0

第一步:装

只有一件事要确认: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说明没起来。

怎么算跑通

照着逐条对,全过才算完成。有一条没过,先解决它再往下。

  • 三步各自的检查都通过
  • 冒烟任务能返回结果(不是报错)
  • 把自检命令的输出存一份,出问题时能对上

会失败在哪

现象 / 原因 / 怎么办,按实际踩到的顺序写。

现象原因怎么办
界面打开了但发指令报错模型与key还没配,报错长得像网络问题先去「模型、权限与安全」组配好key,再回来验这一步
第三步一直卡住不动请求发出去了但网关不可达,或key无权限查网关地址与key的可用额度,别急着重装

来源

标「已核验」的,来自本站实跑;标「公开资料整理」的,逐条附出处。