docs(architecture): add startup/register/runtime/shutdown flow docs and architecture overview

This commit is contained in:
2026-04-28 21:09:33 +08:00
parent e66ed9e9c0
commit 9ea475432f
6 changed files with 482 additions and 0 deletions

View File

@@ -0,0 +1,55 @@
# Agent 启动流程
本文说明 `Agent.newAgent(appClass).launch()` 的外层启动顺序。
`Agent.launch()` 负责拉起基础单例、注册配置参与者、注册 Gateway、安装关闭钩子、添加外部模块目录并启动注册工厂。组件扫描、模块实例化和能力注册的细节见 [注册链](register-chain.md)。
```mermaid
flowchart TD
A["Agent.newAgent(appClass).launch()"] --> B["加载基础单例<br/>ConfigCenter / StateCenter"]
B --> C["注册 ExceptionReporter"]
C --> D
subgraph D["注册 Configurable"]
direction TB
D1["LogAdviceProvider.register()"]
D2["ModelRuntimeRegistry.register()"]
D3["AgentGatewayRegistry.register()"]
D4["应用传入的 Configurable.register()"]
end
D --> E["注册 AgentGatewayRegistration"]
E --> F
subgraph F["注册关闭钩子"]
direction TB
F1["preShutdown<br/>AgentGatewayRegistry.close()"]
F2["preShutdown hooks"]
F3["postShutdown<br/>StateCenter.save()"]
F4["postShutdown<br/>TraceSinkRegistry.close()"]
F5["postShutdown<br/>ConfigCenter.close()"]
F6["postShutdown hooks"]
F1 --> F2
F3 --> F4 --> F5 --> F6
end
F --> G["添加外部模块扫描目录<br/>resources/module"]
G --> H["启动注册工厂<br/>AgentRegisterFactory.launch(application package)"]
H --> I
subgraph I["初始化配置系统"]
direction TB
I1["ConfigCenter.initAll()<br/>初始化已注册的 Configurable"]
I2["触发各 Configurable.init(config, json)"]
I3["ConfigCenter.start()<br/>启动配置监听"]
I1 --> I2 --> I3
end
I --> K["Agent 启动完成"]
```
Gateway 的实际 `launch()` 不在 `AgentGatewayRegistration.register()` 中直接发生。Gateway registration 只把可用通道注册到 `AgentGatewayRegistry`;真正的通道创建、启动和默认响应通道设置发生在 `ConfigCenter.initAll()` 阶段,由 `AgentGatewayRegistry.init()` 根据 `gateway.json` 执行。