GitHub仓库首页

WebUI操作界面

插件开发示例

前言
现在 AI Agent 赛道百花齐放,但大多数 Agent 框架都存在一个痛点:耦合度太高。模型、工具调用、会话存储、调度逻辑全部绑定在一起,想要更换模型、新增工具、修改执行逻辑,往往要改动大量源码,二次开发成本居高不下。
近期 GitHub 火速出圈的 DeepSeek‑Harness(简称 dsh),由 DeepSeek 开源发布,上线短时间 Star 暴涨数万,成为 Agent 领域热度最高的开源项目。它提出核心公式:Agent = Model + Harness。大模型负责思考推理,Harness 负责给模型装上手脚,完成工具调用、任务调度、沙箱执行、会话管理整套工程流程。
它不是全新大模型,而是一套可自由组装的智能体运行底座,MIT 协议完全开源,打破传统 Agent 框架的固化架构,用 “一切皆插件” 的设计,让开发者可以像搭乐高一样拼装属于自己的 AI Agent抖音百科。
项目是什么
DeepSeek‑Harness 是面向开发者的开源 Agent Harness 运行时框架,底层基于自研 Cordis 插件内核。模型适配器、工具集、技能、会话、沙箱环境、存储、任务调度、前端 UI,全部封装成独立插件。开发者不需要修改项目源码,仅通过配置文件,就可以替换、新增、卸载任意能力模块DeepSeek。
简单理解:大模型是大脑,Harness 就是整套神经系统与执行躯体。大脑只负责输出想法,Harness 完成读文件、执行脚本、联网检索、多子 Agent 协作、日志追踪等现实世界操作,把大模型的想法落地为真实任务结果。
它提供命令行dsh工具,同时内置 Web 可视化界面,支持本地快速启动,也支持无头模式部署在服务器,适配本地开发、私有化部署、二次开发多种场景。
✨核心亮点
1. 一切皆插件,极致可组合
整个框架没有强耦合核心逻辑,全部能力都是插件。
- 可以换掉默认 DeepSeek 模型适配器,接入 OpenAI、讯飞、通义等任意大模型 API;
- 按需开启 / 关闭 Shell 执行、文件编辑、联网搜索、子 Agent 能力;
- UI 界面、存储引擎、权限策略都可以自定义插件替换;
- 仅修改配置文件,不用改动源码,快速组装不同定位 Agent,比如代码 Agent、RAG 助手、自动化工作流 Agent。
2. 完整可追溯,任务全程回放
采用追加式会话日志,模型看到的全部内容:提示词、思考过程、工具调用、返回结果、子 Agent 调度全部完整留存。
支持会话分叉、断点恢复、任务回放调试。哪怕做上下文压缩,原始历史记录不会丢失,排查 Agent 执行 bug 时非常友好,解决传统 Agent 黑盒难以调试的痛点抖音百科。
3. 多层安全权限管控
设计四层安全防护:工具可见性、权限策略、人工审批、沙箱隔离。可以区分只读、文件写入、高危操作,高危命令需要人工确认,所有操作日志完整审计,避免 AI 执行危险操作,兼顾自动化与安全可控。
4. 多运行模式开箱即用
内置 4 套预制 Profile 配置,开箱切换不同工作模式:
- 标准模式:全套能力,完整编程 Agent,文件编辑、shell、搜索、子代理全部开启;
- PTC 模式:程序化工具调用,代码编排多轮工具执行;
- 极简模式:仅保留基础文件、shell 工具,用于基准测试;
- 创造模式:用于开发调试自定义插件,快速试验新能力。
5. 不绑定模型,私有化友好
不强制绑定 DeepSeek 系列模型,兼容主流各家大模型 API。全部代码开源,支持内网私有化部署,企业做内部 AI 应用、定制 Agent 不用依赖外部闭源产品。
🛠快速上手示例
方式 1:npx 一行启动 Web 界面,无需下载代码
npx @deepseek‑ai/dsh web
执行完成访问本地 http://127.0.0.1:3080,直接打开 WebUI 界面,填入你的 API Key 即可使用。
方式 2:本地完整克隆源码
git clone https://github.com/deepseek‑ai/deepseek‑harness
cd deepseek‑harness
npm install
npm run web
命令行模式执行任务:
dsh --profile standard
📊横向对比
表格
| 方案 | 架构模式 | 模型绑定 | 二次开发成本 | 可追溯调试 | 私有化部署 |
|---|---|---|---|---|---|
| DeepSeek‑Harness | 插件化 Cordis 内核 | 不绑定 | 低,配置 + 插件扩展 | 完整事件日志 | ✅支持 |
| LangChain | 链式组件封装 | 无绑定 | 中等,需要写业务代码 | 日志能力有限 | ✅支持 |
| Claude Code | 整机闭源架构 | 绑定 Claude | 几乎不可修改 | 黑盒 | ❌不支持私有化 |
🎯适合哪些人
- AI Agent 开发者,想要搭建自定义智能体,不想被框架源码束缚;
- 需要做私有化部署的企业,希望自由切换不同大模型服务商;
- 研究 Agent 工具调用、多子代理协作的技术爱好者;
- 想开发 Agent 插件,拓展 AI 能力的开发者;
- 需要调试、回放 Agent 执行流程,排查工具调用异常的研发人员。
⚠️项目局限
- 当前为 v0.1 开发者预览版,接口、配置会频繁变动,不建议直接上生产环境;
- 面向开发者,有一定学习门槛,普通非技术用户上手难度较高;
- 插件生态刚刚起步,第三方社区插件数量还在增长;
- 本身不提供大模型,需要自行准备各家模型 API 密钥。
总结
Agent 赛道的竞争,早已不只是比拼大模型推理能力,Harness 执行层正在成为新的核心战场。DeepSeek‑Harness 最大价值,就是把整套 Agent 运行底座完整开源出来。
“一切皆插件” 的架构,给开发者极高自由度,你可以自由挑选大脑(大模型),自由拼装手脚(工具、沙箱、调度),打造完全贴合业务需求的智能体。如果你正在做 Agent 相关开发,这个新星开源项目值得重点跟进学习。
项目仓库地址:
https://github.com/deepseek‑ai/deepseek‑harness





暂无评论内容