乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > DeepSeek DSH 本地部署文档(Windows)

DeepSeek DSH 本地部署文档(Windows)

当前时间： 1970-01-01 08:00:00 分类：办公文件 评论(0)
DeepSeek DSH 本地部署文档(Windows)

DeepSeek DSH 本地部署文档（Windows）

工具版本：@deepseek-ai/dsh@0.1.0‑rc.7文档说明：完整安装部署、排错、启动运维手册。 ⚠️ 重要已知问题：该预发布RC版本在Windows下全局安装成功，但不会自动生成 dsh.cmd 启动垫片脚本，直接执行dsh命令提示“不是内部或外部命令”，本文提供两种解决方案。

环境要求

项目
说明
Node.js
≥16.x，LTS稳定版优先
操作系统
Windows10 / Windows11
网络
可访问npm镜像源，建议切换国内镜像
API密钥
前往 DeepSeek 开放平台申请生成 DEEPSEEK_API_KEY（sk‑开头）

Node.js下载地址：https://nodejs.org/ 安装时勾选 Add to PATH，安装完成新开终端验证：

node -vnpm -v

输出版本号即Node环境就绪。

1. 配置国内npm镜像源

解决下载慢、超时、网络报错，打开 CMD / PowerShell 执行：

# 设置npmmirror国内镜像npm config set registry https://registry.npmmirror.com# 校验镜像是否生效npm config get registry

输出 https://registry.npmmirror.com 代表配置成功。

2. 自定义npm全局路径（推荐，节省C盘空间）

将npm全局包安装到D盘，避免占用C盘用户目录。

# 设置全局安装根目录npm config set prefix D:\npm-global# 查看全局路径配置npm config get prefix

执行完成输出：D:\npm‑global。

操作：把 D:\npm‑global 添加到Windows用户环境变量PATH，保存后关闭全部终端窗口。

3. 全局安装 DeepSeek‑DSH

npm install -g @deepseek-ai/dsh@0.1.0-rc.7

安装日志示例

npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException insteadadded 530 packages in 3m120 packages are looking for funding  run `npm fund` for details
  • node‑domexception 废弃警告：不是错误，间接依赖过期，直接忽略，不影响任何功能。
  • added 530 packages：代表安装完成。

校验全局包是否真实安装

npm list -g @deepseek-ai/dsh

成功输出示例：

D:\npm-global`-- @deepseek-ai/dsh@0.1.0-rc.7

✅包本体已经安装；❌但是缺少dsh.cmd垫片脚本，直接敲dsh --version会报错。

4. 两种调用方案（解决dsh命令找不到bug）

方案一：npx调用（✅推荐，无需手动新建脚本）

npx直接读取已经下载好的全局包，不会重复下载，绕过垫片缺失问题。

# 查看dsh版本npx @deepseek-ai/dsh@0.1.0-rc.7 --version# 查看帮助信息npx @deepseek-ai/dsh@0.1.0-rc.7 --help# 命令行终端对话模式npx @deepseek-ai/dsh@0.1.0-rc.7 chat# 启动Web服务，默认端口3080npx @deepseek-ai/dsh@0.1.0-rc.7 web# 端口被占用时，指定自定义端口启动示例npx @deepseek-ai/dsh@0.1.0-rc.7 web --port 3081

Web访问地址：

  • 默认端口：http://127.0.0.1:3080
  • 自定义端口：http://127.0.0.1:3081

方案二：手动创建dsh.cmd，支持直接使用dsh命令

前提：D:\npm‑global 已经加入系统PATH；关闭所有终端，重新打开。

  1. 打开文件夹 D:\npm‑global
  2. 新建文本文档，复制下面内容：
@echo offnode "%~dp0node_modules\@deepseek-ai\dsh\lib\bin.js" %*
  1. 文件另存为：dsh.cmd，编码选择 ANSI，保存到D:\npm‑global。

可选PowerShell脚本 dsh.ps1（放在同样目录）

node "$PSScriptRoot/node_modules/@deepseek-ai/dsh/lib/bin.js" $args

新开终端测试：

dsh --versiondsh web

5. DeepSeek API‑KEY 配置

方式A：系统环境变量永久生效（推荐）

  1. Win+R，输入 sysdm.cpl → 高级 → 环境变量
  2. 在【用户变量】点击【新建】
    • 变量名：DEEPSEEK_API_KEY
    • 变量值：sk‑xxxxxxxxxxxxxxxx 你的API密钥
  3. 全部确定保存，关闭所有CMD/PowerShell，重新打开终端。

设置完成后，启动web/chat命令不需要重复设置密钥。

方式B：终端临时设置（关闭窗口就失效）

set DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

6. Windows一键启动脚本（bat双击运行）

桌面新建文本文档，替换为自己的API‑KEY；如果已经配置系统环境变量，可以注释set那一行。 另存为 DSH_启动.bat，编码选择 ANSI。

@echo off:: 如果系统环境变量已配置DEEPSEEK_API_KEY，可以注释下面一行set DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxnpx @deepseek-ai/dsh@0.1.0-rc.7 webpause

使用说明：双击bat文件；不要关闭黑色命令窗口，关闭窗口AI服务立刻停止，网页无法访问。

7. 运维、卸载、修复命令汇总

# 查看版本npx @deepseek-ai/dsh@0.1.0-rc.7 --version# 帮助文档npx @deepseek-ai/dsh@0.1.0-rc.7 --help# 完全卸载dshnpm uninstall -g @deepseek-ai/dsh# 清理npm缓存npm cache clean --force# 卸载后重新安装npm install -g @deepseek-ai/dsh@0.1.0-rc.7

8. 常见问题排查

  1. dsh 不是内部或外部命令

rc.7版本Windows缺陷，优先使用npx方式调用；或者手动生成dsh.cmd脚本。

  1. node‑domexception 废弃警告

属于依赖库提示，直接忽略，不影响业务功能。

  1. 网页打开报错401

API‑KEY错误、密钥没有权限；检查系统环境变量是否生效，重启终端。

  1. 端口3080被占用

使用 --port 参数指定其他端口启动。

  1. 安装速度慢

确认npm镜像已经切换npmmirror国内源。

  1. Node版本过低

升级Node.js到16及以上LTS版本。

完整快速上手流程复制版

#1 检查node环境node -vnpm -v#2 设置国内镜像npm config set registry https://registry.npmmirror.com#3 设置npm全局目录npm config set prefix D:\npm-global#4 全局安装DSHnpm install -g @deepseek-ai/dsh@0.1.0-rc.7#5 验证安装npm list -g @deepseek-ai/dsh#6 设置api key（或者配置系统环境变量）set DEEPSEEK_API_KEY=sk-xxx#7 启动web界面npx @deepseek-ai/dsh@0.1.0-rc.7 web