DeepSeek Harness 新手入门：从安装到第一次交付

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

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

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

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

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

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

1. 打开 DeepSeek Harness 官网，展开下载按钮。
2. 选择匹配的安装包：Windows 64 位，或 macOS Apple 芯片版。
3. 下载后运行安装程序，按提示完成，再打开应用。

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

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

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

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

1. 从 Node.js 官网安装符合 DSH 要求的运行环境：22.19.0 起的 22 系列，或 24.0.0 及以上版本。
2. Windows 搜索打开 PowerShell；Mac 打开“终端”。逐行输入并回车：

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

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

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

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

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

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

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

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

4. 使用 DeepSeek 官方账号或 API

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

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

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

四、可选：结合 Orbis API 使用

5. 准备 Orbis 密钥

1. 打开 DeepSeek V4.1 Flash 模型详情，选中 DeepSeek · 官方线路。
2. 点击“获取 Key”，登录 Orbis 后按页面流程创建并复制密钥，再查看“快速接入”。
3. 核对模型 ID 是 deepseek-v4.1-flash，密钥只填到软件的 API Key 栏。

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

6. 在 Harness 中添加 Orbis API

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

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

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

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

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

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

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

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

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

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

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

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

8. 先读取，再生成文件

先发送：

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

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

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

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

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

9. 打开文件验收

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

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

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

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

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

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

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

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

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

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

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

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

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

12. 多文件工作先列计划

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

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

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

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

13. 用规则文件复用要求

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

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

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

14. 缺少能力时再加插件

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

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

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

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

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

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

八、遇到问题，先看这里

参考资料

核查：2026-10-22。

• 官方：启动说明、首次任务、模型配置。
• 结构参考：社区 Windows 教程的逐步检查点、社区快速上手的目标与排错分层；功能以官方为准。