DeepSeek Harness 零基础安装教程
写给不懂代码的朋友：从零开始，一步步教你装好 DeepSeek Harness。
什么是 DeepSeek Harness？
DeepSeek Harness（简称 DSH）是一个让你和 AI 对话的工具。你可以把它理解为：
- ChatGPT 的网页版 → 但它是免费开源的
- 一个 AI 助手 → 它能帮你写代码、查资料、分析文档
- 本地运行 → 所有数据都在你自己电脑上，不上传到任何地方
要使用它，你需要两样东西：
- 一台电脑（Mac 或 Windows 都行）
- 一个 DeepSeek API 密钥（免费注册就能拿到）
第一步：安装 Node.js
Node.js 是 DSH 运行的基础环境，就像手机需要安装微信才能用微信一样。
macOS 用户
- 打开浏览器，访问 https://nodejs.org/
- 点击页面上的 "LTS" 按钮（推荐版本），下载安装包
- 双击下载的
.pkg文件，一路点"继续"和"安装" - 安装完成后，打开 "终端"（在 Spotlight 搜索 "终端" 或 "Terminal"）
- 输入以下命令，按回车：
node -v
- 如果看到类似
v22.x.x的版本号，说明安装成功 ✅
Windows 用户
- 打开浏览器，访问 https://nodejs.org/
- 点击页面上的 "LTS" 按钮，下载安装包
- 双击下载的
.msi文件，一路点"下一步"和"安装" - 安装完成后，按
Win + R，输入cmd，按回车打开命令提示符 - 输入以下命令，按回车：
node -v
- 如果看到类似
v22.x.x的版本号，说明安装成功 ✅
第二步：获取 DeepSeek API 密钥
- 打开浏览器，访问 https://platform.deepseek.com/
- 点击右上角 "注册"，用手机号注册一个账号
- 登录后，点击左侧菜单的 "API Keys"
- 点击 "创建 API Key"，给它起个名字（比如 "我的DSH"）
- 复制生成的密钥（一串以
sk-开头的字符） - 重要：这个密钥只显示一次，记得保存好！
第三步：安装 DeepSeek Harness
macOS 用户
- 打开 "终端"（Spotlight 搜索 "终端"）
- 输入以下命令，按回车：
npx @deepseek-ai/dsh web
- 第一次运行会自动下载，耐心等待几分钟
- 看到类似这样的输出就说明启动成功了：
🚀 DeepSeek Harness Web UI is running at http://127.0.0.1:3080
- 打开浏览器，访问 http://127.0.0.1:3080
Windows 用户
- 按
Win + R，输入cmd，按回车打开命令提示符 - 输入以下命令，按回车：
npx @deepseek-ai/dsh web
- 第一次运行会自动下载，耐心等待几分钟
- 看到类似这样的输出就说明启动成功了：
🚀 DeepSeek Harness Web UI is running at http://127.0.0.1:3080
- 打开浏览器，访问 http://127.0.0.1:3080
第四步：首次配置
- 浏览器打开后，你会看到 DSH 的界面
- 点击左下角的 "设置"（齿轮图标）
- 在 "模型" 部分，选择 DeepSeek 作为模型
- 在 "API Key" 输入框中，粘贴你刚才复制的密钥
- 关闭设置页面
第五步：开始使用
- 点击左侧的 "新建对话" 按钮
- 在底部输入框输入你的问题，比如：
你好，帮我写一首关于秋天的诗
- 按回车发送，AI 会开始回答
- 等待几秒钟，你就能看到 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 或更高）。
解决：
- 访问 https://nodejs.org/ 重新下载最新 LTS 版本
- 安装完成后重启终端
Q：浏览器打不开 http://127.0.0.1:3080
原因：DSH 可能没有启动成功，或者端口被占用。
解决：
- 检查终端是否显示 "running at http://127.0.0.1:3080"
- 如果没有，按
Ctrl + C停止当前进程，重新运行npx @deepseek-ai/dsh web - 如果提示端口被占用，试试：
npx @deepseek-ai/dsh web --port 3081
Q：输入问题后没有反应
原因：API 密钥可能没有配置正确。
解决：
- 检查设置中的 API Key 是否正确粘贴
- 确认 API Key 没有过期
- 检查网络连接是否正常
Q：提示 "DEEPSEEK_API_KEY" 相关错误
原因：API 密钥未设置或无效。
解决：
- 重新生成一个 API Key：https://platform.deepseek.com/
- 在 DSH 设置中重新输入新的密钥
小贴士
- 免费额度：DeepSeek API 有免费额度，个人使用基本够用
- 数据安全：DSH 在本地运行，你的对话内容不会上传到 DeepSeek 服务器
- 插件系统：DSH 支持安装插件扩展功能，但目前还是开发者预览版，插件生态还在建设中
- 保持更新：DSH 还在快速迭代，建议定期运行
npx @deepseek-ai/dsh web获取最新版本
进阶：一键启动脚本
如果你觉得每次都要输入命令太麻烦，可以创建一个一键启动脚本：
macOS 用户
- 打开终端，输入：
echo '#!/bin/bash
npx @deepseek-ai/dsh web' > ~/start-dsh.sh
chmod +x ~/start-dsh.sh
- 以后只需要运行
~/start-dsh.sh就能启动 DSH
Windows 用户
- 在桌面新建一个文本文件，命名为
start-dsh.bat - 用记事本打开，输入：
npx @deepseek-ai/dsh web
- 保存文件，以后双击这个文件就能启动 DSH
最后更新：2026年8月18日
作者：广山哥