本篇简单记录 Extension 的接口、运行上下文和生命周期。
Extension 接口
1 2 3 4 5 6
| export interface Extension { id: string; setup(context: ExtensionSetupContext): Awaitable<void>; start?(context: ExtensionRuntimeContext): Awaitable<void>; stop?(context: ExtensionRuntimeContext): Awaitable<void>; }
|
id:Extension 的唯一标识。
setup:注册能力和事件监听,必须实现。
start:获取其他能力并开始运行,可选。
stop:释放资源,可选。
两个 Context
setup 和运行阶段使用不同的 Context:
1 2 3 4 5 6 7 8 9 10 11
| export interface ExtensionSetupContext { add<T>(name: string, value: T): void; on<T>(event: string, handler: EventHandler<T>): Unsubscribe; }
export interface ExtensionRuntimeContext { get<T>(name: string): T; all<T>(name: string): T[]; on<T>(event: string, handler: EventHandler<T>): Unsubscribe; emit<T>(event: string, payload: T): Promise<unknown[]>; }
|
Setup Context 用来注册能力和监听事件。Runtime Context 用来获取能力、监听事件和发布事实。
生命周期
Kernel 按以下顺序运行 Extension:
1 2 3 4 5 6 7
| 按安装顺序 setup ↓ 按安装顺序 start ↓ 运行 ↓ 按安装顺序倒序 stop
|
暂定设计为所有 setup 完成后才执行 start,避免 Extension 在能力尚未注册完成时提前使用。启动失败时,Kernel 也会倒序停止已经启动的 Extension。
到这里,P0 的基础设计已经介绍完成。下一篇开始进入 Agent 核心基座的具体实现。