DeepSeek Harness 介绍 - 一切皆插件的开源 Agent Harness

「一切皆插件」——模型、工具、技能、会话、沙箱、存储、循环、调度、UI，所有 Agent 能力均由插件组合而成。

项目简介 What is dsh

DeepSeek Harness（dsh）是 DeepSeek AI 开发的开源 agent harness（智能体框架），目前处于开发者预览版（v0.1）阶段，并以 MIT 协议开放源代码。

它的定位非常明确：为构建与探索智能体提供一个可自由组合的开放基础设施。DeepSeek Harness 采取「一切皆插件」的设计思路，采用插件式开放架构来构建 Agent Harness——模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件组合而成，可自由替换、灵活重组。

作为早期预览版本，当前仍有许多细节有待改进和打磨，核心插件与基础接口也将在后续快速迭代演进。

设计思路 Design

一切皆插件

DeepSeek Harness 基于具有时空可组合性的 Cordis 插件系统构建。Cordis 元框架只负责插件的加载与卸载以及依赖关系，Agent Harness 的所有具体组件都是不同的 Cordis 插件。插件通过 Cordis 服务与事件彼此协作，并可以在配置层自由组合。

开发者无需改动 DeepSeek Harness 的源码本身，就能以插件的方式独立选择、替换或扩展其中的任一能力。这就是 DeepSeek Harness 最重要的设计原则：一切皆插件。

不存在需要打补丁的特权内核：扩展 dsh 的方式是把插件挂载到其他插件旁边，而各项注册都是副作用，会在其插件卸载时撤销。

多种运行模式

针对不同的使用场景，DeepSeek Harness 提供四种模式，每种模式会默认加载不同的插件集合：

模式	说明
标准模式	提供完整的工具组合，开箱即用
PTC 模式	程序化工具调用（Programmatic Tool Calling），由模型生成的一段代码来组合多轮工具调用
极简模式	仅保留一个 shell 工具与一个文件编辑工具，用于最小环境下的模型基准测试
创造模式	可以检查当前运行时、在内存中试验 Cordis 插件，并据此组合和创作新的模式

每一次运行都有迹可循

模型看到的一切，都会写入仅追加（append-only）设计的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度，以及每一次上下文注入。

在 Trajectory 视图中，你可以按来源查看这些信息。恢复、分叉、检索与回放也都共享同一份事件流。

技术架构 Architecture

DeepSeek Harness 的架构哲学可以用一句话概括：产品由一棵插件树组成，每一部分都可以从配置替换。

运行中的 dsh = 一棵插件树（启动时按序叠加的各层组合而成）
        │
        ├─ profile（具名组装）：列出组合包、存放树外插件、保存 cordis.patch.yml
        ├─ 组合包（bundle）：Cordis 配置项及其挂载代码的分发格式
        └─ 各层按序应用：profile 组合包 → profile patch → home patch → --patch overlay

核心包（向 Cordis 树贡献内容的部分）：

包	职责
`core/session`	仅追加的 `SessionEvent` 日志和内存存储
`core/system-prompt`	提示词片段与工具 schema 的组装
`core/tools`	作用域化的工具注册表和带把关的执行流水线
`core/agent` / `core/agent-loop`	`Agent` 接口与实现该接口的默认驱动器
`llm/llm`	消息与流式词汇表，以及适配器 seam

一个 seam 是一项可替换能力，包含三种角色：声明接口的 Service Definition、实现它的 Service Provider，以及使用它的 Consumer。seam 正是替换一个提供方就能改变整个产品的原因。

开源协议 License

DeepSeek Harness 使用 MIT License，完全开源，可自由使用、修改与商用。源码在 github.com/deepseek-ai/deepseek-harness，第三方依赖及其许可证见仓库中的 THIRD_PARTY_NOTICES.md。

快速体验 Try it now

快速体验：在已安装 Node.js 的系统中运行 npx @deepseek-ai/dsh web，即可启动 Web UI（默认 http://127.0.0.1:3080）。
源码安装：git clone https://github.com/deepseek-ai/deepseek-harness 后按仓库说明完成安装。
完整安装方式见安装下载，系统上手见快速上手专区。
想看看它和 Claude Code / Codex / OpenCode 的对比？见对比页。

一句话总结

DeepSeek Harness = 一切皆插件 + Cordis 组合能力 + 四种运行模式 + 可追踪会话，开源（MIT）、可复用、可组合的 Agent Harness。