大厂开发者必看：DeepSeek Harness全解析！读懂“一切皆插件”的Agent新框架

m0_62020051

877人浏览 · 2026-08-15 22:44:28

m0_62020051 · 2026-08-15 22:44:28 发布

大厂开发者必看：DeepSeek Harness全解析！读懂“一切皆插件”的Agent新框架

前言

2026‑08‑13，DeepSeek正式开源 DeepSeek Harness（简称DSH，命令行dsh），MIT协议发布开发者预览版，瞬间引爆AI Agent开发者社区。

很多同学只听说过大模型权重发布，却不理解什么是Harness。简单记住官方核心公式：

Agent = Model + Harness

模型负责思考推理；Harness负责对接真实世界环境：文件读写、Shell命令、工具调用、会话管理、沙箱隔离、任务调度。只有模型，只会聊天；加上Harness，Agent才能真正动手干活。

市面上已经有LangChain、AutoGPT、Claude Code等Agent产品，DeepSeek Harness最大亮点就是一切皆插件（Everything is a Plugin），几乎所有组件都支持热插拔替换，不用修改框架源码即可完成定制开发。本文从定位、底层Cordis架构、四大运行模式、快速上手、与同类框架对比、适用场景、踩坑总结完整梳理，适合后端、AI应用开发同学阅读。

一、什么是DeepSeek Harness

DeepSeek Harness 是一套Agent运行时框架，不是大模型，不是开箱即用成品Agent产品，而是搭建自定义智能体的基础设施。

通俗比喻：

大模型 = 发动机，负责思考输出
Harness = 整套传动控制系统：方向盘、变速箱、刹车、传感器，负责把发动机的想法变成现实世界的动作。

它的核心能力清单：

模型无关：不限于DeepSeek模型，可对接OpenAI、Kimi、Anthropic等几乎主流大模型，切换仅改配置文件。
全组件插件化：模型适配器、工具、技能、会话、沙箱、存储、Agent循环、调度、UI全部是插件。
完整可追溯：append‑only追加式会话日志，不会删除原始历史，支持任务回放、审计排查问题。
沙箱安全机制：文件、Shell执行权限可控，高危操作支持人工审批。
支持WebUI、命令行、Python SDK三种使用方式。

误区澄清：不要和 lm‑evaluation‑harness（大模型评测工具）混淆，DeepSeek Harness是面向Agent应用运行框架，不是评测基准工具。

二、底层核心：Cordis内核架构

整个Harness建立在自研 Cordis插件元框架 之上，这也是“一切皆插件”能力的来源，源自论文《A Programming Paradigm for Spatiotemporal Composability》。

Cordis三层架构

Cordis Kernel内核层
内核极度精简，只做三件事：插件挂载、卸载、依赖解析管理。内核不包含任何业务能力，连Agent循环、模型调用能力都由插件提供，不存在特权核心模块。
插件层
所有能力全部下沉为插件：

模型适配器插件：对接各家大模型API
Tool工具插件：读写文件、shell执行、搜索、代码执行
Session会话插件：会话存储、上下文管理
Sandbox沙箱插件：安全隔离执行环境
Loop循环插件：Agent思考‑行动循环逻辑
UI插件：Web前端界面

插件之间依靠服务与事件机制通信，互不强耦合。

配置Profile层
通过yaml配置声明需要加载哪些插件，开发者修改配置文件，不用修改源码，就可以组装出完全不同的Agent。一份配置可以打包成profile配置包，实现一键复用、分享Agent模板。

Cordis两大关键特性

空间可组合性：插件依赖发生变更，框架自动重新编排依赖关系，支持动态增删插件。
时间可组合性：卸载插件可以完整撤销插件带来的副作用，保证运行时热插拔安全，这也是Agent可以自我修改、自我安装插件的底层基础。

三、四种运行模式详解

Harness内置4种工作模式，适配不同开发场景，很多新手分不清模式差异：

标准模式（Standard）
完整能力，内置全套工具、上下文管理、错误重试，适合绝大多数日常编码、项目改造任务，日常开发首选。
PTC模式（Plain Tool Call）
去掉复杂的上层封装，仅保留基础工具调用能力，适合做基准对比，对比不同模型原生工具调用能力。
极简模式（Minimal）
几乎砍掉所有附加能力，仅保留最基础模型调用，系统提示词极简。用于模型裸能力基准测试，不适合日常业务使用。
创造模式（Create）
Harness最有特色的模式。拥有标准模式全部能力，并且允许Agent读取当前Cordis运行环境，Agent可以现场编写、安装、卸载插件改造自身能力。

示例需求：“帮我开发一个只做代码安全审计，禁止修改文件的Agent插件，直接加载到当前环境运行”。
相当于Agent可以给自己造工具，是自进化智能体的雏形能力。

四、快速上手：三种启动方式

前置依赖：Node.js ≥22.19；Python SDK需要Python ≥3.10

方式1：npx一键启动WebUI（最简单，推荐体验）

npx @deepseek-ai/dsh web

执行完成后，访问 http://127.0.0.1:3080，填入API Key，选择工作目录即可直接使用。

方式2：源码编译运行（二次开发）

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

方式3：Python SDK集成到业务代码

pip install deepseek-harness-sdk

from pathlib import Path
from deepseek_harness import DeepSeekHarness

config = Path("./minimal.cordis.yml").resolve()
workspace = Path("/opt/my_project").resolve()
sessions = Path("./sessions").resolve()

with DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-v4-flash",
    max_tokens=49152,
    cwd=str(workspace),
    session_root=str(sessions),
    cordis=str(config)
) as harness:
    result = harness.run(
        "阅读项目代码，修复单元测试报错",
        session_id="task‑001"
    )
    print(result.final_response)

五、DeepSeek Harness vs 同类Agent框架对比

框架	核心特点	定位
DeepSeek Harness	Cordis一切皆插件，内核无特权组件，可热插拔，会话完整可追溯，MIT协议	通用Agent运行时，可自定义组装任意Agent
Claude Code	Anthropic闭源，编程Agent成品，能力固化	面向开发者编程助手
LangChain	链式编排，生态丰富，组件多，但核心逻辑固化，很难热替换核心循环	应用开发编排库
AutoGPT	早期Agent代表，简单循环，可定制能力弱	单机Demo智能体