Hermes Agent 教程 5：CLI 与 TUI — 终端界面完整指南

教程概述

系列索引: Hermes Agent 教程系列

本文介绍 Hermes Agent 的终端界面，面向偏好在命令行中与 Agent 交互的用户，覆盖 CLI 命令和 TUI 特性。

说明：如果你已经通过消息网关部署了 Hermes（教程 4），这一篇会补上终端基础。如果你只打算在终端中使用 Hermes，那么这篇就是你的主界面指南。

你将学到什么

✅ CLI 的主要入口及其用途
✅ TUI 功能：多行编辑、自动补全、历史记录
✅ 核心斜杠命令及其用法
✅ 面向不同场景的人格系统
✅ 会话管理与持久化

CLI 入口

主要命令

Hermes 提供多组 CLI 命令，面向不同用途：

命令	用途	使用场景
`hermes`	交互式 TUI	开始对话
`hermes gateway`	消息网关	部署到平台
`hermes model`	模型管理	切换提供商
`hermes setup`	配置向导	初始设置
`hermes config`	设置管理	查看或编辑配置
`hermes skills`	技能管理	列出或创建技能
`hermes memory`	记忆管理	查看或导出记忆
`hermes doctor`	诊断工具	排查问题

命令流

flowchart TD
    A[hermes] --> B[交互式 TUI]
    C[hermes gateway] --> D[平台守护进程]
    E[hermes model] --> F[切换提供商]
    G[hermes setup] --> H[配置向导]
    I[hermes doctor] --> J[健康检查]

    style B fill:#e1f5ff
    style D fill:#fff3e0

TUI 功能

终端用户界面

运行 hermes 后，你会进入一个完整的 TUI：

flowchart LR
    subgraph TUI
        A[顶部: 模型 + 使用量]
        B[对话区域]
        C[输入框]
        D[状态栏]
    end

    style A fill:#e8f5e9
    style B fill:#e1f5ff

多行编辑

按 Ctrl+J 或 Alt+Enter 可以在消息中插入换行：

你: 我需要写一个函数，要求：
1. 校验输入
2. 处理数据
3. 返回结果

[使用 Ctrl+J 换行]

自动补全

Hermes 会在以下场景提供自动补全：

斜杠命令：输入 / 后按 Tab
模型名：输入 /model 后按 Tab
技能名：输入 /skill 后按 Tab

历史导航

Ctrl+P / Ctrl+N：上一条 / 下一条消息
Ctrl+R：搜索历史
↑ / ↓：方向键同样可用

中断处理

Ctrl+C：中断当前响应
发送新消息：可在执行中途重定向 Agent
/stop：更优雅地停止当前工作

关键命令

常用斜杠命令

命令	用途	示例
`/new`	新建对话	`/new`
`/reset`	清空上下文	`/reset`
`/model`	查看或切换模型	`/model openrouter:claude-3`
`/retry`	重新生成上一次响应	`/retry`
`/undo`	撤销上一轮	`/undo`
`/compress`	压缩上下文	`/compress`
`/usage`	查看 token 使用量	`/usage`
`/insights`	会话分析	`/insights --days 7`
`/skills`	浏览技能	`/skills`
`/stop`	中断当前任务	`/stop`
`/exit`	退出 Hermes	`/exit`

切换模型

/model                          # 查看当前模型
/model openrouter:auto          # 切到自动选择
/model anthropic:claude-4       # 切到 Claude 4
/model openai:gpt-4o            # 切到 GPT-4o

记忆相关命令

/memory show                    # 查看用户档案
/memory list                    # 查看洞察列表
/memory search "api design"     # 搜索历史会话

上下文管理

/compress                       # 压缩长上下文
/usage                          # 查看当前用量
/reset                          # 重置上下文

人格系统

什么是人格？

人格是一组面向特定场景的预设配置：

flowchart TD
    A[基础 Hermes] --> B[developer]
    A --> C[researcher]
    A --> D[writer]
    A --> E[assistant]

    style A fill:#e1f5ff

可用人格

人格	侧重点	适合场景
`developer`	代码、调试	编程任务
`researcher`	分析、综合	文献研究
`writer`	草稿、润色	内容创作
`assistant`	通用帮助	日常任务

切换人格

/personality developer
/personality researcher
/personality default

创建自定义人格

# 创建人格文件
nano ~/.hermes/personalities/my-work.md

格式示例：

---
name: my-work
description: Work-focused assistant
---

## Style
- Professional tone
- Bullet-point summaries
- Action-oriented recommendations

## Preferences
- Focus on actionable output
- Minimize explanation unless asked

启用方式：

/personality my-work

会话管理

会话持久化

Hermes 会自动把会话保存到：

~/.hermes/sessions/
├── 2026-04-13-001.json
├── 2026-04-13-002.json
└── ...

会话命令

命令	用途
`/new`	开始新会话
`/resume SESSION`	恢复历史会话
`/sessions`	列出会话

恢复一个会话

/sessions                      # 查看最近会话
/resume 2026-04-12-003         # 恢复指定会话

搜索历史会话

查找过去的对话：

/search "authentication bug"
/search --from 2026-04-01 --to 2026-04-10

平台状态

对 CLI 用户

/status                        # 查看守护进程状态
/platforms                     # 查看已连接平台

设置主平台（适用于网关用户）

/sethome telegram              # Telegram 设为主平台
/sethome cli                   # CLI 设为主平台

配置

查看配置

hermes config show

设置配置项

hermes config set model.default "openrouter:auto"
hermes config set memory.nudges.enabled true
hermes config set transcription.provider whisper

编辑配置文件

nano ~/.hermes/config.yaml

配置示例：

model:
  default: openrouter:auto
  fallback: openrouter:claude-3-haiku

memory:
  nudges:
    enabled: true
    interval: 10  # 轮次

gateway:
  telegram:
    enabled: true
    token: "YOUR_TOKEN"

transcription:
  provider: whisper

常见问题排查

TUI 无法启动

原因：终端兼容性问题。

解决方案：

# 查看终端类型
echo $TERM

# 强制使用基础模式
hermes --mode simple

命令不生效

原因：斜杠命令语法写错。

解决方案：命令必须以 / 开头，且一般不需要为参数加引号：

/model openrouter:auto    # 正确
/model "openrouter:auto"  # 错误

会话没有持久化

原因：会话保存功能被关闭。