Plugin System

一切皆插件

DeepSeek Harness (harness.vin) 的核心理念是「一切皆插件」。基于 Cordis 插件内核,模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有能力均由插件提供,支持自由替换和灵活重组,构建高度灵活的 AI Agent 架构。

插件类型

M

模型插件 (Model Plugin)

接入不同的大语言模型(LLM),如 DeepSeek、OpenAI 等。通过模型插件实现 Agent 的对话和推理能力,支持灵活切换底层模型。

T

工具插件 (Tool Plugin)

为 Agent 提供工具调用能力,包括文件操作、网络请求、代码执行等。工具插件定义了 Agent 可执行的动作和函数调用接口。

S

沙箱插件 (Sandbox Plugin)

提供安全隔离的代码执行环境,支持在沙箱中运行 Agent 生成的代码,防止对宿主系统造成影响。

R

轨迹插件 (Trajectory Plugin)

记录 Agent 运行的完整会话轨迹,包括每一步的输入、输出、工具调用和状态变化,支持回放和调试。

U

UI 插件 (UI Plugin)

提供用户界面组件,包括 Web 界面、聊天窗口、代码编辑器等。UI 插件定义了用户与 Agent 交互的方式。

C

存储插件 (Storage Plugin)

管理 Agent 的状态存储、会话历史、文件系统等持久化能力,支持多种存储后端。

Cordis 插件架构

Cordis 内核

DeepSeek Harness 基于 Cordis 插件系统构建。Cordis 提供插件加载、卸载、依赖管理和生命周期管理,是一切皆插件架构的基石。

配置层组合

通过配置文件选择所需的插件组合,无需改动源码即可创建不同类型的 Agent。同一套插件可以组合出多种运行模式。

依赖注入

插件之间通过依赖注入机制协作,一个插件可以声明对其他插件的依赖,Cordis 内核负责按正确顺序加载和初始化。

热插拔

支持运行时动态加载和卸载插件,实现 Agent 能力的实时扩展和调整,无需重启服务。

插件开发示例

插件是导出 apply 函数的 TypeScript 模块。通过 ctx 注册能力、声明 inject 依赖,即可为 AI Agent 扩展新能力。

// 创建自定义 DeepSeek Harness 插件
import type { Context } from '@deepseek-ai/cordis';

export const name = 'my-tool-plugin';

// 依赖的 tools 服务就绪后才会加载本插件
export const inject = ['tools'];

export function apply(ctx: Context) {
  ctx.tools.register({
    // 工具定义:名称、描述与调用方式
    // ...register your tool here
  });
}

插件的分发与发现

DeepSeek Harness 没有单独的插件市场服务:官方插件就是 npm 上的包,社区插件靠 GitHub 话题被发现。

官方插件:@deepseek-ai 作用域

全部官方插件以 @deepseek-ai/dsh-* 的形式发布到 npm,例如 dsh-tool-fs、dsh-session、dsh-sandbox。安装与升级走标准的 npm 流程。

在 npm 上浏览

社区插件:dsh-plugin 话题

社区插件通常是第三方 npm 包或本地插件目录。作者为自己的仓库加上 dsh-plugin 话题即可被生态发现,这也是官方推荐的收录方式。

浏览话题

官方文档与仓库

插件开发的完整说明、profile 配置与 API 参考以官方文档为准;本页只做概览与索引。

打开官方文档

官方插件库

官方插件以 @deepseek-ai/ 作用域下的 npm 包发布。下面是自动同步的能力分组概览,点击可查看完整插件目录(含版本与说明)。

查看完整插件库共 290 个官方插件包 · 快照 2026-09-12

相关文档

常见问题

DeepSeek Harness 的插件系统是什么?

基于 Cordis 插件内核,模型、工具、技能、会话、沙箱等所有能力均由插件提供,支持自由替换和灵活重组。

如何开发自定义插件?

插件是导出 apply 函数的 TypeScript 模块,通过 ctx 注册工具、服务与事件,并声明 inject 依赖,即可扩展工具、模型、沙箱等能力。

DSH 插件在哪里可以找到?

在 GitHub Topics dsh-plugin 页面查找社区插件,也可在 DeepSeek Harness GitHub 仓库查看官方插件。

插件支持热插拔吗?

是的,DeepSeek Harness 支持运行时动态加载和卸载插件,实现 Agent 能力的实时扩展。

官方插件和社区插件有什么区别?

官方插件由 DeepSeek 以 @deepseek-ai/dsh-* 的形式发布在 npm 上;社区插件由第三方维护,通常以 dsh- 前缀命名,并通过 GitHub 的 dsh-plugin 话题被收录和发现。

如何发布自己的插件?

把插件作为 npm 包发布,然后为 GitHub 仓库加上 dsh-plugin 话题,这样社区与官方文档都能发现它。

加入 DSH 插件生态

DeepSeek Harness 开发者预览版仍处于面向 Harness 开发者的测试阶段,核心插件和基础 API 将持续迭代。我们期待与全球开发者一起,在开源、开放、可复用、可组合的基础设施之上,共同探索智能上限。