DeepSeek--harness安装使用教程
2026/8/17 18:58:57 网站建设 项目流程

本教程将详细介绍如何在 Windows 系统上配置 DeepSeek-harness。

一、准备工作

1. 下载 Node.js

访问 Node.js 官网,选择 Windows 系统的安装包:

  • Windows:下载 .msi 安装程序(推荐)或 .zip 压缩包

强烈推荐开发者使用 nvm(Node Version Manager)进行安装和管理,它可以让你在同一台机器上轻松切换多个 Node.js 版本,避免全局安装带来的权限问题和版本冲突。

2. 使用 nvm 安装 Node.js(推荐)

nvm(Node Version Manager)是 Node.js 版本管理工具,特别适合开发者在同一台机器上管理多个 Node.js 版本。

2.1 Windows 系统安装 nvm

访问 nvm-windows 发布页面,下载最新版本的nvm-setup.exe安装程序,然后:

  1. 双击运行安装程序
  2. 接受许可协议
  3. 选择安装路径(建议保持默认)
  4. 设置 Node.js 的安装路径(建议保持默认)
  5. 完成安装后重启终端

2.2 使用 nvm 安装和管理 Node.js

# 查看可安装的 Node.js 版本 nvm list available 安装最新 LTS 版本 nvm install --lts 安装特定版本 nvm install 20.15.0 查看已安装的版本 nvm list 切换使用某个版本 nvm use 20.15.0 设置默认版本 nvm alias default 20.15.0 查看当前使用的版本 node --version

优势:

  • 无需管理员权限即可安装 Node.js
  • 轻松切换不同项目所需的 Node.js 版本
  • 避免全局安装导致的权限问题
  • 一键安装/卸载不同版本

3. Windows 系统安装步骤(传统方式)

如果不使用 nvm,也可以选择传统安装方式:

  1. 双击下载的 .msi 安装文件
  2. 点击 "Next" 接受许可协议
  3. 选择安装路径(默认即可)
  4. 勾选 "Automatically install the necessary tools"(自动安装必要工具)
  5. 点击 "Install" 开始安装
  6. 安装完成后点击 "Finish"

注意:如果已经使用 nvm 安装了 Node.js,则无需再通过此方式安装。

4. 验证安装是否成功

安装完成后,打开终端(Windows 使用命令提示符或 PowerShell)并执行以下命令:

# 检查 Node.js 版本 node --version 检查 npm 版本 npm --version 运行简单的 JavaScript 代码 node -e "console.log('Node.js 安装成功!')"

如果看到类似v20.15.0(Node.js 版本)和10.7.0(npm 版本)的输出,说明安装成功。

5. 配置 npm(可选)

为了提高下载速度和设置默认配置,可以执行以下命令:

# 设置 npm 镜像源(国内用户推荐) npm config set registry https://registry.npmmirror.com 查看当前配置 npm config list 全局安装常用工具 npm install -g nodemon

6. 常见问题解决

6.1 问题一:命令未找到

如果输入node --versionnpm --version提示 "command not found":

  • 检查环境变量 PATH 是否包含 Node.js 安装路径
  • 如果使用 nvm 安装,确保已重启命令提示符或 PowerShell
  • 尝试在终端中运行nvm use命令切换版本

6.2 问题二:权限不足

在 Windows 上安装全局包时可能出现权限错误:

# 解决方案:以管理员身份运行命令提示符或 PowerShell # 然后重新执行安装命令 npm install -g 包名 或者修改 npm 全局安装目录权限 npm config set prefix "C:\Users\你的用户名\AppData\Roaming\npm"

二、安装 DeepSeek-harness 本体

1. 下载安装

访问 DeepSeek 官网,进入 DeepSeek-harness 页面:

复制页面上的安装命令到终端运行,建议在命令中加入--verbose参数方便查看安装进度:

键入 y 开始下载,这个过程可能需要较长时间,请耐心等待:

注意:中途不要关闭终端

安装完成后,终端会显示一个 HTTP 链接,复制该链接到浏览器打开,或按 Ctrl + 左键单击直接访问。

2. 启动服务

打开浏览器后,按照页面提示完成初始设置,然后进入 API Key 创建页面。

三、创建 API Key

1. 登录 DeepSeek 开发平台

访问 DeepSeek 开发平台,使用手机号或微信登录:

2. 创建 API Key

  1. 登录后完成实名认证
  2. 创建 API Key 并进行充值
  3. 将创建的 API Key 妥善保存
  4. 返回 DeepSeek-harness 页面,将 API Key 粘贴到指定位置

3. 配置工作环境

  1. 创建工作文件夹,建议为每个项目创建独立的文件夹
  2. 根据个人需求选择模型和模式配置
  3. 完成配置后即可正常使用 DeepSeek-harness

4. 开始使用

配置完成后,你就可以开始使用 DeepSeek-harness 进行开发了。建议先尝试一些简单的 API 调用,熟悉工具的基本功能和使用方法。

5. 配置桌面快捷方式

为了方便后续启动 DeepSeek-harness,可以创建桌面快捷方式:

  1. 在桌面空白处右键,选择“新建” → “快捷方式”
  2. 在“请键入对象的位置”中输入:npx @deepseek-ai/dsh web
  3. 点击“下一步”,为快捷方式命名(如“DeepSeek-harness”)
  4. 点击“完成”创建快捷方式
  5. 关闭之前运行的终端窗口
  6. 双击新建的快捷方式启动 DeepSeek-harness

注意:运行期间不要关闭启动的终端窗口。

如需为快捷方式添加图标:

  1. 访问 DeepSeek官网
  2. 右键保存小黑鱼图标
  3. 将图片转换为 .ico 格式
  4. 右键快捷方式 → “属性” → “更改图标” → 选择转换后的图标文件

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询