乐于分享
好东西不私藏

开源|一款模型/工具/沙箱/UI 皆插件,配置即组合的 Agent 编排框架,可私有部署商用

开源|一款模型/工具/沙箱/UI 皆插件,配置即组合的 Agent 编排框架,可私有部署商用

做 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
架构思路
CLI 命令行工具,专注终端交互
闭源云端 Agent 运行环境
脚本式 Agent 原型库
全插件化基础设施
开源部署
闭源,不支持私有部署
闭源,依赖官方云端
开源,Python 环境
MIT 开源,npm 或源码
扩展机制
功能硬编码,无法扩展
受限于官方 API 定义
需继承扩展类,耦合较高
配置层自由重组插件
可观测性
纯文本日志,无事件流
云端控制台日志
Print 输出,无溯源
Trajectory 追加日志,可分叉回放
运行模式
单一命令行模式
标准云端环境
硬编码脚本模式
4 种预设模式
启动方式
CLI 工具包安装
API Key + 控制台配置
git clone 搭环境
npx 一行命令启动

从表里能看到,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 编排、代码助手、模型评测