Hermes Agent 源码解析 · 第 12 讲
Hermes Agent 源码解析 第 12 讲：CLI 交互架构与 Session 持久化——REPL、TUI、SQLite 状态库与跨进程会话管理 基于 Hermes Agent v0.16.0 源码 · 2026-06-25 一、从命令行到智能代理：Hermes 的交互面 前十一讲我们覆盖了 Hermes 从核心架构到 ACP 协议的全链路。这一讲我们深入到 Hermes 的 CLI 交互层 与 Session 持久化系统 ——这两个模块是所有用户与 Hermes 打交道的"第一公里"。 当你在终端输入 hermes 时，背后发生了什么？Hermes 如何管理数十个活跃会话？Session 数据如何跨进程共享？压缩后的会话如何保持可追溯？这一讲逐一拆解。 📦 本讲核心文件 hermes_cli/main.py （12227 行）— CLI 入口与命令分发 hermes_state.py （4777 行）— SQLite 状态库与 SessionDB run_agent.py （5405 行）— AIAgent 运行器 hermes_cli/active_sessions.py （320 行）— 跨进程活跃会话租约 hermes_cli/session_recap.py （316 行）— 会话摘要生成 hermes_cli/curses_ui.py （872 行）— TUI 交互组件 hermes_cli/_parser.py （411 行）— 参数解析 hermes_cli/profiles.py （1776 行）— Profile 管理 二、CLI 启动管线：从 hermes 到 Agent 就绪 Hermes 的 CLI 启动管线是一个精心编排的 12 步流程，每一步都有明确的职责和故障降级策略。 启动管线阶段分解 阶段 文件/函数 职责 1. Bootstrap hermes_bootstrap.py Windows UTF-8 stdio 初始化 2. 进程标题 _set_process_title() ps/top 显示 "hermes" 而非 "python" 3. 接口检测 _wants_tui_early() CLI REPL vs TUI 决策 4. Profile 覆盖 _apply_profile_override() -p/--profile 解析，HERMES_HOME 设置 5. 环境加载 load_hermes_dotenv() .env 文件加载，密钥注入 6. 日志初始化 setup_logging() agent.log + errors.log 双日志 7. 技能同步 _sync_bundled_skills() 内置技能同步到用户目录 8. 参数解析 argparse + 子命令 30+ 子命令注册与分发 9. 容器路由 _exec_in_container() Docker/Podman 容器内执行 10. Session 恢复 _resolve_session_by_name_or_id() --resume 解析压缩链 11. Agent 创建 AIAgent.__init__() 回调注册、会话绑定 12. 交互循环 run_conversation() REPL / TUI 事件循环 其中最有意思的是 Profile 覆盖 阶段（ main.py:336 ）。Hermes 在 argparse 解析之前就拦截了 --profile/-p 标志——这是因为大量模块在导入时就缓存了 HERMES_HOME ，如果等 argparse 完成才设置环境变量，所有模块级常量都已经指向了错误的路径。 Profile 解析还处理了 mcp add --args 的命令参数透传区域——在 --args 之后的标志属于子命令（如 Docker MCP Toolkit 的 --profile ），而非 Hermes 自身的 Profile 选择器。 三、双交互面：CLI REPL 与 TUI 的架构差异 Hermes 提供两种交互界面，用户可通过 --cli 、 --tui 或 config.yaml 的 display.interface 切换。 CLI REPL vs TUI 对比 特性 CLI…