🧭 Hermes Agent TUI 使用指南

一、什么是 TUI？

Hermes 的 TUI（Terminal User Interface，终端图形界面） 是一个比传统 CLI 更现代的终端交互界面。同样的智能体，同样的会话，同样的斜杠命令；一个更整洁、响应更迅速的交互界面。这是以交互方式运行 Hermes 的推荐方式。

👉 启动方式：

hermes --tui

# 恢复最新的TUI会话（若失败则回退至最新的经典会话）
hermes --tui -c
hermes --tui --continue

# 根据ID或标题恢复特定会话
hermes --tui -r 20260409_000000_aa11bb
hermes --tui --resume "my t0p session"

# 直接运行源代码 — 跳过预构建步骤（适用于TUI贡献者）
hermes --tui --dev

它与 CLI 共用：

• 会话（sessions）
• 配置（config）
• Slash 命令
• 技能系统（skills）

但在体验上更接近“终端里的应用程序”。 (赫尔墨斯代理)

---

二、TUI 的核心特性

相比传统 CLI，TUI 提供更丰富的交互能力：

✅ 界面能力

• 模态窗口（Modal overlays）
• 鼠标选择支持
• 非阻塞输入（可以边运行边输入）
• 更清晰的布局结构

👉 本质上：
TUI = “更像 GUI 的终端界面”

---

三、界面结构

启动后你会看到：

1️⃣ 顶部（Header）

显示：

• 当前模型
• 提供商（provider）
• 已加载工具
• 当前技能

---

2️⃣ 中间（主对话区）

用于：

• 显示对话内容
• 展示工具执行结果
• 显示推理/操作过程

---

3️⃣ 底部（输入区）

用于：

• 输入问题
• 执行命令
• 多行编辑

---

4️⃣ 弹层（Modal）

TUI 的一个关键特点：

👉 可以弹出交互窗口，比如：

• 命令选择
• 技能浏览
• 设置面板

---

四、交互方式

TUI 支持两种操作：

⌨️ 键盘操作

与 CLI 基本一致：

按键	功能
Enter	发送
Ctrl+C	中断
Ctrl+D	退出
Tab	自动补全

---

🖱 鼠标操作

TUI 新增支持：

• 点击选择内容
• 滚动查看历史
• 与弹窗交互

👉 这是 CLI 没有的体验升级

---

五、非阻塞输入（核心优势）

在 TUI 中：

👉 你可以在 AI 运行时继续输入内容

这带来几个关键能力：

• 实时打断任务
• 修改问题方向
• 并行思考

相比 CLI 更流畅。

---

六、与 CLI 的区别

对比项	CLI	TUI
输入方式	阻塞	非阻塞
界面	纯文本	布局化
鼠标支持	❌	✅
弹窗	❌	✅
体验	工具型	应用型

👉 官方建议：
新用户优先使用 TUI (赫尔墨斯代理)

---

七、如何选择？

适合 CLI 的人：

• 习惯纯终端
• 追求极简
• 喜欢脚本化

适合 TUI 的人：

• 想要更直观体验
• 需要多任务交互
• 喜欢 GUI 风格操作

---

八、一句话总结

👉 Hermes TUI 本质是：

“一个运行在终端里的 AI 应用界面（类似轻量 IDE）”

相比 CLI，它更适合长期使用和复杂任务。