Hermes源码拆解02: 一张图看懂原理

读 Hermes-Agent 这种几十万行的代码，千万别一头扎进细节。先摸清四层架构和数据流向，才不会迷路。

四层分工：接入层负责接收输入。核心层像大脑做决策。执行层负责调用工具。存储层管持久化。依赖只能从上往下走。

找对五个入口：终端入口在 cli.py。总门面是 run_agent.py。循环引擎在 conversation_loop.py。工具注册表在 tools/registry.py。历史检索看 hermes_state.py。

注册表不碰上层：工具自己往注册表里登记。Agent 启动时直接拉取列表。这样彻底避开了循环导入的坑。

门面和循环解耦：AIAgent 只管长效配置。单次任务的瞬时状态交给独立函数。这样多线程同时跑任务也不会打架。

消息怎么存：用户发来的消息会经过五步流转。最后用 SQLite 存起来。开 WAL 模式能扛高并发读写。配合 FTS5 能毫秒级搜历史。

先建骨架再读代码，比逐行死磕管用得多。