源码级 插件体系

DeepSeek Harness 源码解析与插件深入开发

「Everything is a Plugin」——DeepSeek 官方出品的 Agent 基座,把插件化做到极致。学透它,就拿到了现代智能体基座的设计图纸。

为什么学这一模块

DeepSeek Harness(dsh)代表了插件化架构的极端:不只工具是插件,一切功能皆是插件,底层由 Cordis(时空可组合编程范式,有论文背书)驱动。对比模块 02 的中间件架构、模块 04 的原语扩展,三种扩展范式在此交汇——这是架构视野的关键一课。

核心技术栈

DeepSeek Harness(dsh) Everything-is-a-Plugin Cordis 内核 pnpm monorepo TypeScript / tsdown dsh web UI dsh-plugin 生态 Vitest / e2e 测试 Python 侧扩展 AGENTS.md 开发指引

技术亮点

一切皆插件的极致架构
功能即插件:核心能力与第三方扩展走同一套机制,没有特权代码——深度开发者与大厂官方站在同一地平线上
Cordis 时空可组合范式
底层由 Cordis 驱动,设计思想来自论文《A Programming Paradigm for Spatiotemporal Composability》——插件的注册、依赖、生命周期与上下文管理有一套完整理论
三种扩展范式对比收官
DeepAgents 中间件(模块 02)× Pi 原语扩展(模块 04)× dsh 全插件架构——横向对比后,给任何基座做深度开发都有章法

核心内容

dsh 快速上手:本地安装与 Web UI 全景
monorepo 源码导读:apps / packages / native / python 目录结构
Cordis 内核:插件上下文、服务模型、事件与依赖注入
插件开发生命周期:编写、注册、调试、测试、发布(dsh-plugin 生态约定)
自研插件实战 ×2:工具类插件 + 工作流类插件
定制实战:定制 UI 主题、替换模型路由、接入企业内部工具
开发流程工程化:pnpm run dev:web 热重建、Vitest 测试、AGENTS.md 驱动 AI 辅助开发
风险与治理:developer preview 阶段的兼容性管理策略

实战产出

  • 两个自研 dsh 插件(工具类 + 工作流类)
  • dsh 源码导读笔记(架构图 + 核心链路)
  • 企业定制版 DeepSeek Harness