DeepSeek智能体搭建教程：Harness部署、API配置与任务执行
DeepSeek智能体并非一个独立的App，而是通过DeepSeek官方开源的Agent运行框架 DeepSeek Harness（简称dsh） 来搭建的。它的核心公式是 Agent = Model + Harness——模型是智能体的“大脑”，负责推理；Harness是智能体的“手脚”，赋予模型读写文件、执行命令、调用工具、调度子任务的实操能力。本文覆盖从环境准备、部署安装、API配置到运行第一个Agent任务的完整流程。
一、前提条件：环境准备
部署DeepSeek Harness之前，请确认本机满足以下条件：
| 依赖项 | 要求 |
|---|---|
| Node.js | ^22.19.0 或 >=24.0.0 |
| pnpm（源码安装时） | 11.7.0 |
| Git（源码安装时） | 2.26+ |
| DeepSeek API Key | 建议配置，智能体需要LLM后端 |
操作系统跨平台支持，Windows、macOS、Linux均可。
二、部署方式：两种安装路径
方式一：npx一键启动（推荐首次体验）
安装Node.js后，直接在终端运行：
npx @deepseek-ai/dsh web命令会自动拉取并启动Web UI，服务默认跑在 http://127.0.0.1:3080，浏览器打开即可开始配置。不需要事先clone仓库，适合快速验证。
方式二：源码安装（适合自定义开发）
如果需要修改插件、查看文档或参与开发，从源码安装：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web源码安装提供完整的项目结构，方便修改插件和深度定制。
三、配置模型：接入DeepSeek API
Web UI启动后，第一件事是配置模型。
- 进入 Settings → Models
- 在DeepSeek卡片中填入你的API Key并保存
- 模型路由保存后立即可用，无需重启服务
API Key从DeepSeek开放平台（platform.deepseek.com）获取。Harness对模型提供商完全开放，除了官方DeepSeek接口，也支持Anthropic、OpenAI、AWS Bedrock、微软Azure和谷歌Gemini等主流平台。
四、指定工作区并运行第一个任务
配置模型后，点击 Choose workspace，添加并选择一个工作目录。工作区让Harness可以访问指定文件夹内的文件。
配置完成后，即可在主界面创建会话，向AI下达指令。例如：
读取当前目录下的 README.md，总结这个项目是做什么的Harness会自动调用模型进行推理，执行文件读取操作，并将结果返回给你。所有操作都会写入仅追加的会话日志，包括系统提示词、思维链、工具调用与结果，方便随时回溯和调试。
五、四种运行模式的选择
Harness提供四种运行模式，可根据任务类型灵活切换：
- 标准模式：功能完整的编码Agent，支持文件编辑、Shell、搜索、Skills、子Agent等，适合日常开发
- PTC模式：通过Code Mode SDK让模型用TypeScript程序组合多步操作，适合需要自动化的长任务
- 极简模式：仅保留Shell与文件编辑两大工具，用于模型基准测试
- 创造模式：用于创建自定义Agent Preset，适合深度定制Agent行为的开发者
六、总结
DeepSeek智能体的搭建可以概括为三个步骤：部署Harness → 配置API Key → 指定工作区并下达任务。推荐首次使用npx一键启动方式，几分钟即可跑通第一个Agent任务。需要深度定制时再切换到源码安装。Harness目前处于开发者预览阶段（v0.1.x），官方明确提示会有破坏性变更，正式项目依赖时建议锁定版本。
