做 AI Agent 开发的同学大概都有这个体会:框架不少,但能把模型能力、工具调用、会话管理、沙箱执行灵活组合起来的,选来选去选项不多。很多框架把能力写死在代码里,换个模型或加个自定义工具,改起来牵一发动全身。Agent 开发这件事,离"即插即用"还有段距离。
最近 DeepSeek 团队开源了 DeepSeek Harness(简称 dsh),思路很干脆,所有能力都是插件,模型是插件、工具是插件、会话是插件、连 UI 也是插件,配置文件里声明要用哪些,组合一下就行,不用碰源码。

介绍
DeepSeek Harness 是 DeepSeek AI 团队搞的开源 Agent 编排框架,目前还在开发者预览阶段。底层用了一个叫 Cordis 的插件系统管整个生命周期,挂载、卸载、依赖关系全由 Cordis 内核处理。
设计公式很简洁:Agent = Model + Harness。模型负责"想",Harness 负责"做",理解环境、调工具、跑任务。两部分拆开,换模型不影响工具链,扩展起来利索。

和几个常见方案对比一下
从表里能看到,Claude Code 和 OpenAI Codex 都是闭源的,能力边界由厂商定,想自定义基本没戏。Hermes Agent 虽然开源,但扩展靠继承类,改起来耦合不低。DeepSeek Harness 的插件化思路在这个赛道里确实比较独特,不用写代码继承,配置文件里声明就能组装。

特点
插件化架构
是它跟其他框架拉开差距的核心。模型适配、工具注册、技能加载、会话持久化、沙箱隔离、存储管理、循环调度,甚至前端 UI,全是插件。插件之间靠 Cordis 的服务和事件通信,耦合度很低,想换哪个换哪个。
全链路可追溯
在调试时特别管用。模型看到的系统提示、推理过程、工具调用和返回、子 Agent 调度,全部记在只追加的会话日志里。恢复、分叉、搜索、回放都基于同一条事件流,排查问题不用再猜。
四种运行模式覆盖不同场景:Standard 全套工具日常编码够用,Code 模式让模型写 TypeScript 编排多步调用,Minimal 只留两个工具做模型评测,Creator 给插件开发者做实验。
技术架构与部署
TypeScript + Node.js 技术栈,pnpm 构建,底层 Cordis 插件内核管生命周期,上层能力插件通过服务与事件协同。
前端 Web UI 提供会话交互和 Trajectory 查看,后端 Node.js + Cordis 内核,还带 Python SDK。
一行命令启动:
npx @deepseek-ai/dsh web默认监听 http://127.0.0.1:3080,设置页配好模型 API 密钥,添加工作区目录就能用。
从源码构建也支持,git clone 后 pnpm install && pnpm run build 即可。
MIT 协议开源,商用没问题。

即刻体验一波
装好 Node.js,跑 npx @deepseek-ai/dsh web,浏览器打开就能看到 Web UI。填上 API 密钥保存,模型路由秒生效。
加一个本地项目目录作为工作区,会话里输入"帮我分析这个仓库的结构",Agent 就会自己读文件、跑命令、分析代码结构,把结果整理给你。Trajectory 视图里能逐步回看全过程,模型看了什么、调了什么、中间怎么想的,清清楚楚。
想试 Code 模式就切过去,模型会生成 TypeScript 代码编排多轮调用。做评测就切 Minimal,干净利落。







结语
DeepSeek Harness 做了一件很本质的事:让能力组合变成配置问题,不是开发问题。 全链路可追溯加上多种运行模式,日常做 Agent 开发的话,值得看看。

最近花叔写了一本关于 DeepSeek Harness 的 橙皮书,打包好了,有兴趣的可以回:橙皮书 ,免费发给大家。
感谢大家支持!
项目仓库:https://github.com/deepseek-ai/deepseek-harness
往期项目
开源|一款把 Word、PPT、Excel、PDF 等 14 种办公文档转成 Markdown 的工具
开源|一款AI CRM 系统,覆盖线索到回款全流程,支持私有化部署与 AI 智能体集成
开源|一款多数据源开发管理工具,支持21种数据库、SQL审核、数据脱敏与CI/CD
开源|一款可交互系统架构地图工具,支持 5 种技术图、深浅主题及单 HTML 交付
开源|一款AI驱动的数据库客户端,支持40+种数据库、自然语言转SQL及可视化数据分析
了解更多:
DeepSeek Harness、AI Agent、开源框架、插件化架构、Cordis、Agent 编排、代码助手、模型评测
夜雨聆风