DeepSeek Harness 新手入门：开始使用前先看这篇

先记住一句话：DeepSeek Harness（dsh）不是一个新的大模型，而是一套让智能体能够理解环境、使用工具并持续执行任务的开源智能体框架（agent harness）。

DeepSeek 官方当前用一个公式概括模型与 Harness 的关系：Agent = Model + Harness。官方同时解释：模型是智能体的「灵魂」，Harness 让智能体能够理解环境、使用工具，并在真实场景中持续工作。

读完以后，你应该能回答：

1. DeepSeek Harness 到底是什么？
2. 它和 DeepSeek 模型有什么区别？
3. Agent = Model + Harness 应该怎么理解？
4. 为什么使用 DSH 还需要模型、工作区和工具？
5. 第一次使用前需要准备什么？
6. 接下来应该按什么顺序学习？

真正的安装步骤放在下一篇《DeepSeek Harness 安装与启动教程》（/deepseek-harness/install/）。

DeepSeek 官方将 DeepSeek Harness 定义为开源的 agent harness（智能体框架）。它当前采用「一切皆插件」的架构，并由 Cordis 驱动。

官方中文产品页进一步说明，模型、工具、技能、会话、沙箱、存储、循环、调度和 UI 等智能体能力都可以由插件提供和组合。

所以 DSH 不是：

• 一个新的 DeepSeek 模型；
• 一个只有聊天输入框的网页；
• 一个能力完全固定的智能体产品。

它更接近一套可以把模型、工具、会话、权限和其他能力组合起来，让智能体真正运行的基础环境。把这套关系画成一张图会更直观：

示意图点击放大

最容易混淆的是这三个概念。

模型：负责理解和推理

例如 DeepSeek 模型可以：

• 理解你的任务；
• 分析信息；
• 判断下一步该做什么；
• 生成回答；
• 在支持工具调用时决定调用哪个工具。

但模型本身并不等于已经拥有你电脑上的文件、Shell（命令行解释器）、工作区和完整执行环境。

Harness：负责把能力组织起来

Harness 负责提供和组织智能体工作所需要的环境，例如：

• 可以使用哪些工具；
• 可以访问哪些文件；
• 当前工作区在哪里；
• 工具调用怎样真正执行；
• 执行结果怎样返回给模型；
• 会话记录怎样保存；
• 哪些操作需要审批；
• 一项任务需要继续执行时怎样进入下一步。

因此，官方才会用 Agent = Model + Harness 来概括两者的关系。这里不要把这个公式理解成数学定义，它想表达的是：模型提供智能，Harness 提供让这种智能在环境中持续行动的能力。

假设你让 DSH「帮我看看这个项目是做什么的，并找出主要目录」，它不会只让模型凭印象回答。一个简化后的过程更接近：

1. 你提出任务。
2. 模型判断需要查看项目文件。
3. 智能体调用文件相关工具。
4. Harness 执行工具，并把结果返回给模型。
5. 模型根据结果继续判断。
6. 如有需要，再调用新的工具。
7. 最后给出答案。

你现在不需要理解 Agent Loop（智能体循环）、工具注册表、会话事件这些内部实现。在 Learn 阶段先记住：DSH 的价值不只是让模型「回答」，而是给智能体提供真正执行任务所需的环境和能力。这些内部原理以后会放到 Architecture 单独讲。

DSH 现在能让智能体做什么？

根据当前官方 Web UI（网页界面）指南和产品说明，智能体可以在工作区内完成包括：

• 读取和编辑文件；
• 运行命令；
• 使用文件与网页检索；
• 维护计划和目标；
• 委派子代理（subagent）；
• 使用技能；
• 按当前配置调用其他工具。

具体能做什么，不只取决于模型，还取决于：

• 当前 Agent 预设；
• 已安装的插件；
• 可用工具；
• 当前权限；
• 工作区；
• 其他扩展配置。

所以同一个模型放进不同 Harness 配置里，最终能做的事情可以不同。

这里只说「需要什么」，具体怎么安装和配置放到后续教程。

1. Node.js

官方 npm 快速启动路线需要 Node.js（JavaScript 运行环境）。当前仓库要求：

^22.19.0 || >=24.0.0

你现在只需要知道：Node.js 是运行 DSH 所需要的基础运行环境之一。下一篇会教你怎么检查版本。

2. 一个终端

你会在终端中运行官方快速启动命令：

$ npx @deepseek-ai/dsh web

macOS 可以使用「终端」。Windows 可以使用 PowerShell 或 Windows Terminal。刚开始不需要先学大量命令行知识。

3. 一个模型

DSH 是 Harness，不等于模型。要让智能体真正进行推理，需要配置一个模型提供方。当前 Web UI 可以配置 DeepSeek，也支持其他提供方和自定义 API。如果使用 DeepSeek API，需要准备对应的 API Key（API 密钥）。

4. 一个工作区

工作区可以先理解成：当前智能体围绕哪个文件目录工作。例如：

my-project/
├── src/
├── docs/
├── package.json
└── README.md

5. 一个浏览器

运行以下命令后：

$ npx @deepseek-ai/dsh web

当前官方默认在以下地址启动 Web UI：

http://127.0.0.1:3080

127.0.0.1 指向你的本机，不是一个公开网站地址。

第一次使用时，可以先这样分：

• 终端：主要负责启动和管理 DSH 进程。
• Web UI：主要负责配置模型、选择工作区、创建会话，并与智能体交互。

所以你并不需要一直在命令行里和智能体对话。对于第一次接触 Harness 的用户，先把 Web UI 路线走通，是理解 DSH 最直接的方式。

DeepSeek Harness 官方将其描述为本地优先、可扩展的编码智能体与智能体开发运行环境。它可以：

• 访问文件；
• 运行代码；
• 调用工具；
• 与互联网或外部服务交互。

这也意味着它具备真实操作能力，而不只是生成文字。DeepSeek 官方安全使用政策建议：

另外，当你主动配置外部模型、网络工具、MCP 服务或插件后，数据可能由相应的第三方服务处理。

DSHOPC 不建议一开始就研究源码。先走这一条主路径：

1. 新手入门：先知道 DSH 是什么。你正在这里。
2. 安装与启动：成功打开 Web UI。
3. 第一次使用：配好一个模型和测试工作区，完成第一个真实智能体任务。
4. 模型配置：学会 DeepSeek、其他提供方和自定义 API。
5. Web UI：学会工作区、会话、工具调用、轨迹和权限等日常操作。
6. Agent 预设：理解标准模式、PTC 模式（Programmatic Tool Calling，程序化工具调用）、极简模式和创造模式怎么选。

完成这些以后，再进入「插件、技能和 MCP 怎么选」，然后根据需求进入不同扩展路线。

如果任何一步出问题，直接进入《常见问题与报错排查》（/deepseek-harness/troubleshooting/），不需要等到最后才看。

以后在 DSHOPC 看到这四个栏目，可以这样判断。

Learn：我该怎么用？

例如：插件怎么安装？

Architecture：为什么这样运行？

例如：插件为什么能改变 Harness 的能力？

Ecosystem：现在有哪些能力和项目？

例如：有哪些 Browser 类插件或 MCP Server（基于 MCP 提供工具的服务）？

Lab：当前版本到底能不能用？

例如：某个插件在 DSH 0.1.1-rc.2 上是否真的能安装、启动并完成核心功能？

现在不需要提前学这些词

刚开始看到这些名词很正常：

• Cordis
• profile
• 组合包
• patch（补丁）
• Agent Loop
• 会话事件
• 工具注册表
• 技能
• MCP
• 子代理
• 工作流

安装 DSH 之前，不需要全部理解。Learn 的顺序是：先会用，再逐步理解。真正想研究内部原理时，再进入 Architecture。

这篇是概念入门，不需要为了「验证」去运行任何危险操作。你只需要能够回答三个问题：

如果这三个问题已经清楚，这篇就完成了。

继续：《DeepSeek Harness 安装与启动教程》（/deepseek-harness/install/）。目标非常明确：让 npx @deepseek-ai/dsh web 真正跑起来，并成功打开 Web UI。

安装完成以后，再进入《DeepSeek Harness 第一次使用：从启动到完成第一个智能体任务》（/deepseek-harness/first-run/）。

把眼光放远一点：Learn 一共 12 篇教程，你现在站在起点。完整路线如下图：

示意图点击放大

DSHOPC 分析 / 建议

以下内容属于 DSHOPC 面向新手的教学组织，不代表 DeepSeek 官方强制要求：

• 第一次使用先准备专门测试目录；
• 先走 Web UI 主路径，再研究源码；
• Learn / Architecture / Ecosystem / Lab 的内容分工；
• 本文「读完怎样算学会」的三个检查问题。