Hermes Agent 常用操作和命令使用手册

Hermes Agent 常用操作和命令使用手册

目录

• [一、Hermes Agent 是什么](#一、Hermes Agent 是什么)
• [二、启动 Hermes](#二、启动 Hermes)
  • [1. 普通启动](#1. 普通启动)
  • [2. 启动 TUI 界面](#2. 启动 TUI 界面)
  • [3. 继续上一次会话](#3. 继续上一次会话)
• 三、常用聊天方式
  • [1. 普通问答](#1. 普通问答)
  • [2. 文件分析](#2. 文件分析)
  • [3. 代码相关](#3. 代码相关)
  • [4. 文档写作](#4. 文档写作)
  • [5. 终端任务](#5. 终端任务)
• 四、配置相关命令
  • [1. 重新运行完整配置向导](#1. 重新运行完整配置向导)
  • [2. 重新配置模型](#2. 重新配置模型)
  • [3. 重新配置终端后端](#3. 重新配置终端后端)
  • [4. 重新配置工具](#4. 重新配置工具)
  • [5. 配置消息网关](#5. 配置消息网关)
• 五、查看和修改配置
  • [1. 查看当前配置](#1. 查看当前配置)
  • [2. 打开配置文件](#2. 打开配置文件)
  • [3. 设置单个配置项](#3. 设置单个配置项)
• 六、诊断和修复
  • [1. 查看运行日志](#1. 查看运行日志)
  • [2. 诊断工具状态](#2. 诊断工具状态)
  • [3. 常见问题修复](#3. 常见问题修复)
  • [4. 获取帮助](#4. 获取帮助)
• 七、更新和卸载
  • [1. 更新 Hermes Agent](#1. 更新 Hermes Agent)
  • [2. 卸载 Hermes Agent](#2. 卸载 Hermes Agent)
  • [3. 重新安装](#3. 重新安装)
  • [4. 备份和恢复](#4. 备份和恢复)
• 八、常用命令速查表
  • 启动相关
  • 聊天方式
  • 配置管理
  • 诊断维护
  • 更新卸载
  • 快捷参数
• 九、总结

---

一、Hermes Agent 是什么

Hermes Agent 是一个本地命令行 AI Agent 工具。它可以连接大模型，例如 DeepSeek、OpenAI、OpenRouter、Ollama 等，也可以配置工具能力，例如终端、浏览器、语音、图片生成、消息网关等。

你可以把它理解成：

一个可以在终端里聊天、调用工具、执行任务的 AI 助手。

安装完成后，最常用的入口命令是：

hermes

---

二、启动 Hermes

1. 普通启动

在 PowerShell 或 Windows Terminal 中输入：

hermes

作用：

启动 Hermes 聊天模式。

启动后可以直接输入问题，例如：

你好，介绍一下你自己。

或者：

帮我分析当前目录下有哪些文件。

---

2. 启动 TUI 界面

如果你的版本支持 TUI，可以使用：

hermes --tui

作用：

启动更完整的终端交互界面。

---

3. 继续上一次会话

hermes --continue

或者简写：

hermes -c

作用：

继续最近一次对话，不从新会话开始。

适合场景：

• 上次任务没做完
• 想继续之前的上下文
• 不想重新描述需求

---

三、常用聊天方式

启动 Hermes 后，可以直接像聊天一样输入任务。

1. 普通问答

解释一下什么是 LoRA 微调。

DeepSeek 和 Qwen 有什么区别？

---

2. 文件分析

帮我查看当前目录有哪些文件，并总结每个文件的作用。

帮我阅读这个项目，告诉我入口文件在哪里。

---

3. 代码相关

帮我检查这个 Python 脚本有没有问题。

帮我给当前项目写一个 README。

帮我修改代码，让它支持命令行参数。

---

4. 文档写作

帮我把这段内容整理成 CSDN 风格的 Markdown 文档。

帮我写一份安装教程，要求适合新手。

---

5. 终端任务

如果你配置了 local terminal，Hermes 可以在本机执行命令。

可以这样说：

帮我查看当前 Python 版本。

帮我检查 Git 是否安装成功。

帮我运行这个项目的测试。

注意：

涉及删除文件、修改系统配置、安装软件等操作时，要先确认它要做什么。

---

四、配置相关命令

1. 重新运行完整配置向导

hermes setup

作用：

重新配置模型、终端、工具、网关等。

适合场景：

• 第一次配置错了
• 想重新选择模型服务
• 想重新配置所有选项

---

2. 重新配置模型

hermes setup model

作用：

只重新配置模型提供商和模型名称。

适合场景：

• 从 DeepSeek 换成 OpenRouter
• 从 deepseek-chat 换成 deepseek-reasoner
• 修改 API Key
• 修改 Base URL

---

3. 重新配置终端后端

hermes setup terminal

作用：

选择 Hermes 执行终端命令的环境。

常见选项：

选项	说明
Local	直接在本机执行命令
Docker	在 Docker 容器中执行命令
SSH	在远程机器执行命令
Keep current	保持当前配置

个人电脑新手一般选择：

Local

如果担心安全，可以选择：

Docker

但 Docker 需要提前安装 Docker Desktop。

---

4. 重新配置工具

hermes setup tools

作用：

配置浏览器、图片生成、TTS、搜索等工具。

常见建议：

工具	新手建议
Browser	选 Local Browser
Image Generation	可以先 Skip
Text-to-Speech	可以先 Skip 或选 Microsoft Edge TTS
Search	如果没有订阅，可以先跳过

---

5. 配置消息网关

hermes setup gateway

作用：

配置 Telegram、Discord、Slack、Email 等消息平台。

新手建议：

先不用配置，等命令行能稳定使用后再研究。

---

五、查看和修改配置

1. 查看当前配置

hermes config

作用：

显示当前 Hermes 配置。

可以用来确认：

• 当前模型
• 当前 provider
• 终端后端
• 工具配置
• 配置文件路径

---

2. 打开配置文件

hermes config edit

作用：

用编辑器打开配置文件。

Hermes 的主要配置文件一般在：

C:\Users\sky\AppData\Local\hermes\config.yaml

密钥文件一般在：

C:\Users\sky\AppData\Local\hermes\.env

注意：

.env 里通常保存 API Key，不要公开发给别人。

---

3. 设置单个配置项

hermes config set <key> <value>

示例：

hermes config set terminal.backend local

作用：

把终端后端设置为 local。

---

六、诊断和修复

当 Hermes Agent 出现异常时，可以使用以下命令进行诊断和修复：

1. 查看运行日志

# 查看最近的日志
hermes logs

# 查看详细的调试日志
hermes logs --debug

# 查看特定会话的日志
hermes logs --session-id <session_id>

2. 诊断工具状态

# 检查所有工具的状态
hermes diagnose tools

# 检查模型连接状态
hermes diagnose model

# 检查终端后端状态
hermes diagnose terminal

# 运行完整诊断
hermes diagnose --all

3. 常见问题修复

# 重置会话状态（当会话卡住时）
hermes reset-session

# 清理临时文件
hermes cleanup

# 修复配置文件权限
hermes fix-permissions

# 重新初始化工具环境
hermes init-tools

4. 获取帮助

# 查看所有可用命令
hermes --help

# 查看特定命令的帮助
hermes <command> --help

# 查看版本信息
hermes --version

七、更新和卸载

1. 更新 Hermes Agent

# 检查更新
hermes check-update

# 更新到最新版本
hermes update

# 更新到指定版本
hermes update --version 1.2.3

# 更新并重启服务
hermes update --restart

2. 卸载 Hermes Agent

# 完全卸载（保留配置文件）
hermes uninstall

# 完全卸载（删除所有文件，包括配置文件）
hermes uninstall --purge

# 仅卸载特定组件
hermes uninstall --component tools
hermes uninstall --component model

3. 重新安装

# 卸载后重新安装
hermes reinstall

# 重新安装指定版本
hermes reinstall --version 1.2.3

# 重新安装并恢复配置
hermes reinstall --restore-config

4. 备份和恢复

# 备份当前配置
hermes backup-config

# 恢复备份的配置
hermes restore-config --file backup_20240614.json

# 导出当前配置
hermes export-config --output my_config.json

# 导入配置
hermes import-config --file my_config.json

八、常用命令速查表

启动相关

命令	说明	示例
hermes	启动 Hermes Agent	hermes
hermes --tui	启动 TUI 界面	hermes --tui
hermes --continue	继续上次会话	hermes --continue

聊天方式

命令	说明	示例
hermes chat	普通问答模式	hermes chat
hermes analyze <file>	分析文件	hermes analyze document.pdf
hermes code <file>	代码相关操作	hermes code main.py
hermes write <topic>	文档写作	hermes write "项目计划"
hermes terminal <task>	终端任务	hermes terminal "列出文件"

配置管理

命令	说明	示例
hermes config	查看当前配置	hermes config
hermes config-wizard	运行配置向导	hermes config-wizard
hermes config-model	重新配置模型	hermes config-model
hermes config-terminal	重新配置终端	hermes config-terminal
hermes config-tools	重新配置工具	hermes config-tools
hermes config-gateway	配置消息网关	hermes config-gateway
hermes edit-config	编辑配置文件	hermes edit-config
hermes set <key> <value>	设置配置项	hermes set model.temperature 0.7

诊断维护

命令	说明	示例
hermes diagnose	运行诊断	hermes diagnose
hermes logs	查看日志	hermes logs
hermes reset-session	重置会话	hermes reset-session
hermes cleanup	清理临时文件	hermes cleanup

更新卸载

命令	说明	示例
hermes update	更新到最新版	hermes update
hermes uninstall	卸载 Hermes	hermes uninstall
hermes reinstall	重新安装	hermes reinstall
hermes backup-config	备份配置	hermes backup-config

快捷参数

参数	说明	示例
-h, --help	显示帮助	hermes --help
-v, --version	显示版本	hermes --version
-d, --debug	调试模式	hermes --debug
-q, --quiet	静默模式	hermes --quiet