第六篇：TUI 界面——更好看的终端体验

这篇讲的是：如何让 Hermes Agent 从“黑底白字的命令行”变成“带颜色、带面板、好操作的可视化界面”——就像把老式收音机换成了带屏幕的智能音箱。

为什么需要 TUI？

你之前用 Hermes Agent，是不是都是在终端里敲命令、看纯文本输出？
对于普通用户来说，这就像看一张没有格式的 Excel 表——能看懂，但费劲。
TUI（Text User Interface，文本用户界面） 就是给终端“化妆”：它用字符画出边框、菜单、状态栏，甚至支持鼠标点击。
好处是： 你不用记命令，界面会告诉你该按什么键。

第1步：安装 TUI 组件

打开终端，输入：

pip install hermes-agent[tui]

如果你用的是 uv 或 poetry，把 pip 换成对应命令即可。
这一步是必须的，不装的话，后面启动 TUI 会报错。

第2步：启动 TUI 模式

装好后，正常启动 Hermes Agent，但加一个参数：

hermes --tui

或者，如果你在代码里调用：

from hermes import Agent
agent = Agent(ui="tui")
agent.run()

看到效果了吗？
终端里会出现一个带边框的界面，顶部是输入框，底部是状态栏，中间是对话记录。
这就像从“记事本”切换到了“Word”——还是纯文本，但结构清晰多了。

第3步：熟悉基本操作（不用记命令）

TUI 界面里，你只需要：

输入问题：直接在底部输入框打字，按 Enter 发送。
查看历史：按 ↑ / ↓ 键上下翻看之前的对话。
切换面板：按 Tab 在“对话区”和“工具输出区”之间跳转。
退出：按 Ctrl+C 或输入 /quit。

小比喻： 这就像用遥控器换台——你不需要知道电视内部怎么工作，按几个键就行。

第4步：自定义外观（可选）

如果你觉得默认配色不好看，可以改配置文件。
在 Hermes 的配置目录下（通常是 ~/.hermes/config.toml），加上：

[tui]
theme = "dracula"   # 可选：monokai, solarized, github
show_timestamps = true

改完保存，重启 TUI 就生效。
试试不同主题，找到你眼睛最舒服的那个。

第5步：遇到问题怎么办？

界面乱码：检查终端是否支持 UTF-8，推荐用 Windows Terminal 或 iTerm2。
鼠标没反应：部分终端需要按住 Shift 再点击。
想回到纯命令行：去掉 --tui 参数即可，两种模式随时切换，不影响数据。

小总结

TUI 界面不是必需，但能大幅提升使用体验——尤其当你每天要和 Agent 对话几十次时。
它让你少记命令、多关注内容，而且配置简单，随时可回退。

下一篇预告： 我们将聊聊 “插件系统”——如何像装手机 App 一样，给 Hermes Agent 添加新技能（比如联网搜索、发邮件）。别错过，下篇更实用。