English 中文 العربية 日本語 Português

DeepSeek Harness: DeepSeek Harness 简介

最后更新：2026-08-31

DeepSeek Harness（DSH）是 DeepSeek 开源的 Agent 智能体框架，核心理念"一切皆插件"——从模型适配器到工具系统、从会话管理到沙箱机制，全部以插件形式注入共享上下文，实现极致的可扩展性。

💡 提示：DSH 的核心创新在于 Cordis 架构——插件不直接互相调用，而是向共享上下文贡献服务、类型化事件和可逆副作用。这种设计让插件完全解耦，新增功能无需修改已有代码。

📋 前置知识：零基础可学，了解基本命令行操作即可

1. 你将学到

2. 关于代码示例的输出

本课程的代码示例采用确定性/非确定性分离模式，这是 Agent 框架教程的行业最佳实践（参考 LangChain、CrewAI 等竞品做法）：

标记 含义 你的输出
输出： 确定性结果（安装、配置、计数等） 应与示例基本一致
交互流程： Agent 行为流程（LLM 调用、工具选择等） 实际文本会不同，但流程相似
验证方法： 练习题的检查方式 按描述步骤验证
💡 为什么不一样？ 传统编程 1 + 1 = 2（永远相同），Agent 编程 agent.chat("分析代码") = ???（每次不同）。这是 Agent 框架的本质特性，不是 Bug。

3. 一个 AI 工程团队的选型故事

(1) 痛点：Agent 框架碎片化

Alice 是一家 AI 初创公司的架构师。她的团队在 2026 年 Q2 面临 Agent 框架选型难题：

产品经理 Bob 加码施压：

"我们需要一个模型无关、插件可插拔、支持多种交互模式的 Agent 框架。三个月内必须上线。"

(2) DSH 的解法

经过评估，Alice 选择了 DeepSeek Harness：

TEXT 📖 仅展示 
Plugin system:      0 extensible → everything is plugin
Model support:      1 provider → DeepSeek + OpenAI-compatible
Interaction modes:  CLI only → Web UI + CLI + SDK + Headless
Runtime overhead:   high → minimal (Cordis lazy-loading)
Community:          GitHub 187.3k stars, MIT license

DSH 的"一切皆插件"让 Alice 团队能按需组装：

  1. 第 1 周：Web UI + DeepSeek API 跑通首个 Agent
  2. 第 3 周：接入 OpenAI 兼容端点，切换到 GPT-4o
  3. 第 6 周：自定义工具插件，接入公司内部 API
  4. 第 10 周：Python SDK 集成到生产管线

(3) 收益

使用 DSH 三个月后：

4. DeepSeek Harness 是什么？

DeepSeek Harness（DSH）是 DeepSeek 团队推出的开源 Agent 框架，GitHub 仓库获 187.3k stars，采用 MIT 许可证。它不是一个 Agent，而是一个运行 Agent 的框架——提供模型适配、工具编排、会话管理、沙箱执行等基础设施。

DeepSeek Harness 概览

(1) ▶ 示例 1

100% 
graph TB
    subgraph DSH[DeepSeek Harness]
        C[Cordis 内核<br/>插件引擎]
        M[模型适配器<br/>DeepSeek / OpenAI]
        T[工具系统<br/>file_edit / shell / search]
        S[沙箱引擎<br/>审批与隔离]
        L[会话日志<br/>append-only log]
    end
    C --> M
    C --> T
    C --> S
    C --> L
    U[用户] -->|Web UI / CLI / SDK| DSH
维度 DSH 传统 Agent 框架
设计哲学 一切皆插件 功能硬编码
模型绑定 模型无关 绑定特定 LLM
扩展方式 插件注入 修改源码或回调
交互模式 Web/CLI/SDK/Headless 通常仅 CLI
运行时 Cordis 懒加载 全量初始化

(2) Developer Preview 说明

DSH 当前处于 developer preview 阶段，这意味着：

BASH 
# 安装时会提示 developer preview
npx @deepseek-ai/dsh web
# ⚠️ DeepSeek Harness is in developer preview.
# APIs may change before stable release.

但 developer preview 不意味着不可用——核心功能（对话、工具、插件）已经稳定可用，社区也在快速迭代。

5. Cordis 内核：一切皆插件

Cordis 是 DSH 的核心框架，名称源自拉丁语"心"——它是整个系统的跳动中枢。

(1) 插件贡献模型

每个插件向 Cordis 共享上下文贡献三类内容：

TYPESCRIPT 
interface PluginContribution {
  services: Service[];        // 可被其他插件调用的功能
  events: EventType[];        // 类型化的事件流
  sideEffects: SideEffect[];  // 可逆的副作用操作
}

(2) ▶ 示例 2

100% 
graph LR
    P1[LLM 插件] -->|贡献 service| CTX[共享上下文]
    P2[工具插件] -->|贡献 service| CTX
    P3[沙箱插件] -->|贡献 event| CTX
    P4[日志插件] -->|订阅 event| CTX
    CTX -->|分发| P1
    CTX -->|分发| P2
    CTX -->|分发| P3
    CTX -->|分发| P4

这种设计确保：

Cordis 插件架构

(3) ▶ 示例 3

TYPESCRIPT 
import { definePlugin } from '@deepseek-ai/dsh';

export default definePlugin({
  name: 'hello-dsh',
  version: '1.0.0',
  contribute(ctx) {
    ctx.registerService('hello', {
      greet(name: string) {
        return `Hello, ${name}! Welcome to DSH.`;
      }
    });
    ctx.emit('hello.registered', { timestamp: Date.now() });
  }
});

6. 四种运行模式概览

DSH 提供四种运行模式，适配不同的使用场景和偏好：

(1) 模式速览

模式 全称 特点 适用场景
标准 Standard 默认模式，Agent 自主决定何时使用工具 通用编程、问答
PTC Plan-then-Code 先规划再执行，计划可见可控 复杂任务、代码重构
极简 Minimal 最少工具调用，Agent 主要靠自身能力 简单问答、知识查询
创造 Creative 自由度最高，鼓励探索性输出 创意写作、头脑风暴

(2) 模式切换

BASH 
# CLI 模式切换
dsh --mode standard
dsh --mode ptc
dsh --mode minimal
dsh --mode creative

在 Web UI 中，模式可通过界面顶部下拉菜单实时切换。

100% 
graph LR
    USER[用户输入] --> MODE{运行模式}
    MODE -->|standard| S[Agent 自主决策]
    MODE -->|ptc| P[先 Plan 后 Code]
    MODE -->|minimal| M[最少工具调用]
    MODE -->|creative| C[探索性输出]
    S --> TOOLS[工具系统]
    P --> TOOLS
    M --> TOOLS
    C --> TOOLS

四种运行模式

详细模式对比与配置见 04-modes.md。

7. 与其他 Agent 框架对比

(1) 核心维度对比

维度 DeepSeek Harness Claude Code Cursor OpenCode
开源 ✅ MIT ❌ 闭源 ❌ 闭源 ✅ MIT
模型无关 ✅ 多模型适配 ❌ 仅 Claude ❌ 多模型 ✅ 多模型
插件系统 ✅ Cordis ❌ 无 ⚠️ 有限 ❌ 无
Web UI ✅ 内置 ❌ 仅 CLI ✅ IDE 内 ❌ 仅 CLI
SDK ✅ Python ❌ ❌ ❌
Headless ✅ ❌ ❌ ❌
沙箱 ✅ 可配置 ⚠️ 内置 ❌ ❌
GitHub Stars 187.3k — — —

(2) DSH 的差异化优势

  1. 模型自由：不绑定任何 LLM 供应商，DeepSeek API 和 OpenAI 兼容端点即插即用
  2. 插件生态：Cordis 架构让功能扩展变成"写插件"而非"改源码"
  3. 多端交互：Web UI 适合初学者，CLI 适合开发者，SDK 适合集成，Headless 适合自动化
  4. 可逆副作用：操作可回滚，这在 Agent 框架中极为罕见

(3) DSH 不适合的场景

8. 技术栈全景

DSH 的完整技术栈：

100% 
graph TB
    subgraph 交互层
        WEB[Web UI<br/>React + Vite]
        CLI[CLI<br/>终端交互]
        SDK[Python SDK<br/>程序化调用]
        HEAD[Headless<br/>无人值守运行]
    end
    subgraph 核心层
        CORDIS[Cordis<br/>插件引擎]
        SESSION[Session Manager<br/>会话管理]
        TRAJ[Trajectory<br/>日志引擎]
    end
    subgraph 插件层
        LLM[LLM 适配器<br/>DeepSeek / OpenAI]
        TOOLS[工具插件<br/>file_edit / shell / search]
        SANDBOX[沙箱插件<br/>审批与隔离]
        PROFILE[Profile 插件<br/>配置组合]
    end
    WEB --> CORDIS
    CLI --> CORDIS
    SDK --> CORDIS
    HEAD --> CORDIS
    CORDIS --> SESSION
    CORDIS --> TRAJ
    CORDIS --> LLM
    CORDIS --> TOOLS
    CORDIS --> SANDBOX
    CORDIS --> PROFILE

❓ 常见问题

Q DSH 是免费的吗？
A 是的，DSH 本身完全免费且开源（MIT 协议）。但使用 DeepSeek API 或其他 LLM API 需要相应的 API Key 和费用。
Q developer preview 意味着不能用于实际项目吗？
A 不是。核心功能（对话、工具、插件）已稳定可用，但 API 可能在后续版本中变更。建议在非关键项目上先验证，等稳定版发布后再用于生产。
Q DSH 和 AutoGPT 有什么区别？
A DSH 是 Agent 运行框架（Harness），不是 Agent 本身。AutoGPT 是一个特定的 Agent 实现。DSH 更底层、更灵活，你可以用 DSH 框架构建类似 AutoGPT 的 Agent。
Q 必须用 DeepSeek 模型吗？
A 不需要。DSH 是模型无关的。你可以通过 OpenAI 兼容端点接入 GPT-4o、Claude、Gemini 等任何兼容 API 的模型。
Q Cordis 是 DSH 独有的吗？
A Cordis 是 DSH 团队开发的通用插件框架，理论上可以用于其他项目。但当前它随 DSH 一起发布，尚未独立开源。
Q DSH 需要什么硬件？
A DSH 本身对硬件要求极低（Node.js 运行时即可）。Agent 的推理能力取决于你选择的 LLM API。如果使用本地模型，则需要相应的 GPU 资源。

📖 小节

📝 作业

1. ⭐ 基础题：访问 DSH 的 GitHub 仓库，阅读 README，列出三个最吸引你的特性，并说明原因。

2. ⭐⭐ 进阶题：用表格对比 DSH 与你最熟悉的另一个 Agent 工具（如 Claude Code、Cursor），至少包含 6 个对比维度。

3. ⭐⭐⭐ 挑战题：画一张 Mermaid 架构图，展示你理解的 Cordis 插件贡献模型——包含至少 3 个插件，标注它们贡献的服务、事件和副作用。

Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站，几个人的小团队，精力有限。页面虽经检查，难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了，麻烦告诉我们，我们会在收到反馈后第一时间进行修复，再次感谢您的光临 🙏