DeepSeek-Harness 框架详解：Agent = 大模型 + Harness

先说个容易踩的坑：网上搜“DeepSeek-Harness”，很容易搜到一个叫 lm-evaluation-harness 的大模型评测框架，很多人就把这俩混为一谈。

不是一回事。 今天要讲的 DeepSeek-Harness（简称 dsh），是 DeepSeek 在 2026-08-13 开源的通用 Agent 运行驾驭框架——MIT 协议，目前是开发者预览版。它不做评测，它负责让 Agent 真正跑起来。

记住一句话公式就够了：

Agent = 大模型 + Harness

一、核心设计理念：Everything is a Plugin（一切皆插件）

这是 dsh 最核心的设计。底层内核用的是 Cordis 插件系统，所有能力全部拆成独立插件——不需要改框架源码，只靠配置就能替换、增删任意模块：

插件之间通过统一事件总线通信，可以运行时挂载/卸载，支持动态扩展。

翻译成大白话：框架是一张空桌子，所有能力都是可以自由插拔的模块——想换模型就换模型，想加工具就加工具，想改逻辑就改逻辑，不用动桌子本身。

会话日志只追加、永不删除原始记录。上下文压缩也不会删掉历史——它只是新增一条“视图替换事件”。

这意味着什么？你可以随时回溯 Agent 完整的思考与工具调用全过程，方便调试、审计、复现故障。Agent 干了什么、为什么这么干，永远查得到。

提供隔离执行环境，限制 Agent 读写文件、执行命令的权限——降低自主智能体误删文件、执行高危指令的风险。

同时支持人工审批高危操作。让 Agent 干活，但关键动作你说了算。

对比 LangChain / LlamaIndex： LangChain 偏向链式调用、RAG；Harness 原生面向自主 Agent 循环、长任务、工具执行沙箱、子 Agent 编排，而且插件化粒度更细，更容易完整替换任意组件。

对比 Claude Code / Cursor Agent： Claude Code 是成品编程 Agent，开箱即用；dsh 是底座框架——你可以自由更换模型、自定义全套 Agent 逻辑，自己搭建专属的编程 Agent 或通用业务 Agent。

一句话总结：LangChain 给你拼积木的方法，Claude Code 给你拼好的成品，dsh 给你一个可以自由改装的车架。

要求：Node.js ≥ 22.19

一键拉起 Web 控制台：

npx @deepseek-ai/dsh web

或者克隆源码自己折腾：

git clone https://github.com/deepseek-ai/deepseek-harness

DeepSeek-Harness 的定位很清楚：它是 DeepSeek 在 Agent 基础设施上的布局——把“模型能力”和“Agent 执行能力”做了解耦，模型用插件的说法接入，执行底盘做得足够工程化。

对想自己搭 Agent 的人来说，这是值得盯着的项目：框架现在刚起步（预览版），但设计理念是对的——一切皆插件、日志可追溯、默认带沙箱。 这几个点，恰好是当前很多 Agent 项目最容易翻车的地方。

等生态补齐、接口稳定后，它很可能成为自建 Agent 的一个主流底座。想尝鲜的，拿 Node 22.19 跑一句 npx @deepseek-ai/dsh web 就完事。