在为 Go Agent 库 Covonaut 构建 TUI（终端交互界面）时，我实现了一套完整的底层能力，这篇文章就来梳理下当前具备的功能。
基于 Elm 架构的状态管理采用了 Elm 架构，将 UI 视为一棵组件树，所有的刷新都由消息（Msg）和命令（Cmd）驱动，组件只负责声明“如何绘制”，引擎则负责将渲染结果输出到终端。
这种模式的状态流向特别清晰，无论是用户按键、Agent 响应还是定时器触发，都会统一转化为消息，进而驱动界面重绘。组件无需关心“何时更新”，只需响应“当前状态”并返回对应的视图即可。
差分更新式渲染替代整屏刷新式渲染终端环境不同于浏览器，整屏刷新往往难以保证流畅度。Covonaut 的 TUI 采用了逐帧差分比对机制：只将真正发生变化的单元格写入终端，若光标所在行无变动则直接跳过。
在长对话场景中，当 Agent 持续流式输出 token 时，这种优化体感尤为明显，屏幕上绝大多数内容是静止的，只有正在生成的几行在变化。差分渲染精准地只更新相应区域，避免了不必要的整屏重绘开销。
交互与视觉反馈终端交互体验要好用，这几块基础能力少不了：
精准按键解析：支持 Kitty 键盘协议，能够精确区分组合键、识别按下与长按重复事件，彻底解决了 Ctrl+C 等控制序列被误判的问题。主题热重载：配色与样式通过 JSON 文件定义，修改后即时生效，无需重启程序即可使用新主题。终端图片显示：支持在终端内直接渲染图片，自动适配 Kitty、Sixel、iTerm2 三种主流协议，根据当前终端能力智能选择最优方案。Emacs 风格多行编辑：输入框支持多行编辑，并内置了常用的行内移动、删除等 Emacs 快捷键，提升文本编辑效率。富文本与辅助交互仅有渲染和基础输入还不够，为了让 TUI 真正“可用”，还实现了以下关键功能：
Overlay 支持：支持在主窗口上叠加弹窗或命令面板（如命令清单、确认对话框），并提供居中、右下角等多种布局选项。Markdown 原生渲染：Agent 返回的 Markdown 内容直接在终端内渲染为带格式的段落与代码块，代码块还支持按语言进行语法高亮。智能自动补全：输入框支持静态词表与文件路径两种补全来源，其中路径补全还集成了模糊匹配，输入部分内容即可获得精准提示。这些能力组合在一起，让终端界面超越了单纯的“文字回显”，具备了弹面板、读富文本、辅助输入等现代交互体验。
日常使用体验除了核心功能，一些决定“顺手程度”的细节组件也实现了：
状态栏：在界面顶部或底部常驻，实时展示连接状态、模型信息及运行状态。动态按键帮助：根据已注册的绑定自动生成帮助面板，随时唤起查看可用快捷键，告别翻文档。交互式设置面板：所有配置均可在终端内直接操作调整。加载反馈：Agent 处理期间提供加载动画（支持中途取消），避免用户误判程序卡死。聊天记录管理：历史对话支持滚动回看与复制；流式输出时增量追加内容，并自动跟随至最新消息。跑起来看效果仓库中提供了三个演示示例（tui-demo、tui-demo2、tui-demo3），分别侧重不同能力的展示。相比阅读文档，clone 下来亲自运行会有更直观的感受。
要让一套终端界面达到好用的标准，需要打磨的细节远不止于此。以上是目前已落地的部分，后续也会根据实际使用反馈持续迭代。