DeepSeek Harness 接入 4sAPI 教程

国内访问

海外网络正常访问

DeepSeek Harness 是 DeepSeek 官方推出的 AI 编程助手框架，跑起来后会得到一个本地网页版「AI 编程工作台」。本教程带你从零开始：启动它 → 接入 DeepSeek 大模型 → 开始第一句对话。全程只需复制粘贴几条命令。

源项目地址：https://github.com/deepseek-ai/deepseek-harness
适用系统：Windows 10/11（macOS、Linux 步骤相同，在终端里执行一样的命令即可）

准备工作（2 分钟）

开始前请确认两件事：

已安装 Node.js（LTS 版本即可）。没装的话去官网 https://nodejs.org 下载 LTS 安装包，一路「下一步」装完。

检验方法：打开 PowerShell，输入 node -v，能显示版本号（如 v22.x.x）就说明装好了。

已拿到模型服务的 API 地址和 API Key（官方 DeepSeek API 或兼容中转服务均可，下文以 four-s-api 中转为例）。

第一步：启动 DeepSeek Harness

打开 PowerShell（按 Win 键 → 输入 powershell → 回车），运行：

npx @deepseek-ai/dsh web

如果提示 Need to install the following packages... Ok to proceed? (y)，输入 y 回车即可。

首次运行需要下载程序包，视网速等待几十秒到几分钟，之后启动就很快了。

下载完成后会自动启动服务，通常会自动打开浏览器进入 Web 界面。

💡 提示：如果浏览器没有自动弹出，手动打开浏览器访问 http://127.0.0.1:3080 即可。

（推荐）把 dsh 装成全局命令

npx 只是临时运行，不会把 dsh 命令安装进系统。如果你打算长期使用，建议先做一次全局安装，以后启动就只需两个字母：

npm install -g @deepseek-ai/dsh   # 只需执行一次
dsh web                            # 以后每次这样启动

⚠️ 注意：这个 PowerShell 窗口在使用期间不要关闭——关掉窗口就等于退出了 DeepSeek Harness。

第二步：认识 Web 界面

启动成功后，浏览器会显示如下界面：

中间大块区域是对话区，底部是消息输入框；

左下角的设置是我们下一步配置模型的入口。

第三步：配置模型服务（接入 DeepSeek 大模型）

DeepSeek Harness 本身不内置模型，需要填入 API 地址和 Key 才能对话。按下面 6 小步操作：

点击左下角设置。

在设置菜单中点击模型，再点击 添加自定义提供方。

在表单中填写三项信息：

字段	填什么	示例
名称	随便起，方便自己辨认	`four-s-api`
API 地址（Base URL）	模型服务给你的接口地址	以服务商页面为准
API Key	模型服务给你的密钥	`sk-xxxx...`

点击 获取可用模型，稍等片刻会弹出该服务下可用的模型列表。

勾选你想用的模型（可多选），点击 添加所选。

最后点击 创建提供方，保存配置。

第四步：选择模型，开始对话

回到主界面：

点击模型切换器（输入框附近）。

在列表中找到刚创建的提供方（如 four-s-api），展开并选中你刚勾选的模型。

在输入框输入任意内容、回车发送，收到回复即代表配置成功 🎉

常见问题（FAQ）

现象	原因与解决办法
提示 `npx`/`dsh` 不是内部或外部命令	Node.js 未安装或未加入 PATH：重装 Node.js 后关闭并重新打开终端再试
提示「在此系统上禁止运行脚本」	PowerShell 执行策略限制：运行 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`，输入 `Y` 回车，再重新执行命令
首次下载很慢或失败	网络波动，切换网络后重试；或先执行 `npm install -g @deepseek-ai/dsh` 走全局安装
浏览器打开 127.0.0.1:3080 显示无法访问	服务没启动成功：回终端看报错信息；若提示端口被占用，换端口启动 `dsh web --port 8080`
对话报 API 错误 / 列表里没有模型	核对 API 地址是否多了或少了 `/v1`、Key 是否复制完整、账户是否有余额
想更新到新版本	执行 `npm install -g @deepseek-ai/dsh@latest`
想退出程序	回到启动它的终端窗口，按 `Ctrl + C`

DeepSeek Harness 接入 4sAPI 教程

国内访问#

海外网络正常访问#

准备工作（2 分钟）#

第一步：启动 DeepSeek Harness#

第二步：认识 Web 界面#

第三步：配置模型服务（接入 DeepSeek 大模型）#

第四步：选择模型，开始对话#

常见问题（FAQ）#