夜雨聆风DeepSeek最新开源重磅项目DeepSeek Harness（简称DSH）来了！主打一切皆插件，打通AI读写文件、执行命令、自动编码、项目重构能力。本文整理4种主流部署方案，小白也能跟着成功安装。
提示：当前为开发者预览版v0.1，建议优先在测试项目使用，谨慎直接开放生产目录权限。
一、先搞懂：什么是 DeepSeek Harness
很多人容易混淆：它不是大模型，而是一套AI智能体运行框架。 官方公式：Agent = 大模型 + Harness
模型负责思考、推理； Harness负责对接本地文件、执行终端命令、管理插件、维护会话、完成工具调用闭环。
核心亮点 ✅ 一切皆插件：模型、文件操作、Shell、检索、UI全部支持插拔替换 ✅ 本地WebUI，浏览器直接操作 ✅ MIT开源协议，可自由二次开发 ✅ 支持Windows/macOS/Linux全平台
GitHub开源地址： https://github.com/deepseek-ai/deepseek-harness
二、安装前两项必备准备
1. 环境要求
Node.js v22.19+ / v24 LTS（强烈推荐24版本）❌ Node 23 不兼容，启动直接报错
检查环境（Windows CMD / PowerShell / Mac终端执行）
node -v
输出版本号代表正常。没有安装前往官网下载：https://nodejs.org
2. 获取 DeepSeek API Key
Harness需要调用DeepSeek模型，必须准备密钥：
打开平台：https://platform.deepseek.com 登录账号 → API Keys → 创建新密钥 复制保存！密钥只展示一次，丢失无法找回
安全提醒：不要将密钥截图发到社群、文章、代码仓库。
三、四种安装方案（按需选择）
方案一：npx 一键启动【新手首选，最简单】
无需全局安装，一条命令直接拉起Web界面
打开终端，执行：
npx @deepseek-ai/dsh web
等待依赖自动下载完成 出现提示 Web UI is running at http://127.0.0.1:3080浏览器打开地址，进入Harness
优点：零配置、不用克隆源码 缺点：每次启动会在线拉取资源，网络差容易超时
方案二：全局安装dsh命令（推荐日常使用）
安装后任意目录都能启动
npm install -g @deepseek-ai/dsh
# 启动Web界面
dsh web
常用命令拓展
dsh --help# 查看全部指令
dsh version # 查看当前版本
方案三：源码编译安装【开发者、二次开发】
适合想要修改代码、自定义插件的朋友
# 1.克隆源码
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
# 2.安装pnpm包管理器
corepack enable
corepack prepare pnpm@11.7.0 --activate
# 3.安装依赖 & 构建项目
pnpm install
pnpm run build
# 4.启动WebUI
pnpm dsh web
方案四：Docker容器部署【服务器/不想污染本地环境】
适合云服务器部署、多人局域网访问
docker run -d --name dsh \
-p 3080:3080 \
-v dsh-data:/root/.dsh \
ghcr.io/huoxue1/deepseek-harness:latest
启动完成访问：http://服务器IP:3080
云服务器记得在防火墙放行 3080端口
四、首次进入界面基础配置
打开 http://127.0.0.1:3080新建工作区：选择本地文件夹（AI拥有该目录读写权限） ⚠️ 不要直接选择系统根目录、重要项目根目录！ 进入设置 → 模型配置 粘贴刚才申请的 DeepSeek API Key，保存 选择模型：DeepSeek-V4 / V4 Flash 即可开始对话
五、常见报错 & 解决方案
Node版本过低 / Node23启动失败解决：卸载现有Node，重装 Node.js 24 LTS
npx下载卡住、超时 解决：切换国内npm镜像，或者改用源码方式安装
npm config set registry https://registry.npmmirror.com
访问 http://127.0.0.1:3080 打不开
检查终端进程是否正常运行，不要关闭命令行窗口 确认3080端口没有被其他程序占用
AI无法读写文件 解决：确认工作区文件夹路径不含中文、空格，文件夹权限正常
API调用报错余额不足 前往DeepSeek平台充值，新用户一般赠送免费测试额度
六、新手使用小建议
先用空文件夹测试，熟悉文件读写、命令执行能力 可以限制Agent权限，避免误删除本地文件 关注官方仓库持续更新，预览版会频繁迭代功能 支持自定义插件，后续可以拓展联网、代码解释器能力
结尾
DeepSeek Harness 代表新一代本地AI智能体形态，让大模型真正具备操作电脑的能力。按照本文步骤，最快3分钟完成部署。
如果你部署过程遇到报错，可以把终端日志发出来一起排查！