快速定位

基础概念

关系速记

最短路径

hermes chat -q "Hello"           # 单次查询
hermes                              # 交互式对话
hermes chat --model <model>         # 指定模型
hermes setup                        # 全量配置向导

子代理与分工

一句话理解

适用边界

核心规则

最短入口

/agents
/tasks

常用调用

delegate_task(
  goal="Review the authentication module for security issues and fix any found",
  context="Project at /home/user/webapp. Focus on SQL injection, JWT validation, password handling, and session management.",
  toolsets=["terminal", "file"]
)

delegate_task(
  goal="Survey three code review approaches and recommend one",
  role="orchestrator",
  context="...",
  toolsets=["web"]
)

并行批处理

delegate_task(tasks=[
  {"goal": "Research topic A", "toolsets": ["web"]},
  {"goal": "Research topic B", "toolsets": ["web"]},
  {"goal": "Fix the build", "toolsets": ["terminal", "file"]}
])

和 execute_code 的区别

起步流

先把运行后端定下来

hermes config set terminal.backend docker
hermes config set terminal.backend ssh

先把模型配对

先把工具范围收口

高频场景

1. 先建项目上下文

cd your-repo
hermes
/help
/tools

2. 先规划再执行

hermes config set terminal.backend docker
请先给出执行计划，再开始修改

3. 先用技能复用流程

hermes skills search kubernetes
hermes skills search react --source skills-sh
hermes skills install openai/skills/k8s
/skills
/github-pr-workflow

4. 先做消息平台接入

hermes gateway setup

5. 先开语音模式

pip install "hermes-agent[voice]"
pip install faster-whisper
/voice on
/voice tts

6. 先加定时任务

/cron add 30m "提醒我检查构建"
/cron add "every 2h" "检查服务状态"
/cron add "every 1h" "汇总新的信息流" --skill blogwatcher

7. 先用子代理拆任务

8. 先接 MCP

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

9. 先接编辑器

pip install -e '.[acp]'
hermes acp

10. 先用后台任务

/background 分析 /var/log 下今天的错误日志

11. 先用 Profile 隔离多实例

hermes profile create work
hermes -p work
hermes profile list

12. 先配凭证池轮转

credential_pool:
  openrouter:
    - sk-or-key1
    - sk-or-key2
credential_pool_strategies:
  openrouter: least_used

速查卡

CLI 命令

CLI 内命令

消息网关平台（统一斜杠命令）

关键配置

记忆与上下文

安全默认值

辅助模型配置

结构图

hermes-agent/
├── run_agent.py
├── cli.py
├── toolsets.py
├── hermes_state.py
├── batch_runner.py
├── agent/
│   ├── prompt_builder.py
│   ├── context_compressor.py
│   ├── auxiliary_client.py
│   └── skills_hub.py
├── tools/
│   ├── registry.py
│   ├── approval.py
│   ├── terminal_tool.py
│   ├── file_operations.py
│   ├── web_tools.py
│   ├── vision_tools.py
│   ├── delegate_tool.py
│   ├── session_search_tool.py
│   ├── cronjob_tools.py
│   └── skill_manager_tool.py
├── gateway/
│   ├── run.py
│   ├── config.py
│   └── platforms/
├── plugins/
└── skills/ / optional-skills/ / environments/ / tests/

风险控制

hermes config set approvals.mode smart
hermes config set terminal.backend docker
hermes config set security.redact_secrets true
hermes config set security.tirith_enabled true

收尾