入口与启动流程

源码版本v2026.7.20

职责

把「一条 hermes 命令 / 一个网关消息」变成「内存里跑起来的 agent」。入口层刻意做得很薄——run_agent.py 只负责转发和 CLI 装配,真正的依赖注入在 agent_init.py。这样网关、TUI、CLI、ACP、cron 能共用同一套初始化路径。

关键文件

• gateway main:22965 — 网关进程入口 main()
• AIAgent 类:400-497 — 瘦入口类,__init__ 仅存参
• AIAgent.__init__ 转发:497-560 — 注释明确写 "Forwarder — see agent.agent_init.init_agent"
• run_conversation 方法:6350 — AIAgent.run_conversation 实例方法,调用 模块级 run_conversation:588
• CLI main:6434 — CLI 入口
• init_agent:276-400 — 依赖注入主函数
• _resolve_compression_threshold:93-127 — 启动期配置解析示例
• hermes_bootstrap.py — 最早期的环境/路径引导(仓库根)

数据流

1. 用户执行 hermes(CLI)或网关 main() 启动(run_agent.py:22965)。
2. 进程经 hermes_bootstrap.py 做路径/环境修正,进入 CLI main:6434 或网关循环。
3. 构造 AIAgent:400 实例,其 __init__ 转发到 init_agent:276。
4. init_agent 解析 provider、toolsets、压缩阈值、自定义 provider extra_body 等,装配出可运行的 agent 对象。
5. 网关在 gateway/run.py 的 GatewayRunner 里持有该 agent,把每条入站消息喂给 run_conversation:588。

小结

入口层是「转发 + 装配」,不持业务逻辑。AIAgent 是瘦壳,init_agent 才是装配中心。理解这条链路后,后面的Agent 主循环就是「被喂消息后做什么」。