DeepSeek-Harness 安装

DeepSeek 最近两个月放了个 Harness 本地版，0.1 预览阶段，文档只有一份 README，外加零零散散几条 issue 讨论。

我自己装过一轮，卡壳的就两件事：dsh web 起来之后浏览器不自动跳页怎么破；第三方 API Key 填进去之后下拉框里模型名是空的，怎么手动补。其他全是命令行复制粘贴的事，三分钟能跑通。

这篇按安装顺序排列，每步配图。

一、环境准备：先确认 Node.js 版本

dsh 是 Node 包，要求比较新：

Node.js ≥ 22.19.0（文档明文要求）
npm ≥ 10.9.2

打开终端跑两行检查：

node -v
npm -v

如果版本不够，去 nodejs.org 下个 LTS（22.x 最新版）装一下就行。Windows 用 msi 安装包，记得勾上"Add to PATH"。

二、一条命令安装

按住 Win + R，输入 cmd 回车，打开命令行窗口，然后敲：

npm install -g @deepseek-ai/dsh

中间会刷一堆 EBADENGINE 警告——本地 Node 是 22.17，不在官方推荐的 22.19 范围内。不用管，能装完。

图片展示的是Windows命令行窗口界面，显示了安装DeepSeek Harness的命令“npm install -g @deepseek -ai /dsh”。窗口上方显示系统信息，包括Windows版本为10.0.19045.6466，以及Microsoft Corporation的版权信息。该图片与文档中“二、一条命令安装”部分内容对应，直观呈现了在命令行窗口输入安装命令的操作场景，是安装DeepSeek Harness过程中的关键步骤展示。

图：命令行窗口输入 npm install

网速正常的话两分钟左右，共装 454 个包：

图片展示的是在命令行窗口中执行npm install -g @deepseek -ai/dsh命令后的输出结果。窗口显示安装了454个包，耗时2分钟，末尾提示有65个包正在寻找资金支持，可运行npm fund获取详情。窗口底部提示符为C:\\Users\\Administrator>，且没有红色error提示，表明安装成功。该图片与上文介绍的DeepSeek Harness本地安装流程相关，直观呈现了安装过程中的关键信息。

图：added 454 packages in 2m

末尾回到 C:\Users\Administrator> 提示符、没有红色 error，就是装好了。

桌面版下载链接：https://dshdesktop.com/zh/#download

三、一条命令启动

接着在命令行敲：

dsh web

终端会输出：

dsh web: http://127.0.0.1:3030
dsh web: opening the default browser; pass --no-open to disable

图片展示的是在Windows系统下使用命令行安装DeepSeek-Harness时的终端输出结果。首先执行npm install -g @deepseek-ai/dsh命令安装包，显示了npm的警告信息，如BADENGINE Unsupported engine等，还提示有454个包在2分钟内被添加。接着执行dsh web命令，终端显示dsh web: http://127.0.0.1:3080，并提示默认浏览器将打开该地址，也可通过pass --no-open手动关闭自动打开浏览器功能。该图片与文档中介绍DeepSeek Harness本地启动流程的内容相关，直观呈现了安装及启动过程中的终端反馈。

图：dsh web 自动打开本地 3030 端口

系统会自动用默认浏览器弹出 127.0.0.1:3030 这个地址。如果不想自动开浏览器，可以在命令后面加 --no-open，手动复制地址栏打开。

不想敲命令也行，开始菜单能找到入口。

四、首次进入：点个"继续"

第一次打开页面，会弹一个 内测声明 弹窗，是 Harness 0.1 阶段的免责说明，点"继续"就行，没有任何功能影响。

图：DeepSeek Harness 内测声明

进入后左侧会看到"工作区"和"暂无会话"两个空状态，主体区域是空的。下一步就是配模型。

五、配大模型（两种方式二选一）

点左侧齿轮按钮进设置，选"模型"页签。这里有两种填法：

方式 A：用 DeepSeek 官方 API

直接购买 DeepSeek 开放平台的套餐，把后台拿到的 API Key 粘到"API 密钥"框里就行，API 地址不用改，默认 https://platform.deepseek.com。

0.1 版本内置了三个官方模型：

deepseek-v4-flash
deepseek-v4-pro
deepseek-v4-flash-vision-exp（带视觉能力的）

该图片为DeepSeek-Harness中进行大模型配置的“DeepSeek官方模型配置页”，页面属于设置模块下的“模型”配置项，用于接入DeepSeek官方API。页面显示可填写的配置项：包括DeepSeek官方API密钥输入框，无需修改默认API地址，下方列出了0.1版本内置的三款官方模型，分别是deepseek-v4-flash、deepseek-v4-pro、带视觉能力的deepseek-v4-flash-vision-exp，页面底部设有“保存”按钮，配置完成后点击该按钮即可完成设置。

图：DeepSeek 官方模型配置页

填完点右下角"保存"。

方式 B：接第三方平台

如果你已经有别的厂商账号（Claude、OpenAI、月之暗面等转发站都行），接自定义渠道也能用。

在"自定义提供商"区域填：

字段	填什么
Provider ID	一个英文标识，自己起名
API 密钥	第三方平台给的 key
显示名称	自定义
API 地址	第三方平台提供的 base URL
API 协议	默认 `openai-completions`
模型目录	平台支持的模型，手动勾出来

这张图片展示了DeepSeek-Harness配置第三方大模型API的设置界面，是文档中DeepSeek+第三方API key配置的示例图。界面为弹窗样式，上方提示需输入第三方平台的API key，该输入框被红色框标注；中间的API地址输入框也有红色标注，对应需填写第三方平台提供的base URL；下方“模型目录”板块中，标注的“deepseek-v3”模型选项被红色框标出，契合文档里需手动勾选模型的提示，与配大模型的操作指引直接对应，清晰呈现了配置时的核心填写项与需手动勾选的模型选择区域。

图：Deepseek + 第三方 API key 配置示例

这里有个坑：第三方平台给的模型清单，每次都要手动在"模型目录"里点出来配一下，Harness 不会自动拉。如果点了保存发现下拉里找不到模型，就是这一步漏了。

六、添加工作区

回到左侧栏，点工具栏上那个 文件夹图标（在"工作区"标题右侧），会弹出系统的"选择文件夹"窗口。

这张图是DeepSeek-Harness添加工作区步骤中的选择工作区文件夹弹窗，对应添加工作区的操作环节。图中左侧是DeepSeek Harness的软件界面，标注了“添加工作区”按钮；右侧的系统弹窗为“Select Workspace Directory”，用于选择存储工作区的位置，地址栏明确显示当前路径为“此电脑 > 文档 (E:)”，下方文件列表展示了E盘内的多个文件夹，弹窗底部设置了“选择文件夹”按钮，方便用户确认所选目录完成工作区的添加操作。

图：选择工作区文件夹弹窗

挑一个你想让 AI 操作的目录点"选择文件夹"。

挑目录时三个注意：

建个空文件夹专门给 Harness 用，比如 E:\Deepseek harness，不要让它碰你的桌面或下载文件夹
路径里别带中文，遇到权限报错很多时候就是这个问题
避免系统盘根目录（C 盘、D 盘根），Harness 需要读写权限

七、发个"你好"验证整条链路

配完模型 + 加好工作区，回到主界面，新开会话，输一句 "你好"。

如果一切正常，模型会自动报家门，告诉你：自己叫什么模型、当前工作目录是什么、文件系统权限是什么模式。

图片展示了DeepSeek Harness安装完成后，输入“你好”时的回话界面。界面中显示“你好！我是claude-fable-5，一个由DeepSeek Harness驱动的AI开发环境”，并列出该模型可处理的技术任务，如编译和修改代码、运行终端命令等。还说明当前工作目录为E:\Deepseek harness，文件系统权限为workspace-write模式。该图片与上文提到的在配完模型加好工作区后，回到主界面新开会话输入“你好”以验证整条链路的内容相呼应，是验证安装成功的关键步骤之一。

图：装好之后 hello 回话正常

你的当前工作目录是 E:\Deepseek harness，文件系统权限为 workspace-write 模式。

看到这一行就说明装好了——模型、客户端、工作区读写都正常。

八、下一步能做什么

装好只是起点。Harness 发挥作用靠 Skills（技能插件）——挂上 Skills，它能帮你写代码、读仓库、提 PR、调 CLI。