DeepSeek Harness：Agent = Model + Harness

Fen9Pi2026/8/14大约 7 分钟

前言：DeepSeek 的 Agent 野心

2026-08-14 08:40 GMT+8

AI Agent 的困境：

有了强大的模型，但如何构建实用的 Agent？
如何接入文件系统、终端、网页？
如何组织上下文、工具调用和任务执行？
如何从原型到生产？

DeepSeek 的答案：

Model + Harness = Agent

今天介绍 DeepSeek Harness——由 DeepSeek 自己开发的 Agent Harness，负责把模型接入文件系统、终端、网页、代码工具和其他 Agent，并组织上下文、工具调用和任务执行的一整套 Agent 运行框架。

一、项目概览

DeepSeek Harness 是一个由 DeepSeek 自己开发的 Agent Harness。

一句话说清楚：

不是新的基础模型或者一个 API 客户端，而是负责把模型接入文件系统、终端、网页、代码工具和其他 Agent，并组织上下文、工具调用和任务执行的一整套 Agent 运行框架

核心公式：

Agent = Model + Harness

项目地址：https://github.com/deepseek-ai/deepseek-harness 开源协议：MIT 技术栈：Node.js, TypeScript

二、核心设计

一切皆插件

设计思路："

DeepSeek Harness 采取"一切皆插件"的设计思路

插件式开放架构：

模型（Model）
工具（Tools）
技能（Skills）
会话（Sessions）
沙箱（Sandboxes）
存储（Storage）
循环（Loops）
调度（Schedulers）
UI（用户界面）

所有 Agent 能力均由插件组合而成：

可自由替换
灵活重组

三、核心架构

Agent = Model + Harness

流程图1

价值：

Model：提供智能
Harness：提供能力
Agent：最终产品

核心组件

1. 模型插件

DeepSeek-V3
DeepSeek-V4
第三方模型

2. 工具插件

文件系统
终端
网页
代码工具

3. 技能插件

工作流
任务模板
最佳实践

4. 会话插件

多轮对话
上下文管理
状态保持

5. 沙箱插件

安全隔离
资源限制
多租户

6. 存储插件

文件存储
数据库
缓存

7. 循环插件

任务循环
迭代优化
自进化

8. 调度插件

任务调度
优先级管理
并发控制

9. UI 插件

Web UI
CLI
API

四、快速开始

30 秒启动 Web UI

安装 Node.js：

# macOS
brew install node

# Linux
sudo apt install nodejs

# Windows
# 从 https://nodejs.org 下载安装

启动 DeepSeek Harness：

npx @deepseek-ai/dsh web

访问 Web UI：

浏览器自动打开
或手动访问 http://localhost:3000

基本使用

1. 创建第一个 Agent：

import { Agent } from '@deepseek-ai/dsh';

const agent = new Agent({
  model: 'deepseek-v4',
  tools: ['file-system', 'terminal'],
  skills: ['coding-assistant']
});

await agent.run('帮我创建一个 Python 项目');

2. 添加工具：

agent.addTool('web-browser', {
  enabled: true,
  config: {
    headless: true
  }
});

3. 添加技能：

agent.addSkill('code-review', {
  template: 'review-code',
  context: {
    language: 'python',
    standards: ['PEP8']
  }
});

五、核心功能

1. 模型接入

支持多种模型：

DeepSeek-V3
DeepSeek-V4
DeepSeek-V4-Flash
第三方模型（OpenAI, Anthropic, ...）

配置模型：

const agent = new Agent({
  model: {
    provider: 'deepseek',
    model: 'deepseek-v4',
    apiKey: process.env.DEEPSEEK_API_KEY,
    config: {
      temperature: 0.7,
      maxTokens: 4096
    }
  }
});

2. 工具系统

内置工具：

文件系统（read, write, delete）
终端（exec）
网页（browse）
代码工具（parse, analyze）

自定义工具：

agent.addTool('custom-tool', {
  description: '自定义工具',
  execute: async (params) => {
    // 自定义逻辑
    return result;
  }
});

3. 技能系统

什么是技能：

工作流
任务模板
最佳实践

创建技能：

agent.addSkill('blog-post', {
  name: '博客文章生成',
  template: `
    1. 分析需求
    2. 搜索资料
    3. 撰写大纲
    4. 撰写内容
    5. 检查优化
  `,
  tools: ['web-browser', 'file-system']
});

4. 会话管理

多轮对话：

const session = await agent.createSession();

await session.sendMessage('帮我分析这个项目');
await session.sendMessage('重点看性能优化');
await session.sendMessage('给出优化建议');

// 查看历史
const history = session.getHistory();

5. 沙箱隔离

安全隔离：

const sandbox = await agent.createSandbox({
  allowedPaths: ['/tmp/workspace'],
  maxMemory: '512MB',
  maxCpu: 0.5,
  network: false
});

await sandbox.run('ls -la');

6. 存储系统

文件存储：

await agent.storage.write('output.txt', 'Hello, World!');
const content = await agent.storage.read('output.txt');

数据库：

await agent.storage.db.insert('tasks', {
  title: 'Write documentation',
  status: 'pending'
});

const tasks = await agent.storage.db.query('tasks', {
  status: 'pending'
});

7. 循环系统

任务循环：

agent.addLoop('optimization', {
  iterations: 3,
  each: async (context) => {
    // 优化逻辑
    return improvedResult;
  }
});

8. 调度系统

任务调度：

agent.schedule('daily-report', {
  cron: '0 9 * * 1-5',
  task: async () => {
    await agent.run('生成日报');
  }
});

六、高级特性

1. 插件开发

开发自定义插件：

import { Plugin } from '@deepseek-ai/dsh';

class MyPlugin extends Plugin {
  async onLoad() {
    // 加载逻辑
  }

  async onUnload() {
    // 卸载逻辑
  }

  async execute(params) {
    // 执行逻辑
    return result;
  }
}

agent.registerPlugin(new MyPlugin());

2. 子 Agent 编排

创建子 Agent：

const subAgent = await agent.createSubAgent({
  name: 'code-analyzer',
  tools: ['code-parser', 'linter'],
  skills: ['code-analysis']
});

const result = await subAgent.run('分析这个代码库');

3. 多用户隔离

用户隔离：

const userSession = await agent.createUserSession({
  userId: 'user-123',
  namespace: 'user-123',
  isolation: 'strict'
});

await userSession.run('创建文件');

4. 自进化机制

Agent 自进化：

agent.enableSelfEvolution({
  feedback: 'user-rating',
  learning: 'reinforcement',
  improvement: 'automatic'
});

七、实际应用场景

场景 1：代码开发助手

需求：AI 辅助代码开发

使用 DeepSeek Harness：

const agent = new Agent({
  model: 'deepseek-v4',
  tools: ['file-system', 'terminal', 'code-analyzer'],
  skills: ['coding-assistant']
});

await agent.run('创建一个 Python API 项目');

场景 2：数据分析

需求：自动分析数据

使用 DeepSeek Harness：

const agent = new Agent({
  model: 'deepseek-v4',
  tools: ['file-system', 'data-processor'],
  skills: ['data-analysis']
});

await agent.run('分析 sales.csv 并生成报告');

场景 3：自动化办公

需求：自动化办公流程

使用 DeepSeek Harness：

const agent = new Agent({
  model: 'deepseek-v4',
  tools: ['file-system', 'email', 'calendar'],
  skills: ['office-automation']
});

await agent.run('整理会议纪要并发送给参会人员');

场景 4：内容生成

需求：批量生成内容

使用 DeepSeek Harness：

const agent = new Agent({
  model: 'deepseek-v4',
  tools: ['web-browser', 'file-system'],
  skills: ['content-generation']
});

await agent.run('根据这些关键词生成 10 篇博客文章');

八、架构对比

vs 传统 Agent 框架

维度	DeepSeek Harness	传统框架
插件化	✅ 一切皆插件	⚠️ 部分插件化
模型支持	✅ 多模型	⚠️ 单一模型
工具系统	✅ 内置 + 自定义	⚠️ 有限工具
技能系统	✅ 内置技能库	❌ 无技能系统
沙箱隔离	✅ 多级隔离	⚠️ 简单隔离
自进化	✅ 支持	❌ 不支持
UI	✅ Web UI + CLI + API	⚠️ 有限 UI

vs LangChain

维度	DeepSeek Harness	LangChain
定位	Agent 运行框架	LLM 应用框架
插件化	✅ 一切皆插件	⚠️ 部分插件化
模型支持	✅ 多模型	✅ 多模型
工具系统	✅ 内置 + 自定义	✅ 丰富工具
技能系统	✅ 内置技能库	❌ 无技能系统
自进化	✅ 支持	❌ 不支持
UI	✅ Web UI + CLI + API	⚠️ 有限 UI

九、核心价值

1. 一切皆插件

插件式开放架构：

模型、工具、技能、会话、沙箱、存储、循环、调度、 UI
所有 Agent 能力均由插件组合而成
可自由替换、灵活重组

2. Model + Harness = Agent

清晰的分层：

Model：提供智能
Harness：提供能力
Agent：最终产品

3. 从原型到生产

完整的开发链路：

快速原型
技能复用
沙箱隔离
自进化

4. 多模型支持

支持多种模型：

DeepSeek-V3/V4
第三方模型
本地模型

5. 开箱即用

30 秒启动：

npx @deepseek-ai/dsh web

十、总结

核心问题

AI Agent 的困境：

有了强大的模型，但如何构建实用的 Agent？
如何接入文件系统、终端、网页？
如何组织上下文、工具调用和任务执行？

DeepSeek Harness 的解决方案

1. Agent = Model + Harness

Model：提供智能
Harness：提供能力
Agent：最终产品

2. 一切皆插件

模型、工具、技能、会话、沙箱、存储、循环、调度、UI
可自由替换、灵活重组

3. 从原型到生产

快速原型
技能复用
沙箱隔离
自进化

4. 多模型支持

DeepSeek-V3/V4
第三方模型
本地模型

5. 开箱即用

30 秒启动
Web UI
CLI
API

为什么选择 DeepSeek Harness？

1. 一切皆插件

插件式开放架构
可自由替换、灵活重组

2. Agent = Model + Harness

清晰的分层
Model 提供智能、Harness 提供能力

3. 从原型到生产

快速原型
技能复用
沙箱隔离
自进化

4. 多模型支持

支持多种模型
可灵活切换

5. 开箱即用

30 秒启动
Web UI
CLI
API

记住

DeepSeek Harness 是一个由 DeepSeek 自己开发的 Agent Harness。
不是新的基础模型或者一个 API 客户端，而是负责把模型接入文件系统、终端、网页、代码工具和其他 Agent，并组织上下文、工具调用和任务执行的一整套 Agent 运行框架。
Agent = Model + Harness

附：资源链接

项目资源：

GitHub：https://github.com/deepseek-ai/deepseek-harness
官网：https://www.deepseek.com
License：MIT

安装速查：

# 安装 Node.js
brew install node

# 启动 DeepSeek Harness
npx @deepseek-ai/dsh web

# 访问 Web UI
# 浏览器自动打开 http://localhost:3000

基本使用：

// 创建 Agent
import { Agent } from '@deepseek-ai/dsh';

const agent = new Agent({
  model: 'deepseek-v4',
  tools: ['file-system', 'terminal'],
  skills: ['coding-assistant']
});

// 运行
await agent.run('帮我创建一个 Python 项目');

// 添加工具
agent.addTool('web-browser', {
  enabled: true,
  config: { headless: true }
});

// 添加技能
agent.addSkill('blog-post', {
  name: '博客文章生成',
  template: '分析需求 → 搜索资料 → 撰写内容'
});