Hermes Agent 源代码解析（一）：根目录探秘，看懂 AI 代理的「公司级」架构设计

目录Hermes Agent 源代码解析一根目录探秘看懂 AI 代理的「公司级」架构设计一、先搞懂Hermes Agent 到底是什么二、可视化总览Hermes Agent 公司架构图三、根目录全解析大白话讲清每个文件夹 行政部.github/ 对外合作部acp_adapter/ 总经理办公室核心agent/ 机房管理部environments/ 客服中心gateway/‍ 前台接待hermes_cli/ 外包团队plugins/️ 工具箱tools/ 工具套装toolsets/其他辅助目录快速了解四、实战演示AI 代理如何执行「创建文件」任务五、核心总结为什么 Hermes 的架构设计如此优秀六、下期预告互动话题前言在 AI Agent 爆发的今天Hermes Agent 凭借模块化、高扩展性、多平台适配的特性成为开发者最喜爱的开源 AI 代理框架之一。很多新手刚接触源码时会被复杂的目录结构劝退 —— 其实它的设计逻辑非常贴近现实世界的「公司组织架构」。本文用最通俗、最接地气的方式带你从零拆解 Hermes Agent 根目录彻底搞懂每个文件夹的职责轻松读懂 AI 代理的核心架构。一、先搞懂Hermes Agent 到底是什么在深入源码前先给它一个极简定义Hermes Agent 一个能自主思考、调用工具、对接平台、执行任务的 AI 机器人团队它可以帮你写代码、操作文件、控制终端、搜索信息、对接微信 / 钉钉 / Discord甚至在云端 / 本地 / 远程服务器无缝运行。而它的源码结构就是一个分工明确、各司其职的微型公司没有冗余设计每一个目录都有不可替代的作用。二、可视化总览Hermes Agent 公司架构图我们直接把根目录转化为「公司组织架构」一眼看懂整体逻辑┌─────────────────────────────────────────────────────────────────┐ │ Hermes Agent 总公司 │ ├─────────────────────────────────────────────────────────────────┤ │ 行政部 .github/ │ 后勤仓库 assets/ │ │ 对外合作部 acp_adapter/ │ ⏰ 闹钟部门 cron/ │ │ 总经理办公室 agent/ │ 集装箱部 docker/ │ │ 机房管理部 environments/ │ 客服中心 gateway/ │ │ ‍ 前台接待 hermes_cli/ │ Linux适配部 nix/ │ │ 外包团队 plugins/ │ 临时工团队 scripts/ │ │ 培训手册 skills/ │ ✅ 质检部门 tests/ │ │ ️ 工具箱 tools/ │ 工具套装 toolsets/ │ └─────────────────────────────────────────────────────────────────┘接下来我们逐个「部门」拆解告诉你每个目录做什么、为什么存在、实际工作场景。三、根目录全解析大白话讲清每个文件夹 行政部.github/核心职责管理项目流程保证代码规范、自动运行测试、自动发布版本。实际工作代码提交后自动执行测试CI 持续集成避免 bug 入库新版本发布时自动打包、部署CD 持续部署统一 Issue/PR 提交模板规范社区协作相当于公司行政把所有流程标准化不用人工干预适用场景开发者贡献代码、项目维护、版本迭代。 对外合作部acp_adapter/核心职责对接主流编辑器让 AI 代理嵌入开发者日常工作流。实际工作适配 VS Code、JetBrainsIDEA/PyCharm等编辑器让你写代码时直接在 IDE 里调用 Hermes 完成代码补全、调试、生成相当于商务拓展帮 AI 代理「打入」开发者生态适用场景IDE 内 AI 编程助手、实时代码协作。 总经理办公室核心agent/核心职责AI 代理的大脑所有决策、思考、逻辑调度的中心。这是 Hermes 最核心的目录没有之一它的内部结构如下agent/ ├── transports/ # 对接大模型的渠道Ollama/OpenAI/本地模型 ├── prompt_builder.py # 给大模型下发的「指令模板」 ├── memory_manager.py # 记忆管理存储对话历史 ├── context_compressor.py # 压缩上下文节省token └── error_classifier.py # 异常处理报错自动修复实际工作接收用户请求分析需求选择调用哪个大模型、哪个工具管理记忆记住之前的对话内容处理报错自动重试 / 修正适用场景所有 AI 代理的核心逻辑、自主决策、任务调度。 机房管理部environments/核心职责管理代码运行环境实现「一处编写到处运行」。支持 4 种环境本地环境直接在你的电脑运行速度最快Docker 环境隔离容器运行干净无污染Modal 云环境云端算力运行性能强SSH 环境远程服务器运行适合运维 / 服务器操作相当于公司 IT 部门保证 AI 代理在任何设备都能稳定运行。 客服中心gateway/核心职责对接全平台聊天工具让用户随时随地使用 AI 代理。支持平台全覆盖海外Telegram、Discord、WhatsApp、Slack国内微信、QQ、钉钉、飞书、企业微信实际工作把 AI 代理变成聊天机器人你在任何平台发消息它都能接收并回复。‍ 前台接待hermes_cli/核心职责用户与 AI 代理的第一交互入口命令行控制中心。实际工作解析你输入的hermes命令如hermes chat/hermes setup管理配置文件、展示帮助文档接收请求→转发给大脑→返回结果给你相当于公司前台所有用户请求都从这里进入。 外包团队plugins/核心职责可选增值功能按需开启不占用核心资源。常用插件memory增强记忆对接 Honcho/Mem0spotify控制音乐播放disk-cleanup磁盘清理google_meet视频会议自动化需要时开启不需要时关闭灵活扩展。️ 工具箱tools/核心职责AI 代理的「手脚」所有实际操作都靠它完成。这是 AI 代理能「干活」的基础常用工具一览工具文件核心功能现实类比terminal_tool.py执行终端命令螺丝刀file_tools.py读写 / 创建 / 删除文件记事本web_tools.py联网搜索 / 爬取信息望远镜browser_tool.py自动化控制浏览器机械手vision_tools.py图片识别 / 分析眼睛tts_tool.py文字转语音喇叭 工具套装toolsets/核心职责把工具打包成套餐一键启用不用单独配置。热门套餐research研究专用搜索 提取 图片分析development开发专用终端 文件操作safe安全模式禁止执行危险命令hermes-cli默认全能套餐相当于餐厅套餐直接选择使用场景无需手动搭配工具。其他辅助目录快速了解assets/静态资源仓库图片、配置模板等cron/定时任务让 AI 代理定时执行操作docker/Docker 部署配置文件nix/Linux 系统专属适配scripts/脚本工具快速部署 / 初始化skills/AI 代理技能库预设能力模板tests/测试用例保证功能稳定四、实战演示AI 代理如何执行「创建文件」任务光看架构不够我们用一个真实需求走通全流程用户指令帮我在桌面创建一个 test.txt 文件用户输入命令 → hermes_cli前台接收请求 ↓ 请求转发 → agent/大脑分析需求需要创建文件 ↓ 调度工具 → tools/file_tools.py文件工具执行创建 ↓ 环境执行 → environments/本地环境在桌面生成文件 ↓ 结果返回 → hermes_cli前台告知用户创建成功整个过程完全自动化就像一个公司从「接单」到「交付」的全流程。五、核心总结为什么 Hermes 的架构设计如此优秀看完根目录你会发现 Hermes Agent 的设计遵循 3 个核心原则模块化解耦每个目录只做一件事修改 / 扩展不影响其他功能贴近现实逻辑用公司架构组织代码新手极易理解高可扩展性想加新工具、新平台、新环境直接对应目录开发即可一句话记住核心分工agent/是大脑做决策gateway/是客服对接用户tools/是手脚执行操作hermes_cli/是前台接收命令六、下期预告《Hermes Agent 源代码解析二核心决策引擎 agent / 深度拆解》我们将深入总经理办公室揭秘 AI 代理如何思考、如何选择工具、如何管理记忆手把手带你看懂 AI 代理的核心逻辑。互动话题你在学习 Hermes Agent 时遇到过哪些目录相关的困惑或者最想了解哪个模块的源码欢迎在评论区留言我们下期针对性解答