Partner/doc/architecture/startup.md

Agent 启动流程

本文说明 Agent.newAgent(appClass).launch() 的外层启动顺序。

Agent.launch() 负责拉起基础单例、注册配置参与者、注册 Gateway、安装关闭钩子、添加外部模块目录，并启动注册工厂。组件扫描、模块实例化和能力注册的细节见 注册链。

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 执行。