DeepSea Harness 架构解读

◈
插件化架构
功能皆插件

◈
生命周期
依赖井然有序

◈
热重组
替换无需全重启

架构拆解

ARCH

Core 核心

提供插件所需的运行环境，解决插件之间的依赖关系。没有它，所有插件都无法工作。

LLM 插件

接收提示词输入，调用大模型并返回结果，不关心结果存到哪里。

Session 插件

提供日志系统，负责读写数据，但不关心某段日志是否由大模型输出，与 LLM 无直接依赖。

Agent Loop

聊天控制器。在 LLM 与 Session 之间搬运信息，将用户请求写入 Session 并传给大模型，再把结果搬运回来。

System Prompt

字符串拼接器。负责把身份、指令等注入发送给大模型的上下文，让模型输出更稳定。

联网搜索插件

根据用户请求返回对应的搜索结果，让系统具备联网能力。

工具管理器

对所有工具进行注册、查找、校验和执行，将工具上下文注入 System Prompt，并为 Agent Loop 提供工具调用接口。

协同工作流程

FLOW

1

System Prompt 和工具字符串通过 Agent Loop 写入 Session 上下文文档。

↓

2

用户请求到达，同样写入上下文文档。

↓

3

整个上下文发送给 LLM 插件，返回思考过程和输出结果。

↓

4

工具管理器 查找并调用 联网搜索插件。

↓

5

Agent Loop 将搜索结果写入上下文并再次发给大模型。

↓

6

大模型返回整理后的最终内容。

💡 提示：Agent Loop 的本质就是 agent loop——驱动一次次模型调用和工具调用的循环。

插件加载机制

LOAD

不需要依赖的插件优先加载，先进入 loading 状态，内部加载完成后变为 active。

有前置依赖的插件（如工具管理器依赖 System Prompt），等所有前置依赖满足后再加载上线。

只要有一个前置插件未加载完成，当前插件就不会加载。

Agent Loop 是最后加载的，它依赖 LLM、Session、工具管理器等所有前置插件。

🔑 关键：核心是插件之间的信息传输和依赖关系，依赖决定了加载顺序。

热重组机制

HOT SWAP

01

想替换 LLM 插件时，先将旧 LLM 插件设为 unloading，并按加载时的逆序完成卸载（论文中称为「时间可组合性」）。

02

由于 Agent Loop 依赖 LLM，依赖不满足，Agent Loop 会完成附带副作用的撤销。

03

没有其它插件依赖 Agent Loop，旧插件被彻底关闭。

04

新 LLM 插件开始加载，Agent Loop 发现新 LLM 已上线，依赖重新满足，重新加载上线。

⚡ 整个过程中，6 个插件只有 2 个被关闭/重启，其余插件完全不受影响 —— 这就是热重组的价值。

开发避坑指南

PITFALLS

⚠

循环依赖：插件 A 依赖 B、B 也依赖 A，这两个插件将永远不会被加载。

⚠

必须配撤销方法：为了实现可组合性，每个插件都要有对应的撤销方法。

⚠

能复用就不造轮子：现有插件组合已能满足需求时，不必自己开发新插件，避免带来潜在依赖冲突。

“

DeepSea Harness 是一个接近去中心化的插件系统，但也不是完全没有核心——没有核心，所有插件都无法正确运行。

—— DeepSea Harness 核心设计理念

万物皆可插件

架构拆解

协同工作流程

插件加载机制

热重组机制

开发避坑指南