Hermes Agent 项目思维导图

这份文档用于导入 XMind 或其他支持 Markdown 层级导入的思维导图工具。主体内容尽量使用稳定的分级结构，减少长段解释，方便直接转换为脑图。

• Hermes Agent
  • 项目定位
  • 自主型 AI Agent 运行时
  • 不只是聊天界面
  • 不只是 IDE copilot
  • 目标
    • 调用工具完成任务
    • 跨会话保留长期能力
    • 跨平台运行
    • 支持自动化与扩展
  • 典型场景
    • 本地开发助手
    • 远程消息平台代理
    • 定时任务与监控
    • 企业内部系统接入
    • 研究与批处理
  • 用户入口
  • CLI
    • hermes
    • 交互式主入口
    • 最完整的调试与观察界面
  • Gateway
    • hermes gateway
    • Telegram
    • Discord
    • Slack
    • WhatsApp
    • Signal
    • 其他平台适配器
  • ACP
    • 编辑器集成
    • VS Code
    • Zed
    • JetBrains
  • API Server / Python Library / Batch Runner
    • 程序化调用
    • 轨迹批处理
    • 研究与训练相关入口
  • 核心能力
  • Tools
    • 文件操作
    • 终端执行
    • Web 搜索与抽取
    • Browser 自动化
    • Vision / TTS / Image Gen
    • Memory
    • Messaging
    • Delegation
    • Cron
  • Toolsets
    • 核心 toolset
    • 组合 toolset
    • 平台 toolset
    • 动态 toolset
  • Skills
    • 按需加载的流程知识
    • 本地 skills
    • Skills Hub
    • 动态 slash commands
  • Memory
    • 跨会话事实信息
    • MEMORY.md / USER.md
    • 外部 memory provider
  • Context Files
    • AGENTS.md
    • SOUL.md
    • .cursorrules
    • .cursor/rules/*.mdc
  • MCP
    • 外部工具接入
    • stdio server
    • HTTP server
    • 动态工具注册
  • Cron
    • 定时运行新 session
    • delivery 到平台
  • Delegation
    • 子代理
    • 并行任务
    • 上下文隔离
  • 核心运行系统
  • AIAgent
    • run_agent.py
    • chat()
    • run_conversation()
    • 同步 agent loop
  • Prompt Builder
    • agent/prompt_builder.py
    • 组装系统提示词
    • 注入 personality / memory / context / skills
  • Prompt Caching
    • agent/prompt_caching.py
    • 保持 prefix cache
  • Context Compression
    • agent/context_compressor.py
    • 长会话压缩
  • Provider / Runtime Resolution
    • hermes_cli/runtime_provider.py
    • hermes_cli/auth.py
    • provider 选择
    • credentials 解析
  • Tool Dispatch
    • model_tools.py
    • schema 收集
    • handle function call
    • tool availability gating
  • Session Storage
    • hermes_state.py
    • gateway/session.py
    • SQLite + FTS5
  • Response Delivery
    • CLI display
    • gateway delivery
    • cron delivery
  • 核心模块
  • 顶层核心文件
    • run_agent.py
    • cli.py
    • model_tools.py
    • toolsets.py
    • hermes_state.py
    • batch_runner.py
  • agent/
    • prompt builder
    • context compressor
    • prompt caching
    • auxiliary client
    • display
    • skill commands
    • trajectory
  • hermes_cli/
    • main.py
    • config.py
    • commands.py
    • setup.py
    • tools_config.py
    • skills_config.py
    • model_switch.py
    • auth.py
  • tools/
    • registry.py
    • terminal_tool.py
    • file_tools.py
    • web_tools.py
    • browser_tool.py
    • code_execution_tool.py
    • delegate_tool.py
    • mcp_tool.py
    • environments/
  • gateway/
    • run.py
    • session.py
    • delivery.py
    • pairing.py
    • platforms/
  • cron/
    • jobs.py
    • scheduler.py
  • 其他关键目录
    • acp_adapter/
    • plugins/
    • skills/
    • optional-skills/
    • website/
    • tests/
  • 配置与状态体系
  • ~/.hermes/config.yaml
  • ~/.hermes/.env
  • ~/.hermes/SOUL.md
  • ~/.hermes/skills/
  • ~/.hermes/sessions/
  • HERMES_HOME
  • Profiles
    • hermes profile list
    • hermes profile create
    • hermes profile use
    • hermes profile show
  • 关键规则
  • Prompt cache 不应随意打破
  • 不要中途重建系统提示
  • Toolset 不应在会话中随意变化
  • profile-safe 路径规则
    • get_hermes_home()
    • display_hermes_home()
  • Tool / Skill / MCP 的选择边界
    • 流程优先 skill
    • 外部系统优先 MCP
    • 原生底层能力再做 tool
  • 测试不要写到真实 ~/.hermes
  • 关键文件
  • 入口
    • run_agent.py
    • cli.py
    • gateway/run.py
  • 工具系统
    • model_tools.py
    • toolsets.py
    • tools/registry.py
  • 配置系统
    • hermes_cli/config.py
    • hermes_cli/main.py
    • hermes_constants.py
  • 会话与状态
    • hermes_state.py
    • gateway/session.py
  • 扩展系统
    • tools/mcp_tool.py
    • agent/skill_commands.py
    • hermes_cli/commands.py
  • 关键流程
  • CLI 请求流程
    • 用户输入
    • CLI
    • AIAgent
    • Prompt Builder
    • Provider / Runtime Resolution
    • Model API Call
    • Tool Dispatch
    • Built-in Tools / MCP Tools
    • Session Storage
    • CLI display
  • Gateway 请求流程
    • 平台消息
    • Gateway
    • 会话解析与授权
    • AIAgent
    • Tool Dispatch
    • Session Storage
    • 平台回传
  • Cron 请求流程
    • Scheduler Tick
    • 新 session
    • AIAgent
    • Tool Dispatch
    • Session Storage
    • Delivery target
  • MCP 工具接入流程
    • mcp_servers
    • server connect
    • tool discovery
    • dynamic toolset
    • model 可调用
  • Tool 调用流程
    • schema collection
    • model tool call
    • handle_function_call()
    • registry dispatch
    • tool result
    • loop continuation
  • 常用命令与观察点
  • CLI
    • hermes
    • hermes setup
    • hermes model
    • hermes tools
    • hermes gateway
    • hermes cron
  • Session Commands
    • /model
    • /usage
    • /compress
    • /tools
    • /toolsets
    • /skills
    • /reload-mcp
    • /background
  • Debug
    • hermes doctor
    • hermes status
    • /verbose
    • python -m pytest tests/ -q