ARTICLE · 1185276
智能体框架插件化相关实践与思考



围栏工程(Harness)是智能体除模型外的整套运行驾驭层。早期业界侧重调整Prompt和升级模型权重,而产业实践逐步发现,智能体任务拆解失败、工具容错差、状态错乱等问题根源在于工程缺陷,并可通过外部运行层进行约束。2025年Anthropic公司提出Harness概念,2026年上半年Harness Engineering逐步形成行业共识,但现有框架普遍存在内核难以替换的局限。DeepSeek-Harness以“一切皆插件”理念探索该问题的工程解法,将模型适配、运行核心、工具能力、会话存储、安全沙箱、UI配置六类组件全部插件化,支持热插拔与全链路事件日志回放。对比Claude Code、OpenAI Codex CLI、LangGraph等主流框架,DeepSeek-Harness的优势在于实现全组件可替换、无模型绑定,但在插件依赖治理、API调用成本、第三方插件供应链安全方面仍存在现实挑战。从产业实践看,插件化围栏工程框架具备成为智能体工程化范式的潜力,但生态治理与安全审核体系仍需在落地过程中持续完善。

智能体发展早期,业界优化重心集中于提示词调优与大模型权重迭代,普遍认为模型推理能力提升即可直接带动Agent任务表现。但大量落地实践证明,很多Agent任务失败并非源于模型推理短板,而是外部运行层工程存在缺陷:任务拆解失效、工具调用容错不足、上下文丢失、状态错乱、失败链路无法回滚,这类问题仅依靠Prompt调优难以根治。
围栏工程(Harness)概念的实践萌芽来自Anthropic在2025年11月发布的工程博客。Anthropic提出了Harness概念,用来指代长任务Agent除模型以外的整套运行驾驭层,并率先在Claude Agent SDK内部落地Harness工程实践,不过当时仅有闭源内部实现,没有对外开源底座,而行业内更多是产品实践,未能形成通用开源框架。2026年初,Harness Engineering逐步成为行业共识,OpenAI、Anthropic、LangChain都分别输出Harness相关技术文档与实现,但是普遍存在框架内核不可替换的情况,开发者只能做外围扩展,无法修改Agent核心循环与调度逻辑。

DeepSeek-Harness v0.1开发者预览版于2026年8月对外开源发布,上线时GitHub涨星速度创下行业纪录,发布12小时Star突破5万,截至9月已突破21万星,成为2026年AI领域现象级开源项目,此后持续完善插件能力与运行特性。9月29日,DeepSeek正式发布DeepSeek-Harness v0.2预览版,并同步上线macOS与Windows桌面端安装包,新版本预置了面向日常办公和开发的常用功能,新增插件安装与管理页面,并提供更多灵活配置选项,让插件能力开箱即用。
DeepSeek-Harness 项目并非全新大模型,而是一套AI智能体(Agent)运行时底座,口号为“Everything is a Plugin(一切皆插件)”。如果说大模型是Agent的大脑,负责思考推理,那么Harness则是Agent的躯体,承担模型之外全部工程工作,包括工具调用、任务循环、会话状态管理、错误容错、子智能体调度、权限管控、日志审计等能力,让大模型能够落地完成真实世界任务。
不同于市面上下载即用的成品Agent工具,DeepSeek-Harness定位为面向开发者的底层框架,并不绑定特定大模型,支持接入数十家厂商的模型服务,开发者可以自由拼装、替换全部内部组件,实现高度自定义的智能体系统。
(一)DeepSeek-Harness的六类主要插件
DeepSeek-Harness依托Cordis元框架作为底层内核,Cordis本身不承载任何Agent业务逻辑,只负责插件加载、依赖解析、组件生命周期管理。该元框架基于时空可组合性理论,实现两大核心特性:时间可组合性(插件卸载时自动回滚产生的副作用)与空间可组合性(依赖项发生变更时自动启停对应插件),以此保障插件可以热插拔,运行结束后不会遗留脏状态。
在DeepSeek-Harness框架内部,几乎所有业务能力均以插件形式实现,不存在特权固化内核,核心组件均可被开发者替换与修改。框架主要插件组件分类如下:
1.模型适配插件:对接各家大模型API,完成请求封装,同时支持本地模型服务;
2.运行核心插件:Agent主循环、任务调度、子Agent编排、终止条件判断,Agent循环本身也为普通插件,可以整体替换;
3.工具能力插件:文件读写、Shell命令执行、网页检索、技能Skill、MCP协议对接插件;
4.会话存储插件:采用仅追加Append-Only事件日志的方式,完整记录模型输入输出、工具调用全过程,支持会话回放、分叉、断点恢复;
5.安全沙箱插件:工作区权限管控、操作审批机制、命令执行沙箱;
6.UI与配置插件:Web交互界面、配置解析模块。
(二)DeepSeek-Harness的四类预设模式
DeepSeek-Harness官方封装了四套预设Profile模式(标准、PTC、极简和创造),其本质是加载不同插件组合,以分别对应从日常开发、工具链集成、模型基准测试到高阶Agent定制的不同场景需求。
1.标准模式(Standard):全量工具集,文件编辑、Shell、检索、子Agent,适配绝大多数开发任务;
2.程序化工具调用模式(PTC):由模型生成TypeScript代码批量编排多步工具调用,减少模型往返,可用于提升批量任务效率;
3.极简模式(Minimal):仅保留Shell与文本编辑器,用于模型Agent基准评测,消除额外插件干扰;
4.创造模式(Creator):支持运行时调试插件、动态新增修改插件,面向插件开发实验场景,不建议生产使用。
使用者只需要根据任务目标选择对应的运行Profile模式,切换模式即完成一批插件的批量加载与卸载,无须手动逐个增删组件。选定模式后即可发起Agent任务,对于文件修改、命令执行等高风险动作,系统会触发人工审批机制,确认之后才会执行对应操作。

对于Deepseek-Harness而言,同类产品主要包括闭源成品Agent工具(Claude Code、OpenAI Codex CLI等)及开Agent框架(LangGraph等)。Claude Code与OpenAI Codex CLI属于闭源成品Agent工具,开箱即用但内核逻辑固化、绑定特定模型生态,开发者仅能通过少量钩子做有限扩展;LangGraph作为成熟开源框架,支持模型无关的Agent编排,但主循环框架内核不可整体替换,扩展仍以钩子为主。DeepSeek-Harness则走了一条更彻底的路径:全部组件可替换,Agent主循环可完整拆卸重写,不绑定任何模型,并依靠Append-Only事件日志实现完整会话回放与复现调试。
DeepSeek-Harness不再局限于传统Agent框架“内核固化、外围扩展”的模式,突破性实现了“一切皆插件”:开发者对任务循环、上下文管理、工具调度逻辑不满意时,无须Fork修改源码,直接替换对应插件即可。在工程可靠性方面,DeepSeek-Harness提供全链路Append-Only事件日志,每一步模型输入输出、工具调用全部留存,支持会话回放与分叉调试,可快速定位Agent故障根因,区分模型bug、prompt bug与工具bug。底层由Cordis机制提供插件可撤销、依赖自动协调能力,为自修改、自进化Agent的研究提供了可复现的实验环境。

围栏工程是智能体从演示走向生产的关键工程层,涵盖任务循环、工具调用、状态管理、权限管控、日志审计、错误容错六大技术方向。插件化是应对围栏工程多样化需求的必然选择,它解决了传统框架内核固化、模型绑定、组件耦合、可审计性不足等根本问题。
作者:
殷兴华
就职于中国移动研究院业务所,主要从事6G领域研究工作。
沈子萱
就职于中国移动研究院业务所,主要从事6G、AI领域研究工作。
杨蕾 | 业务研究所

智能体行为围栏:Agent治理框架与实践路径
2026年“词元(Token)经济”研究综述
我国各地词元经济发展情况梳理与浅析

















































































