【Agent进阶专题】架构设计

系统架构只有两个核心概念:

1
Kernel + Extensions

Kernel 管”Extension 怎样连接和运行”,Extension 管”系统具体能做什么”。

架构优先级

这是个人、本地优先的 Agent 项目。优先级很明确:

1
简单易懂 > 容易修改 > 容易扩展 > 通用性

不提前建复杂分层、插件平台或通用框架。真实能力先跑起来,边界出现后再拆。

Kernel:只保留运行机制

Kernel 只做四件事:

  • 按顺序装入 Extension,依次执行 setup → start,停止时倒序 stop
  • 通过命名抓手注册和获取能力(add / get / all)
  • 通过命名事件发布和监听事实(on / emit)

Kernel 不认识 Workspace、Conversation、Run、Agent、模型或 Tool。业务概念不能因为多处使用就被塞进 Kernel。

能力抓手让 Extension 直接协作。Extension 可以通过抓手获取到别的 Extension 的能力,控制流走明确调用,不绕事件总线。

事件只表示已发生的事实,适合日志和派生处理等场景。不承担调用顺序、返回值、审批或回滚。

Extension:具体能力

每个 Extension 可以提供能力、调用其他公开能力、发布事件,管理自己的数据和资源。Extension 之间只依赖公开契约,不引用彼此实现。

Tool、页面、命令和事件监听器只是 Extension 内部组成,不升级为架构层。新增能力默认写进现有 Extension;需要独立启停、独立长期资源、可替换实现或明确产品边界时,才创建新 Extension。

产品:Extension 组合

Runtime 内只有一套 Kernel、Extension 实例和本地数据。CLI、Web、Desktop 不各自实现 Agent,而是选择不同的 Extension 组合:

1
共享 Extensions + 产品 Extensions → Runtime

产品定义只负责列出要启用的 Extension,不含业务逻辑。三个入口共享同一套 Workspace、Conversation、Agent 和数据状态,各自保留不同的交互方式。

最后

这套架构的目标不是覆盖所有未来可能,而是让当前代码容易理解和修改。下一篇展开具体的目录布局和数据存放规则。