一、系统整体三层架构官方 Architecture 图对照源码hermes-agent仓库整个系统自上而下就是三层┌─────────────────────────────────────────────────────────┐ │ ① 接入层 Entry Points入口 │ │ CLI (cli.py) │ Gateway (gateway/run.py) │ ACP │ │ Batch Runner │ API Server │ Python Library │ ├─────────────────────────────────────────────────────────┤ │ ② 核心层 AIAgentrun_agent.py决策与推理 │ │ Prompt Builder → Provider Resolution → Tool Dispatch │ │ Context Compression Caching3 种 API 模式 │ ├─────────────────────────────────────────────────────────┤ │ ③ 执行与存储层 │ │ Session StorageSQLite FTS5 全文检索 │ │ Tool Backends终端(7种) │ 浏览器(5种) │ Web(4种) │ MCP │ └─────────────────────────────────────────────────────────┘各层职责层职责关键点接入层接收所有来源的请求6 个入口最终都汇聚到同一个AIAgent类平台差异只存在于入口不进核心核心层决策与推理循环Prompt 组装stable→context→volatile 三层提示词→ Provider 解析18 供应商→ 工具分发70 工具→ 上下文压缩与缓存。同步编排可中断、可观测执行与存储层落地能力SQLite 会话持久化FTS5 全文搜索、父子会话谱系追踪 可插拔工具后端Local/Docker/SSH/Modal 等 7 种终端后端核心设计理念平台无关的核心Platform-agnostic core——AIAgent一个类服务所有入口这就是三层分层的灵魂。二、另一个流传的三层说法Agent → Gateway → Connector市面上有些教程会写成Agent 核心决策与推理Gateway消息路由与平台适配gateway/目录25 平台适配器Connector平台加密与身份边界gateway/platforms/下的信号、微信、QQBot、飞书等 adapter这其实和上面的官方三层是同一架构的不同切法它把接入层里的 Gateway 单独拎出来细讲了。在代码里对应gateway/run.py消息分发→gateway/session.py会话持久化→gateway/platforms/各平台加密与协议适配比如飞书网关就把异步重投、限流、加密、token 刷新全部收敛进平台无关的抽象里。三、容易被混淆的其他三层Hermes 文档里还有两种三层别搞混记忆三层解决跨会话遗忘的核心工作记忆当前会话上下文语义长期记忆MEMORY.md / USER.md事实与偏好有字符硬上限情节记忆SQLite FTS5全部历史对话可全文检索召回Prompt 三层系统提示词组装顺序stable身份/工具指南/技能→context上下文文件→volatile记忆/Profile/时间戳。这个分层是为了保持 prompt 缓存稳定stable 部分不随对话变化Anthropic 缓存断点命中率最高。小结如果你问的是对外 → 核心 → 执行这层宏观结构接入层CLI/Gateway/ACP/API→ Agent 核心层AIAgent 推理循环→ 执行与存储层工具后端 SQLite层层解耦、每层可独立扩展替换——这正是 Hermes 能任意部署 自我进化的架构基础。
