Hermes Agent TUI全屏无法退出时，应先按Ctrl+C中断、Esc×3重置输入模式、再输q回车；若无效则Ctrl+Z挂起后fg恢复，或查PID用kill -SIGTERM终止；亦可启动时加--no-tui参数、改config.yaml设tui:false，或运行reset/stty sane修复终端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用 Hermes Agent 的 TUI（文本用户界面）并进入了全屏模式，但无法退出或切换回常规终端视图，则可能是由于终端控制序列未被正确响应或焦点被锁定。以下是解决此问题的步骤：
一、使用标准终端退出键组合
Hermes Agent 的 TUI 基于终端原生控制逻辑运行，其全屏状态依赖于 ANSI 转义序列与终端仿真器的协同。多数情况下，退出全屏不需关闭进程，仅需触发终端级退出信号。
1、按 Ctrl + C 尝试中断当前 TUI 渲染循环。
2、若无响应，连续按下 Esc 键三次，强制重置终端输入模式。
3、再输入 q 并回车，触发 TUI 内置退出指令（部分版本绑定为 quit 命令）。
二、通过进程信号强制恢复终端控制
当 TUI 占用终端控制权导致光标消失、键盘无响应时，说明终端处于 raw 模式且未正常释放。此时需绕过界面层直接干预进程行为。
1、保持当前终端窗口焦点，按下 Ctrl + Z 将前台进程挂起。
2、输入 fg %1 尝试恢复前台运行并观察是否同步释放终端控制。
3、若仍卡死，新开一个终端窗口，执行 ps aux | grep hermes 查找主进程 PID。
4、执行 kill -SIGTERM [PID] 发送温和终止信号，等待 TUI 自动清理终端状态。
三、禁用 TUI 启动以规避全屏问题
Hermes Agent 默认在无图形网关连接时启用 TUI，该模式本质是阻塞式终端渲染。跳过 TUI 可直接进入命令行交互态，彻底避免全屏锁定风险。
1、在启动命令末尾添加 --no-tui 参数，例如：hermes chat --no-tui。
2、若已配置默认网关（如微信或飞书），可改用 hermes gateway serve 启动后台服务，完全脱离终端界面依赖。
3、编辑 ~/.hermes/config.yaml，将 tui: true 改为 tui: false，保存后所有后续调用均默认禁用全屏。
四、重置终端显示状态
即使 Hermes Agent 进程已退出，终端可能残留非标准字符集或屏幕缓冲区错位，表现为乱码、光标不可见或背景色异常。此时需独立修复终端环境。
1、输入 reset 命令，强制刷新终端能力数据库并重置所有控制状态。
2、若 reset 无效，尝试 stty sane 恢复标准终端行设置。
3、对支持 truecolor 的终端（如 kitty、alacritty），额外执行 printf '\e[?1049l' 退出备用屏幕缓冲区（Alternate Screen Buffer）。
