Edit: DeepSeek Harness 零基础安装教程

编辑文章

标题 *

URL 别名 *

内容 * (支持 Markdown 格式)

# DeepSeek Harness 零基础安装教程

> 写给不懂代码的朋友：从零开始，一步步教你装好 DeepSeek Harness。

## 什么是 DeepSeek Harness？

DeepSeek Harness（简称 DSH）是一个让你和 AI 对话的工具。你可以把它理解为：

- **ChatGPT 的网页版** → 但它是免费开源的
- **一个 AI 助手** → 它能帮你写代码、查资料、分析文档
- **本地运行** → 所有数据都在你自己电脑上，不上传到任何地方

要使用它，你需要两样东西：
1. 一台电脑（Mac 或 Windows 都行）
2. 一个 DeepSeek API 密钥（免费注册就能拿到）

---

## 第一步：安装 Node.js

Node.js 是 DSH 运行的基础环境，就像手机需要安装微信才能用微信一样。

### macOS 用户

1. 打开浏览器，访问 **https://nodejs.org/**
2. 点击页面上的 **"LTS"** 按钮（推荐版本），下载安装包
3. 双击下载的 `.pkg` 文件，一路点"继续"和"安装"
4. 安装完成后，打开 **"终端"**（在 Spotlight 搜索 "终端" 或 "Terminal"）
5. 输入以下命令，按回车：

```bash
node -v
```

6. 如果看到类似 `v22.x.x` 的版本号，说明安装成功 ✅

### Windows 用户

1. 打开浏览器，访问 **https://nodejs.org/**
2. 点击页面上的 **"LTS"** 按钮，下载安装包
3. 双击下载的 `.msi` 文件，一路点"下一步"和"安装"
4. 安装完成后，按 `Win + R`，输入 `cmd`，按回车打开命令提示符
5. 输入以下命令，按回车：

```bash
node -v
```

6. 如果看到类似 `v22.x.x` 的版本号，说明安装成功 ✅

---

## 第二步：获取 DeepSeek API 密钥

1. 打开浏览器，访问 **https://platform.deepseek.com/**
2. 点击右上角 **"注册"**，用手机号注册一个账号
3. 登录后，点击左侧菜单的 **"API Keys"**
4. 点击 **"创建 API Key"**，给它起个名字（比如 "我的DSH"）
5. 复制生成的密钥（一串以 `sk-` 开头的字符）
6. **重要：这个密钥只显示一次，记得保存好！**

---

## 第三步：安装 DeepSeek Harness

### macOS 用户

1. 打开 **"终端"**（Spotlight 搜索 "终端"）
2. 输入以下命令，按回车：

```bash
npx @deepseek-ai/dsh web
```

3. 第一次运行会自动下载，耐心等待几分钟
4. 看到类似这样的输出就说明启动成功了：

```
🚀 DeepSeek Harness Web UI is running at http://127.0.0.1:3080
```

5. 打开浏览器，访问 **http://127.0.0.1:3080**

### Windows 用户

1. 按 `Win + R`，输入 `cmd`，按回车打开命令提示符
2. 输入以下命令，按回车：

```bash
npx @deepseek-ai/dsh web
```

3. 第一次运行会自动下载，耐心等待几分钟
4. 看到类似这样的输出就说明启动成功了：

```
🚀 DeepSeek Harness Web UI is running at http://127.0.0.1:3080
```

5. 打开浏览器，访问 **http://127.0.0.1:3080**

---

## 第四步：首次配置

1. 浏览器打开后，你会看到 DSH 的界面
2. 点击左下角的 **"设置"**（齿轮图标）
3. 在 **"模型"** 部分，选择 **DeepSeek** 作为模型
4. 在 **"API Key"** 输入框中，粘贴你刚才复制的密钥
5. 关闭设置页面

---

## 第五步：开始使用

1. 点击左侧的 **"新建对话"** 按钮
2. 在底部输入框输入你的问题，比如：

```
你好，帮我写一首关于秋天的诗
```

3. 按回车发送，AI 会开始回答
4. 等待几秒钟，你就能看到 AI 的回复了 🎉

---

## 常见问题

### Q：输入 `node -v` 提示 "command not found"

**原因**：Node.js 没有安装成功，或者没有添加到系统路径。

**解决**：
- 重新下载安装 Node.js
- 安装完成后，**关闭并重新打开**终端/命令提示符
- 如果还是不行，重启电脑再试

### Q：输入 `npx @deepseek-ai/dsh web` 提示 "npx: command not found"

**原因**：Node.js 版本太旧（需要 22.x 或更高）。

**解决**：
1. 访问 https://nodejs.org/ 重新下载最新 LTS 版本
2. 安装完成后重启终端

### Q：浏览器打不开 http://127.0.0.1:3080

**原因**：DSH 可能没有启动成功，或者端口被占用。

**解决**：
1. 检查终端是否显示 "running at http://127.0.0.1:3080"
2. 如果没有，按 `Ctrl + C` 停止当前进程，重新运行 `npx @deepseek-ai/dsh web`
3. 如果提示端口被占用，试试：`npx @deepseek-ai/dsh web --port 3081`

### Q：输入问题后没有反应

**原因**：API 密钥可能没有配置正确。

**解决**：
1. 检查设置中的 API Key 是否正确粘贴
2. 确认 API Key 没有过期
3. 检查网络连接是否正常

### Q：提示 "DEEPSEEK_API_KEY" 相关错误

**原因**：API 密钥未设置或无效。

**解决**：
1. 重新生成一个 API Key：https://platform.deepseek.com/
2. 在 DSH 设置中重新输入新的密钥

---

## 小贴士

- **免费额度**：DeepSeek API 有免费额度，个人使用基本够用
- **数据安全**：DSH 在本地运行，你的对话内容不会上传到 DeepSeek 服务器
- **插件系统**：DSH 支持安装插件扩展功能，但目前还是开发者预览版，插件生态还在建设中
- **保持更新**：DSH 还在快速迭代，建议定期运行 `npx @deepseek-ai/dsh web` 获取最新版本

---

## 进阶：一键启动脚本

如果你觉得每次都要输入命令太麻烦，可以创建一个一键启动脚本：

### macOS 用户

1. 打开终端，输入：

```bash
echo '#!/bin/bash
npx @deepseek-ai/dsh web' > ~/start-dsh.sh
chmod +x ~/start-dsh.sh
```

2. 以后只需要运行 `~/start-dsh.sh` 就能启动 DSH

### Windows 用户

1. 在桌面新建一个文本文件，命名为 `start-dsh.bat`
2. 用记事本打开，输入：

```batch
npx @deepseek-ai/dsh web
```

3. 保存文件，以后双击这个文件就能启动 DSH

---

*最后更新：2026年8月18日*
*作者：广山哥*

配图 (可多选)

选择新图片文件或拖拽到此处

标签