保姆级教程!安装 DeepSeek Harness 完全指南

DeepSeek Harness 是什么？

先用一句话解释：DeepSeek Harness 是一个开源的 AI 智能体运行框架，你可以把它理解为"给 AI 大脑装上的身体"。

单独一个大模型（比如 DeepSeek）只能和你聊天、回答问题。但有了 Harness 之后，AI 就能真正在你的电脑上干活——读写文件、运行命令、搜索网页、调用工具，就像一个坐在你电脑前帮你做事的助手。

Agent = Model + Harness
🧠 Model 模型：AI 的大脑，负责思考和推理
🔧 Harness 马具：AI 的身体，负责执行和操作

它的核心设计理念是 "一切皆插件" ——模型、工具、UI、存储……所有组件都可以自由替换，像搭积木一样组装你自己的 AI 助手。

💡 简单类比：大模型是一台引擎，Harness 是一辆完整的车。你不需要自己造车，装好引擎就能上路。

安装前准备

开始之前，确认你手头有这三样东西：

准备项	要求	说明
电脑	Windows / Mac	Mac M系列芯片完全支持
Node.js	v22 及以上	下文手把手教你装
DeepSeek API Key	一个可用的密钥	去 DeepSeek 开放平台注册获取

💰 关于费用：DeepSeek Harness 本身完全免费开源（MIT 协议），但调用 AI 模型需要消耗 API 额度。注册后记得往 DeepSeek 账户里充一点余额，一般几块钱就够体验很久了。

第一步：安装 Node.js 环境

Node.js 是运行 DeepSeek Harness 的基础环境，必须先装好它。下面根据你的系统选择对应教程。

🪟 Windows 安装 Node.js

打开浏览器，访问 Node.js 官网下载页
下载 LTS（长期支持版） 安装包，认准版本号 ≥ 22（如 v24.x.x）
双击下载的 .msi 文件，一路点"下一步" 即可完成安装。默认选项就好，安装程序会自动配置好环境变量
安装完成后，关闭当前终端，重新打开一个新的 命令提示符（按 Win+R 输入 cmd 回车）
输入以下命令验证：

node -v

看到类似 v24.19.0 的版本号输出，就说明安装成功了 ✅

⚠️ Windows 用户常见坑：如果装完 Node.js 后终端提示"node 不是内部或外部命令"，多半是环境变量没刷新。关掉终端重新打开，或者注销重登/重启电脑即可。

🍎 Mac M系列芯片安装 Node.js

1、安装 Homebrew（如果还没装）

打开终端（按 Command+空格，输入"终端"回车），执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后按提示将 brew 添加到 PATH。终端会告诉你具体要执行什么命令，照着复制粘贴就行。

2、通过 brew 安装 node

# 安装 nodebrew install node@24

也可以使用brew install node命令来查找node安装包

3、验证完成后验证

node -v # 应输出 v24.x.x 或更高npm -v # 应输出版本号

第二步：安装 DeepSeek Harness

Node.js 环境准备好了，接下来安装 Harness 本体。提供两种方式，任选其一：

方式一：npx 直接启动（最推荐新手）

不需要提前安装任何东西，一条命令搞定：

npx @deepseek-ai/dsh web

首次运行会自动下载依赖（可能要等一两分钟），完成后终端会输出访问地址：

dsh web: http://127.0.0.1:3080

浏览器打开这个地址，看到界面就是安装成功了 🎉

方式二：全局安装（推荐长期使用）

# 全局安装npm install -g @deepseek-ai/dsh# 验证安装dsh --version# 以后随时用这条命令启动dsh web

💡 小贴士：dsh 会把你执行命令时所在的目录当作默认工作区。建议先 cd 到你的项目目录再启动，这样后面选工作区最方便。

第三步：配置 API Key

第一次打开 Harness 界面后，需要配置你的 DeepSeek API 密钥，它才能调用 AI 模型。

打开浏览器，访问 DeepSeek 开放平台
注册/登录账号，进入控制台
点击左侧「API Keys」→ 创建一个新的 API Key
复制生成的 Key（只显示一次，记得保存好）
回到 Harness 的 Web 界面，在弹出的密钥输入框中粘贴你的 API Key
确认账户里有余额（几块钱就够玩很久）

🔒 安全提醒：API Key 是你的付费凭证，绝对不要发给别人、贴到公开文章或上传到 GitHub 仓库。Harness 会以加密方式保存在本地，不会明文泄露。

🔄 不止 DeepSeek：Harness 支持接入多种模型。在设置里可以添加 Anthropic、OpenAI 等厂商，或接入任何 OpenAI 兼容端点。换模型不需要重启服务。

第四步：开始使用

进入 Web 界面后，整体布局是：左侧对话历史、中间任务区、右侧对话框。

四步上手

选工作区 — 在电脑上建好一个文件夹，然后在 Harness 里选择它作为工作区。这是 AI 能操作的文件范围。
选权限 — 三级文件护栏：Read Only（只读）、Workspace Write（可改工作目录内文件，日常最常用）、Full Access（完全放开，谨慎使用）
选运行模式 — 见下方说明
选模型与推理强度 — 右下角选择模型，可设置高/中/低三档推理强度

四种运行模式

Harness 内置四种模式，本质区别是"加载了哪些工具插件"：

模式	能力	适合谁
🟢 标准模式 ⭐推荐	文件编辑、Shell、搜索、子 Agent 等全套能力	新手无脑选这个
🔵 Code 模式	标准模式 + 程序化工具调用	批量操作、自动化流程
⚪ 极简模式	只有 Bash 和文件编辑器	模型基准测试
🟣 创造模式	检查运行时、测试插件、创建自定义模式	高级用户

试试第一个任务

一切配置好后，在对话框里输入：

帮我看看当前目录有哪些文件，然后写一个 hello.py

你会看到 AI 开始自动读文件、写代码——这就是 Harness 的威力。