跳转至

DeepSeek Harness 配置

本页最后更新于 ，内容可能过时

开始之前：本篇用的是 DeepSeek 官方的桌面端，全程不需要科学上网

一、这是 DeepSeek 官方出品。 DeepSeek Harness 由 DeepSeek 官方开源并发布，桌面端也从 deepseek.com 下载。之前那个第三方打包的桌面版已经从官网撤下，本篇全部按官方版本写。

二、全程不需要科学上网。 下载、安装、登录、调用模型都在国内网络能够完成。

全程概览

  1. 了解 DeepSeek Harness 是什么（可跳过）
  2. 在 DeepSeek 开放平台充值
  3. 从官网下载并安装桌面端
  4. 首次启动时登录 DeepSeek 账号
  5. 添加工作区，开始用

全程只需要下载、点击和登录，不需要科学上网，也不需要任何前置知识。

1. 为什么用 DeepSeek Harness 桌面端

Harness（直译是「马具」，指围绕模型搭建的一整套工具链）决定模型能看到什么信息、能调用哪些工具、怎么把一个大任务拆成若干步。同一个模型配上不同的 Harness，效果可以差别很大。

DeepSeek Harness（命令名 dsh）是 DeepSeek 官方开源的智能体框架，桌面端则把整套运行环境打包成了现成的应用。装上打开就是完整的智能体界面 —— 不需要 Node，不需要命令行，也不用自己维护本地服务。

它相比「自己把客户端和模型组合起来」的优势：

  • 下载安装就是全部部署：桌面端自带运行环境，会自己启动本地的 Harness 实例、管理端口和进程，只需打开窗口即可。
  • 不用科学上网：官网的下载地址在国内可以访问，安装、更新、调用模型全在国内完成。
  • 不用配中间层：登录 DeepSeek 账号之后，模型列表和请求路由就自动配好了，不需要手动填任何模型 ID。
  • 升级不丢东西：配置、工作区和会话都存在安装目录之外的数据目录里，重装和升级都不会清掉。
  • 开源：源码在 GitHub 上（deepseek-ai/deepseek-harness），MIT 协议，官网首页有入口。

与 Claude 配置那篇的关系

两篇解决的是同一个问题 —— 配一个能读代码、能改文件的 AI 助手，区别在于所用的客户端：

DeepSeek Harness 桌面端（本篇） Claude 桌面版 + Magpie
前置条件 无 必须科学上网，且节点不能选香港
配置步骤 装完登录就行 还要装 Magpie、加供应商、在 Agent 页选模型
模型 DeepSeek 同样可以接 DeepSeek

不想配置代理的，直接用本篇这套。 已经配好 Claude 那套的也不用重来，两个客户端互不影响，可以同时安装。

1.1 支持哪些平台

平台 安装包 是否支持
Windows x64 .exe ✅
macOS（Apple 芯片） .dmg ✅
macOS（Intel 芯片） — ❌
Linux — ❌

官网只提供这两个安装包。

2. 在 DeepSeek 开放平台充值

这一节和 Claude 配置那篇的第 2 节前半部分一样

如果你已经充过值，可以直接跳到第 3 步。

2.1 注册并登录

打开 DeepSeek 开放平台，注册并登录：

https://platform.deepseek.com/

2.2 充值

DeepSeek 的网页版和 App 对话是免费的，但 Harness 走的是 API，API 按量计费，用多少算多少，所以账户里需要先有余额。桌面端和命令行都是从这同一个余额里扣。

在左侧栏点 「充值」，选一个金额，支付方式用支付宝或微信都行：

DeepSeek 开放平台的充值页面

充多少合适

先充 ¥1 就够，用完了随时再充。

页面上的单价分空闲时段和高峰时段两档，高峰时段是空闲时段的 2 倍。具体单价点旁边的「查看价格」看。

2.3 选择合适的模型

DeepSeek 目前提供两个模型，两个模型的名称如下 —— 后面在客户端的模型列表里要按名称选择：

2026年9月14日 deepseek-flash deepseek-v4-pro
模型版本 DeepSeek-V4.1-Flash DeepSeek-V4-Pro-0813
上下文长度 1M 1M
最大输出长度 384K 384K
图像理解 支持 不支持
并发限制 2500 500

平时写代码用 deepseek-flash 足够。

模型 输入（缓存命中） 输入（缓存未命中） 输出
deepseek-flash 空闲时段 0.02 1 4
deepseek-flash 高峰时段 0.04 2 8
deepseek-v4-pro 空闲时段 0.15 4.5 13.5
deepseek-v4-pro 高峰时段 0.30 9.0 27.0

高峰时段的价格是空闲时段的两倍

高峰时段是北京时间周一至周五的 9:00-12:00 和 14:00-18:00，其余时间（包括整个周末）都算空闲时段。

所以同样的任务，放在晚上或者周末运行，费用只要一半。

3. 下载并安装桌面端

打开官网：

https://www.deepseek.com/harness/

页面顶部的 「下载桌面端」 按钮会自动识别你当前的系统，点它就行。

自动识别错了，就点旁边的下拉箭头手动选

Windows（64 位）→ dsh-latest-windows-x64.exe

macOS（Apple 芯片）→ dsh-latest-macos-arm64.dmg

macOS 的同学要认清自己是哪种芯片：官网只提供 Apple 芯片的安装包，Intel 芯片的机器装不了，最近几年的新机器都是 Apple 芯片。

4. 首次启动：登录 DeepSeek 账号

第一次打开桌面端，窗口左下角是「设置」「意见反馈」「登录」三项，点 「登录」：

桌面端左下角的「登录」按钮

应用会跳到系统默认浏览器，在网页上完成 DeepSeek 账号登录，授权之后自动回到桌面端。

这一步做完，模型列表和请求路由就都配好了 —— 不需要填 API Key，也不需要填模型 ID。这也是它相比「客户端 + 中间层」那套的优势。

5. 开始使用

界面大致分三块：左边是会话和工作区，中间是对话，左下角是「设置」。

  • 新建会话：点左栏的「新建会话」开一段新对话。
  • 模型：输入框右下角有模型选择器，默认就是 DeepSeek。平时用 deepseek-flash 就够。
  • 工作区：点输入框上方的「选择工作区」，用系统的文件夹选择器把你写代码的文件夹加进来。

为什么需要加工作区

加了工作区，AI 才能真的读到你文件夹里的代码：你把报错贴给它，它可以直接找到对应的源文件查看上下文。

你让它修改，它会直接修改对应文件，而不是只在聊天框里贴一段代码让你手动复制。

6. 在终端里运行（可选）

桌面端用的是官方的 DeepSeek Harness（命令名就是 dsh）。官方也提供命令行形式：运行一条命令，它在本机启动一个服务，界面是浏览器里的一个网页。

两者用的是同一个 DeepSeek 账号和同一份余额，功能也基本一样，装哪套都行。这里介绍的命令行走的是 npm 渠道，所以：

  • 用 WSL 或 Linux 的同学走这条
  • 想装在服务器上、或者通过 SSH 用，也走这条

Windows 和 macOS 还有更省事的一条路

桌面端的应用菜单里有 「管理 dsh 命令…」，点一下就把 dsh 命令装到系统里，用的是桌面端自带的运行环境，不用另外装 Node。装完新开一个终端，运行 dsh --version 能打印版本号就成功了。

下面这节走的是 npm 渠道，WSL 和 Linux 上只能走这条。

6.1 装 Node.js

dsh 本身是用 JavaScript 写的，要运行它，电脑上需要先有能运行 JavaScript 的环境 —— 这就是 Node.js。

它把 JavaScript 从原本只能在浏览器中运行扩展到命令行，使其可以像普通程序一样在电脑上运行。

装 Node.js 会顺带装上 npm，一个命令行的「软件包管理器」。后面那条 npx @deepseek-ai/dsh web，就是让 npm 从它的仓库里把 dsh 下载下来并运行，不用你手动去下载安装。

这也正是第 1 节说桌面端「不需要 Node」的原因

桌面端已经把这一整套运行环境连同 dsh 一起打包好了，那套什么都不用装；走命令行这条，就需要自己安装 Node。

PowerShell
winget install OpenJS.NodeJS.LTS

winget 是 Windows 自带的，这条会装上当前的 LTS 版本。

LTS 是「Long Term Support」的缩写，即「长期支持版本」，稳定性和安全性都比最新版本更好。

Linux 终端
curl -o- https://fnm.vercel.app/install | bash

fnm 是一个 Node 版本管理器，能让你在同一台机器上装多个 Node 版本、随时切换。

Linux 终端
fnm install 24

两种方式装完之后，都这样确认一下：

任意终端
node -v

如果成功打印出版本号，就说明 Node 安装好了。

node -v 报「不是内部或外部命令」/「command not found」

基本上是 PATH 还没生效 —— Node 刚装好，当前这个终端窗口是在安装之前打开的，还看不到新的 PATH。关掉终端，重新开一个再试。

6.2 启动 Web UI

终端
npx @deepseek-ai/dsh web

第一次运行会有一处提示，输入 y 回车

npx 要先把这个包下载下来，会提示 Ok to proceed? (y)，答 y 就行。

服务启动之后：

  • 默认在本机 http://127.0.0.1:3080 提供服务，并自动用默认浏览器打开。
  • 这个窗口需要一直开着。关掉终端，服务就停止。

通过 SSH 启动时不会自动打开浏览器

它只会把宿主机上的地址打印出来，转发到你本机是需要你自己配置 SSH 客户端和端口转发（VSCode Remote 一般会自动帮你转）。转发好之后，在本机浏览器里打开那个地址就行。

6.3 填入 API Key

命令行这套走的是 API Key，这个 Key 和桌面端的登录账号不是一回事，需要在「API keys」页面单独创建一个。

左侧栏点 「API keys」，再点 「创建 API key」。名称随便写一个（比如 dsh），然后点「创建」：

在 DeepSeek 开放平台创建 API key

API Key 只在创建时完整显示一次

弹窗关掉之后就再也看不到了。创建完立刻复制下来，先粘到记事本里存着，下一步马上要用。

API Key 泄露等于账户被盗刷

任何拿到这个 Key 的人，都能直接花你账户里的钱。需要做到：

  • 不要把它粘到聊天群、论坛或者作业提交里，也不要截图发出去
  • 不要写进代码或配置文件之后提交到 GitHub —— 公开仓库会被爬虫扫描，泄露的 Key 往往几个小时内就会被刷光
  • 万一怀疑泄露，立刻回「API keys」页面把它删掉，重新建一个

同样地，充值尽量用多少充多少，不要在账户里留大额余额。这样即使 Key 真出了问题，损失也是可控的。

在浏览器里打开的 Web 界面中，打开 「设置 → 模型」，把 Key 粘到 DeepSeek 卡片的「API 密钥」一栏保存。模型路由会立即生效，不需要重启服务。

文档完成登记：完成本文全部流程后告知助教