本教程将详细介绍如何在 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安装程序,然后:
- 双击运行安装程序
- 接受许可协议
- 选择安装路径(建议保持默认)
- 设置 Node.js 的安装路径(建议保持默认)
- 完成安装后重启终端
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,也可以选择传统安装方式:
- 双击下载的 .msi 安装文件
- 点击 "Next" 接受许可协议
- 选择安装路径(默认即可)
- 勾选 "Automatically install the necessary tools"(自动安装必要工具)
- 点击 "Install" 开始安装
- 安装完成后点击 "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 nodemon6. 常见问题解决
6.1 问题一:命令未找到
如果输入node --version或npm --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
- 登录后完成实名认证
- 创建 API Key 并进行充值
- 将创建的 API Key 妥善保存
- 返回 DeepSeek-harness 页面,将 API Key 粘贴到指定位置
3. 配置工作环境
- 创建工作文件夹,建议为每个项目创建独立的文件夹
- 根据个人需求选择模型和模式配置
- 完成配置后即可正常使用 DeepSeek-harness
4. 开始使用
配置完成后,你就可以开始使用 DeepSeek-harness 进行开发了。建议先尝试一些简单的 API 调用,熟悉工具的基本功能和使用方法。
5. 配置桌面快捷方式
为了方便后续启动 DeepSeek-harness,可以创建桌面快捷方式:
- 在桌面空白处右键,选择“新建” → “快捷方式”
- 在“请键入对象的位置”中输入:
npx @deepseek-ai/dsh web - 点击“下一步”,为快捷方式命名(如“DeepSeek-harness”)
- 点击“完成”创建快捷方式
- 关闭之前运行的终端窗口
- 双击新建的快捷方式启动 DeepSeek-harness
注意:运行期间不要关闭启动的终端窗口。
如需为快捷方式添加图标:
- 访问 DeepSeek官网
- 右键保存小黑鱼图标
- 将图片转换为 .ico 格式
- 右键快捷方式 → “属性” → “更改图标” → 选择转换后的图标文件