DeepSeek Harness 是深度求索(DeepSeek)推出的生产级 AI 智能体(Agent)底层工程执行基础设施。
官方站点:https://deepseek.com/harness/
开源仓库:https://github.com/deepseek-ai/deepseek-harness
核心理念:Agent = Model + Harness
DeepSeek 团队提出了标志性的工程公式:
$$\text{Agent} = \text{Model} + \text{Harness}$$
- Model(模型): Agent 的灵魂,提供基础推理与上下文理解。
- Harness(脚手架): 给予 Agent 理解环境、使用工具并在真实场景中持续工作的能力。
核心架构:“一切皆插件”
DeepSeek Harness 基于 Cordis 插件系统 构建:
- Cordis 内核:只负责插件的加载、卸载和依赖关系,不承载 Agent 的具体能力。
- 能力皆插件:模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件提供,并通过 Cordis 服务与事件彼此协作。
- 配置层自由组合:开发者无需改动 DeepSeek Harness 源码,即可在配置层选择、替换或扩展任一能力。
mermaid
graph TD
subgraph CordisKernel["Cordis 内核 (插件与依赖管理)"]
Kernel[Cordis Core]
end
subgraph Plugins["插件提供各项 Agent 能力"]
ModelPlugin[模型插件]
ToolPlugin[工具与技能插件]
SessionPlugin[会话与日志插件]
SandboxPlugin[沙箱插件]
UIPlugin[UI与调度插件]
end
CordisKernel ---> Plugins
Plugins ===> Agent[DeepSeek Harness Agent]
每一次运行都有迹可循 (Trajectory Tracking)
模型看到的一切都会写入仅追加(Append-Only)设计的会话日志,包括系统提示词、思维链、工具调用与结果、子 Agent 调度,以及每一次上下文注入。
在 Trajectory 视图中,你可以按来源清晰拆解查看这些信息。恢复、分叉、检索与回放均共享同一份事件流,保障高度的透明度与可审计性。
四种预设运行模式 (Presets)
- 标准模式 (Standard Mode):功能完整的编码 Agent,支持文件编辑、Shell、检索、Skills 与工作流。
- PTC 模式 (Programmatic Tool Calling Mode):基于 Code Mode SDK 呈现工具,让模型用 TypeScript 程序组合多步工具调用。
- 极简模式 (Minimal Mode):仅保留
bash与str_replace_editor的双工具编码 Agent,用于模型基准测试。 - 创造模式 (Creative Mode):在内存中试验 Cordis 插件,自由探索与组合自定义 Preset。
快速体验与开源说明
- 一键启动 Web UI:
npx @deepseek-ai/dsh web - 源码克隆:
git clone https://github.com/deepseek-ai/deepseek-harness - 开发者文档:https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
- 开源协议:MIT License,版权属于 杭州深度求索人工智能基础技术研究有限公司。
