> ## Content Index
> Fetch the complete content index at: https://orbiorbi.com/news/llms.txt
> Use this file to discover other available public pages before exploring further.

# DeepSeek Harness 新手入门：从安装到第一次交付
- URL: https://orbiorbi.com/news/deepseek-harness-xinshou-rumen/
- Published: 2026-10-21T20:54:23.000Z
- Updated: 2026-10-21T20:54:23.000Z
- Description: DeepSeek Harness 已有官方桌面预览版。本文从下载安装到模型配置，以整理一份本地笔记为练习，带你理解工作区、任务执行、结果核对，以及插件和自定义模型的使用边界。
- Author: Orbis News
- Tags: API 接入与排障, #model:deepseek-v4.1-flash

## 一、认识 DSH：这篇要完成什么

**目标：安装 DeepSeek Harness，让它读取四行笔记，生成一份新清单，再打开核对。**

DeepSeek Harness（简称 DSH）是 DeepSeek 的智能体工作台，能连接模型、读写文件、调用工具。记住两个词就够：**工作区**是本次使用的文件夹，**会话**是围绕一项任务的对话。

路线：**安装 → 官方方式连接模型 → 按需接入 Orbis → 选文件夹 → 发任务**。预览版先用独立练习目录，重要资料保留备份。

## 二、下载安装：两条路线选一条

### 1\. 推荐：安装官方桌面版

1. 打开 [DeepSeek Harness 官网](https://www.deepseek.com/harness/?ref=orbiorbi.com)，展开下载按钮。
2. 选择匹配的安装包：Windows 64 位，或 macOS Apple 芯片版。
3. 下载后运行安装程序，按提示完成，再打开应用。

![DeepSeek Harness 中文官网的桌面下载按钮](https://orbiorbi.com/news/content/images/2026/10/05-------------.jpg)

看页面中间的下载按钮，右侧箭头用于选择系统；这是官网实拍截图。

**成功标志：应用打开，出现会话与工作区入口。** Mac 不确定芯片时，查看苹果菜单“关于本机”；没有适配包时走下面的路线。

### 2\. 可选：一行命令启动 Web UI

Web UI 就是浏览器操作界面，程序仍在本机运行；装好桌面版可跳过。

1. 从 [Node.js 官网](https://nodejs.org/?ref=orbiorbi.com)安装符合 [DSH 要求](https://github.com/deepseek-ai/deepseek-harness/blob/master/package.json?ref=orbiorbi.com)的运行环境：22.19.0 起的 22 系列，或 24.0.0 及以上版本。
2. Windows 搜索打开 PowerShell；Mac 打开“终端”。逐行输入并回车：

```text
node --version
npm --version
npx @deepseek-ai/dsh web

```

1. 前两行应显示版本号；第三行首次下载时核对包名再继续，打开终端打印的完整访问地址。

**成功标志：浏览器出现 DSH 界面。** 保持终端开着；关闭它或按 `Ctrl+C` 会停止服务。

### 3\. 给 agent 的一句话安装指令

粘贴到**已经能操作本机的 agent 对话框**，不是终端：

> 请依据 https://www.deepseek.com/harness/ 检查系统与芯片，帮助安装适配的官方桌面版；无适配包时按官方 Node.js 要求用 npx @deepseek-ai/dsh web 启动，保留已有配置，验证界面能打开，登录与密钥由我填写。

**成功标志：它报告安装方式，并能打开界面。** 没有现成 agent 就按前两步手动操作。

## 三、先按官方方式连接模型

### 4\. 使用 DeepSeek 官方账号或 API

- 桌面版提供账号登录入口时，按界面提示完成登录，选择账号下可用的模型。
- 使用官方 API 时，进入 [DeepSeek 开放平台](https://platform.deepseek.com/?ref=orbiorbi.com)获取自己的 API Key，再到 Harness“设置 → 模型 → DeepSeek”填写并保存。
- 新建会话，选中刚配置的官方模型，发送“只回复：连接成功”。账号权限和 API 额度分别以对应平台显示为准。

**成功标志：** 会话中能选中模型并收到回答。API Key 是模型调用凭据，不是网页登录密码；不需要同时配置两种方式。

官方连接已可用，就可以跳到“准备材料，选中工作区”。希望结合 Orbis 使用，再按下面两步新增提供商。

## 四、可选：结合 Orbis API 使用

### 5\. 准备 Orbis 密钥

1. 打开 [DeepSeek V4.1 Flash 模型详情](https://orbiorbi.com/pricing/deepseek-v4.1-flash?catalogKey=model%2F129&ref=orbiorbi.com)，选中 **DeepSeek · 官方线路**。
2. 点击“获取 Key”，登录 Orbis 后按页面流程创建并复制密钥，再查看“快速接入”。
3. 核对模型 ID 是 `deepseek-v4.1-flash`，密钥只填到软件的 API Key 栏。

**成功标志：你手上有该线路的 Key，以及快速接入页给出的地址和模型 ID。** Key 绑定线路；只改模型名不能自动切换线路。账号额度、计费与可用状态以当前页面为准。

模型

[DeepSeek V4.1 Flash](https://orbiorbi.com/pricing/deepseek-v4.1-flash?catalogKey=model%2F129&ref=news-deepseek-harness-xinshou-rumen)`deepseek-v4.1-flash`

查看 Orbis 可用线路、精确模型 ID 与 API 接入方式。

体验

### 6\. 在 Harness 中添加 Orbis API

1. 打开“设置 → 模型”，点击“添加模型提供商”。
2. 切换为 **自定义模型 API**，按表填写。不要把 Orbis Key 填进默认 DeepSeek 官方卡片。

![DeepSeek Harness 的模型设置与添加提供商入口](https://orbiorbi.com/news/content/images/2026/10/01-------------.png)

看 DeepSeek 卡片下方的“添加模型提供商”，本次从这里新建。

| 表单字段            | 本文填写值                       |
| --------------- | --------------------------- |
| Provider ID     | orbis，用小写，创建后不要随意改名         |
| 显示名称            | Orbis                       |
| 基础 URL / API 地址 | https://api.orbiorbi.com/v1 |
| API 协议          | OpenAI Chat Completions     |
| API 密钥          | 刚才获取的 Orbis Key             |
| 模型 ID           | deepseek-v4.1-flash         |

![DeepSeek Harness 自定义模型 API 表单](https://orbiorbi.com/news/content/images/2026/10/02----------------.png)

看“API 地址”“API 协议”和模型目录；地址填基础路径，不要在末尾再加 `/chat/completions`。

1. 手动添加模型 ID 并保存，在新会话的模型选择器中选中 Orbis 下的该模型。也可用“获取可用模型”，列表为空时仍可手动录入。

**成功标志：新会话能选中该模型。** 这只证明配置已保存，真正的连通与工具调用要用下面的读取、写入练习检验。

## 五、第一次使用：完成一份待办清单

### 7\. 准备材料，选中工作区

1. 桌面新建 `DSH练习` 文件夹。
2. 用记事本或纯文本编辑器保存 `本周笔记.txt`，内容直接复制：

```text
网站首页的介绍已经更新，周五还要检查手机显示。
下周需要整理三篇旧文章，具体完成日期还没有定。
读书会报名表已经检查，重复报名已标出。
新一期分享的配图还没开始，负责人尚未确定。

```

1. 回到 DSH，添加并选中这个工作区，再新建会话。

![DeepSeek 官网展示的会话预览，左侧为工作区与会话列表](https://orbiorbi.com/news/content/images/2026/10/06-------------------.jpg)

看左侧“工作区”和“新会话”；这是官网界面预览，具体选择按钮以客户端为准。

**成功标志：当前工作区是 `DSH练习`，输入框可用。**

### 8\. 先读取，再生成文件

先发送：

> 只读取当前工作区的“本周笔记.txt”，复述四项工作，不修改文件。

**成功标志：四项内容与原文一致。** 然后在同一会话继续：

> 整理成“已完成”“待办”“待确认”，保存为当前目录的“待办清单.md”，保留原文件；未写明的负责人和期限标“未说明”，不要推测。

出现权限提示时，先确认路径是练习目录。`.md` 是文本格式，记事本也能打开。

**成功标志：目录中出现 `待办清单.md`。**

### 9\. 打开文件验收

- 四项工作不能遗漏，原文件不能被覆盖。
- 首页介绍已更新，但手机显示仍要检查，不能整项划为完成。
- 未确定的日期、负责人不能被擅自补齐。

有遗漏就在原会话说：“把首页更新和手机显示检查拆开，只修改清单。”

**成功标志：文件内容通过以上三项检查。**

## 六、基本使用：会追问，也会检查

### 10\. 指明文件，控制修改范围

1. 延续刚才的会话，写清文件名，不只说“把它改一下”。
2. 复制下面的要求，让它做一次局部修改。

```text
读取“待办清单.md”，仅将“待办”部分改成带复选框的列表。
保留“已完成”和“待确认”的文字，不重写其他文件。
完成后列出改动位置。

```

**成功标志：只有待办列表变了，日期和负责人没有新增。** 同一成果的修改留在原会话；完全不同的材料再建新会话。

### 11\. 看轨迹，判断问题发生在哪里

1. 展开本轮执行记录，查看读取和写入工具的输入、输出。
2. 对照文件路径：读错文件就纠正路径；读取正确但分类错误，就引用原句说明。
3. 若同一步反复失败，先停止本轮，再缩小为“只读取一份文件”。

![DeepSeek Harness 的轨迹与工具执行详情](https://orbiorbi.com/news/content/images/2026/10/04-------.webp)

看工具记录中的文件名与返回结果，别只看最后一句“已完成”。

**成功标志：你能指出这轮读了什么、写了什么，以及是否发生错误。**

## 七、进阶使用：把一次任务做成可复用流程

### 12\. 多文件工作先列计划

1. 在练习文件夹新增 `补充说明.txt`，写入：“手机显示检查由小林负责；旧文章整理期限仍未确定。”
2. 先发送下面的计划要求，暂不让它写文件。

```text
先阅读“本周笔记.txt”和“补充说明.txt”，列出两份材料哪些信息可合并、哪些需要确认。
给出最多四步的整理计划，等我确认再写文件。

```

1. 核对它没有把所有任务都分给小林，再回复：“按计划生成待办清单-v2.md，保留旧版。”

**成功标志：只有手机检查补上小林，旧文章日期仍未说明，旧清单还在。** 这里用自然语言约定执行顺序，不依赖未核实的“计划模式”按钮。

### 13\. 用规则文件复用要求

让它创建 `整理规则.txt`，内容如下；以后新会话先要求读取规则，再读取材料。

```text
分为已完成、待办、待确认。
一条笔记里已完成和未完成的部分要拆开。
没写负责人或日期时标“未说明”，不猜测。
输出新文件，不覆盖输入材料。

```

**成功标志：换一份笔记，分类方式仍一致。** 这是普通参考文件，需要明确让它读取，不等同于软件自动加载的系统规则。

### 14\. 缺少能力时再加插件

1. 打开插件列表，先看当前已有能力，确认是否真的缺少某种工具。
2. 需要添加时点击“添加插件”，检查来源、依赖和它能访问的目录或服务。
3. 添加后只用练习目录测试一项功能；异常时从列表停用，再确认原流程仍可运行。

![DeepSeek Harness 官方插件列表与添加入口](https://orbiorbi.com/news/content/images/2026/10/03-------.webp)

看右上“添加插件”和每行的开关；插件是给工作台添工具，不是把模型换得更聪明。

**成功标志：你知道新增工具做什么，也能停用它。** 本文的笔记练习不需要额外插件。

### 15\. 用自己的小文件再验证一次

1. 将一份无敏感信息的短笔记复制进练习目录，改名为 `我的笔记.txt`。
2. 要求：“只读我的笔记.txt，引用其中两句原文，再列出待办；这次不要写文件。”
3. 亲自打开原文核对引用，并查看是否真的出现读取记录。

**成功标志：引用与原文逐字对应，未编造内容，也未修改源文件。** 通过后再尝试真实工作材料；不要把 API Key 或账号文件当测试素材。

## 八、遇到问题，先看这里

| 现象                        | 先检查                                |
| ------------------------- | ---------------------------------- |
| node/npm 不识别              | 安装 Node.js 后重新打开终端                 |
| 网页打不开                     | 启动进程是否还在，地址是否来自终端                  |
| 输入框灰色                     | 工作区和模型是否都选中了                       |
| MISSING\_CREDENTIAL / 401 | 是否填入对应 Orbis 线路的有效 Key，复制是否完整      |
| 404 / 接口不存在               | 基础地址是否为 /v1，协议是否为 Chat Completions |
| UNKNOWN\_MODEL            | 模型是否存在、名称是否正确                      |
| 回答了但没文件                   | 是否要求保存，写入是否报错                      |

## 参考资料

核查：2026-10-22。

- 官方：[启动说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md?ref=orbiorbi.com)、[首次任务](https://deepseek-harness.github.io/deepseek-harness/guide/quickstart?ref=orbiorbi.com)、[模型配置](https://deepseek-harness.github.io/deepseek-harness/guide/providers?ref=orbiorbi.com)。
- 结构参考：[社区 Windows 教程](https://deepseekdsh.com/zh/tutorials/windows?ref=orbiorbi.com)的逐步检查点、[社区快速上手](https://deepseekdocs.com/docs/getting-started/quickstart?ref=orbiorbi.com)的目标与排错分层；功能以官方为准。