DeepSeek Harness(简称 DSH)是深度求索(DeepSeek)于 2026 年 8 月推出的开源命令行AI智能体框架,采用 MIT 许可证,旨在将大语言模型升级为具备项目管理、多Agent编排和长周期任务执行能力的自主智能体。其核心理念可用公式概括为:Model + Harness = Agent——模型负责思考,Harness("马具"即执行架)负责将思考转化为行动。
框架内置"一切皆插件"的 Cordis 插件系统,支持四种运行模式灵活切换,适用于编程自动化、任务托管与 Agent 框架二次开发等场景。
| 基础信息 | 内容 |
|---|---|
| 开发方 | DeepSeek(深度求索) |
| 发布时间 | 2026 年 8 月 13 日(v0.1 开发者预览版) |
| 项目立项 | 2026 年 5 月 |
| 许可证 | MIT(完全开源,商用零门槛) |
| 运行形态 | 命令行 CLI + Web 界面 |
| 插件系统 | Cordis(覆盖模型/工具/技能/会话/沙箱/存储/循环/调度/UI 九大组件) |
| 运行模式 | 标准模式 / PTC 程序化工具调用 / 极简模式 / 创造模式 |
| 核心能力 | 项目管理、长任务执行、多 Agent 编排、上下文管理、联网搜索、Skill 系统 |
| 产品定位 | 开源命令行 AI 智能体框架(Agent 执行层) |
| 适用人群 | 开发者、Agent 应用构建者、需要本地任务自动化的技术团队 |
核心能力与架构解析
DeepSeek 对 DSH 的定位十分清晰:模型只负责思考,Harness 负责把思考变成行动——管理项目、管理上下文、管理工具、管理沙箱。官方将其对标 Claude Code 和 OpenAI Codex,但选择了彻底开源(MIT)的路线,且明确标注为 v0.1 开发者预览版,不建议直接用于生产环境。
"一切皆插件"的 Cordis 系统
Cordis 是 DSH 的骨架,也是它区别于其他 CLI Agent 的最大差异化优势。模型、工具、技能(Skill)、会话、沙箱、存储、循环(Loop)、调度、UI 九大组件全部可插件化——更换底层模型、替换沙箱实现、增加存储后端,均无需改动框架本体。对于想做 Agent 平台二次开发的团队,这意味着极高的可定制自由度。
这套设计也解释了 DSH 敢于对标闭源 Claude Code 的底气:闭源产品的扩展边界由厂商决定,而 MIT 许可加全插件化架构,让社区可以将任何一个环节替换成自己的实现。
四种运行模式
模式即调度策略,开发者可按任务类型灵活切换:
标准模式:面向常规交互任务,兼顾通用性与稳定性
PTC 模式(程序化工具调用):让模型用代码而非逐个 JSON 调用工具,批量操作效率更高
极简模式:削减系统开销,适合脚本化嵌入和自动化流水线
创造模式:面向开放式生成任务,放宽工具调用约束,释放模型创造力
四套配置覆盖了从脚本嵌入到复杂工程的不同需求,开发者不必为所有场景共用一套折中方案。
面向真实工程的四大能力
项目管理:维护跨会话的项目状态,长任务可拆解、挂起、续跑
多 Agent 编排:将复杂任务分派给多个子 Agent 并行推进,提升执行效率
上下文管理:在长会话中压缩和检索历史信息,缓解"聊太久变笨"的问题
联网搜索与 Skill 系统:Agent 可自主补充信息,并将成功经验沉淀为可复用的技能
这些能力组合起来,指向的是"把一摊工作整体托管给 AI",而非传统的"问一句答一句"交互模式。
横向对比:DeepSeek Harness vs Claude Code vs Codex
| 对比维度 | DeepSeek Harness | Claude Code | Codex(OpenAI) |
|---|---|---|---|
| 开发方 | DeepSeek | Anthropic | OpenAI |
| 许可证 | MIT 完全开源 | 闭源 | 闭源 |
| 使用方式 | 本地 CLI/Web,自选模型 | 订阅制 CLI | 订阅制 + API |
| 插件化程度 | 九大组件全插件化(Cordis) | 官方扩展体系 | 官方环境配置 |
| 多 Agent 编排 | 内置支持 | 有限 | 有限 |
| 底层模型 | 可插拔(默认 DeepSeek 系列) | Claude 系 | GPT 系 |
| 成熟度 | v0.1 开发者预览 | 生产可用 | 生产可用 |
三条路线的取舍非常清晰:Claude Code 和 Codex 胜在产品打磨度和"模型-框架"一体化优化;DSH 的核心优势在于开放——MIT 许可、全插件化、模型可替换,适合希望深度定制 Agent 管线的技术团队。DSH 还可配合 DeepSeek-V4 及 GLM-5.3 等国产模型组合使用,构建自主可控的 Agent 系统。
应用场景与适用人群
编程与工程自动化
代码库级重构、跨文件修改、自动化测试修复——长任务拆解后托管给 Agent 执行,开发者只需审阅最终产出。
多 Agent 管线搭建
将调研、编码、评审等工作分派给不同子 Agent 并行推进,开发者聚焦于最终成果的验收与决策。
Agent 框架二次开发
基于 Cordis 插件系统替换模型、沙箱、存储等组件,搭建自有 Agent 平台或企业级工具链。
本地任务托管
定时运行数据整理、信息聚合、批量文件处理等脚本化工作流,实现轻量级自动化。
适合切换的用户:能接受命令行操作、希望深度定制 Agent 行为的开发者;想研究 Agent 架构实现思路、或基于开源框架构建内部工具的工程团队。
暂不适合的情况:追求开箱即用稳定体验的普通用户——v0.1 预览版仍在快速迭代,官方明确不建议用于生产环境。
使用指南
环境要求:Node.js 环境即可。
快速启动:
npx @deepseek-ai/dsh web
一条命令即可拉起 Web 界面。纯 CLI 用法参考 GitHub 仓库文档。
配置模型:默认接入 DeepSeek 系列模型,通过 Cordis 插件体系可替换为其他兼容模型(如开源 LLaMA 系列、Qwen 系列等)。
选择模式:
常规任务 → 标准模式
批量工具操作 → PTC 模式
脚本嵌入 → 极简模式
开放生成 → 创造模式
获取源码:GitHub 搜索 DeepSeek 组织下的 Harness 仓库,MIT 许可证,可自由 Fork 和商用。
官方资源
开源状态与已知局限
MIT 许可证——真正的商用零门槛
MIT 是业界最宽松的开源许可证之一,允许自由使用、修改、分发和商用,没有任何附加条件。对比部分采用"社区许可"(限制营收规模或地域)的所谓开源项目,DSH 在框架层面没有额外约束,企业接入无需复杂的法务审查成本。
需要正视的局限:
成熟度:v0.1 是开发者预览版,官方明确标注不建议用于生产环境,稳定性和文档完整度均处于早期阶段
社区驱动:功能打磨的优先级由社区和官方共同决定,遇到问题可能需要阅读源码排查
模型依赖:多 Agent 编排和 Skill 系统的实际效果高度依赖底层模型能力,模型不够强时编排收益有限
网络环境:国内网络环境下 npm 拉取和模型 API 访问需要自行配置代理或镜像
常见问题
DSH 怎么安装?
只需 Node.js 环境,终端执行 npx @deepseek-ai/dsh web 即可启动 Web 界面。也可从 GitHub 获取源码本地构建。整个框架 MIT 开源,无需付费或申请。
免费吗?可以商用吗?
框架本身免费且采用 MIT 许可证,商用、修改、分发均无限制。需要注意调用底层云端模型可能产生 API 费用——若接入本地部署的开源模型则完全免费。
和 Claude Code 怎么选?
需要开箱即用、模型-框架一体优化的成熟体验选 Claude Code;需要开源可控、九大组件全插件化、模型可任意替换选 DSH。DSH 当前为 v0.1 预览版,不建议生产使用,早期尝鲜和二次开发是它的主要适用场景。
能离线使用吗?
可以。框架在本地运行,只要接入的底层模型是本地部署的开源模型(如 DeepSeek 开源系列),整个 Agent 管线可完全离线工作;接入云端 API 则需要网络。
现在稳定吗?
尚不稳定。2026 年 8 月 13 日发布的 v0.1 为开发者预览版,官方明确不建议用于生产环境。适合开发者跟踪迭代、参与共建,或在其架构基础上做自己的封装。
