# DeepSeek Harness：官方开源的 Agent 框架，一切皆插件

---

**DeepSeek Harness**（`dsh`）是 DeepSeek 官方开源的 Agent 框架。它的架构宣言只有一句：**Everything is a plugin**——一切皆插件。

模型适配器、工具注册表、会话日志、Agent 主循环……全部是插件。没有不可替换的核心。你通过挂载新插件来扩展整个产品。

---

## 一、架构根基：Cordis

Harness 跑在 DeepSeek 自己的 **Cordis** 框架上。Cordis 的设计写在一篇论文里：《A Programming Paradigm for Spatiotemporal Composability》（时空可组合性的编程范式）。

它的核心机制：

- **服务**：插件向共享 context 注册服务
- **类型化事件**：扩展点以事件形式暴露，监听者以瀑布或串行方式处理
- **可逆效果**：插件注册的能力在插件卸载时自动撤销——挂上去的东西能干净地拆下来

模型适配器是一个插件，会话日志是一个插件，Agent 主循环本身也是一个插件。**任何一部分都能从配置层替换掉。**

---

## 二、Profile 和 Bundle：组合出来的产品

一个运行中的 `dsh` 是一棵插件树，在启动时由有序的层组合而成：

```text
Profile（命名组合）
  ├── Bundle A（dsh-base：模型、工具、持久化、沙箱、审批策略）
  ├── Bundle B（dsh-web-app：浏览器 UI）
  └── cordis.patch.yml（你的覆盖层）
```

**Profile** 定义你启动什么，**Bundle** 是分发格式，**patch** 是对任意配置行的覆盖。想看看自己机器实际启动的配置树：

```bash
dsh --profile web --dump-config
```

打印出的每一行都可以被你的 patch 替换。这个设计的实际效果：改模型接入、改沙箱策略、改 Agent 行为——都在配置文件层面完成，无需 fork 代码。

---

## 三、Session Log：日志是唯一真相

Harness 的会话日志是 append-only 的事件流。模型看到的上下文全部从日志推导：

```text
Model-visible means logged.
（模型能看到的内容必须能从日志重建）
```

这条不变式是运行时断言——任何到达模型请求的内容都必须能在日志里重建，否则直接报错。由此带来三个结果：

- **fork / resume / 转录 / 遥测 / 持久化**——全部从同一条事件流派生
- 会话可以被完整回放，UI 保真度来自原始 `assistant/chunk` 事件
- 想给模型加新的可见输入？必须定义新的会话事件类型，从日志渲染

可审计性在 Harness 里是设计出来的，不靠事后补日志。

---

## 四、Capability Seams：换一个 Provider，换掉整个产品

Harness 把可替换能力组织成 **seam**（接缝），每个 seam 有三层角色：

| 角色 | 职责 |
|------|------|
| **Service Definition** | 声明接口 |
| **Service Provider** | 实现能力 |
| **Consumer** | 使用能力（通常是面向模型的工具） |

关键是：文件系统和子进程共享同一个执行世界。**把 seam 指向远程沙箱，Bash、PTY、LSP 全部跟着迁移**——不需要 fork 任何 provider 代码。

子 Agent 的 provider 也一样：从「新开一个子 Agent」到「把任务委派给另一个产品的会话」，都藏在同一个接口后面。

---

## 五、Turn Flow：透明的主循环

```text
turn/start
  → 认领输入 + 组装 prompt 和工具 schema
  → agent/pre-step（监听者可改写或拒绝）
  → step：模型请求 → llm/stream → 工具调用 → 结果
  → 工具欠模型一个请求 → 继续下一步
  → agent/turn-stopping（可被外部停止）
turn/end
```

一个 **step** 是一次模型请求加上它调用的工具；一个 **turn** 是零到多个 step。所有生命周期事件都是可监听的扩展点——你要拦截请求、拦截工具、停止 turn，都有明确的事件入口。

---

## 六、运行

```bash
npx @deepseek-ai/dsh web
```

默认启动 Web UI 在 `http://127.0.0.1:3080`。配置 DeepSeek API key、选择工作区，然后直接给 Agent 派活。

也支持 headless 模式和 Python SDK。

---

## 结语

Agent 框架的常见问题是：核心写死了，扩展只能打补丁。DeepSeek Harness 反着来——整个产品由插件组合而成，配置层就能替换任何部分。

目前处于开发者预览阶段，官方明确说会有破坏性变更。但架构思路值得关注：Cordis 的可逆效果、Session Log 的单一真相、seam 的整层替换，这是一套有完整设计哲学的 Agent 框架。


DeepSeek Harness（dsh）是 DeepSeek 官方开源的 Agent 框架。它的架构宣言只有一句：Everything is a plugin——一切皆插件。

DeepSeek Harness：官方开源的 Agent 框架，一切皆插件

软件研发

人工智能

开发工具

架构设计

DeepSeekHarness（dsh）是DeepSeek官方开源的Agent框架，核心理念为“一切皆插件”。基于Cordis框架，模型适配器、工具注册、会话日志及主循环均可通过配置替换，无需fork代码。采用Profile和Bundle组合配置树，会话日志作为唯一真相源，支持完整回放和审计。通过Capability Seams实现沙箱和子Agent的无缝迁移，配合透明TurnFlow事件流，提供高度可扩展的模块化架构，当前处于开发者预览阶段。

文件系统

代码解释

DeepSeek

Agent

快速部署LLM、AI绘画等应用,助你玩转AIGC！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DeepSeekHarness（dsh）是DeepSeek官方开源的Agent框架，核心理念为“一切皆插件”。基于Cordis框架，模型适配器、工具注册、会话日志及主循环均可通过配置替换，无需fork代码。采用Profile和Bundle组合配置树，会话日志作为唯一真相源，支持完整回放和审计。通过Capability ...

DeepSeek Harness：官方开源的 Agent 框架，一切皆插件-腾讯云开发者社区-腾讯云

DeepSeek Harness：官方开源的 Agent 框架，一切皆插件

DeepSeek Harness：官方开源的 Agent 框架，一切皆插件

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐