本文档介绍了 Pi 项目中的 TUI 组件系统，用于构建交互式终端用户界面。内容包括组件接口（render、handleInput、invalidate）、焦点管理（IME支持）、覆盖层（Overlay）的使用与生命周期、内置组件（Text、Box、Container、Markdown、Image等）、键盘输入处理、自定义组件示例、主题系统（前景色/背景色）、性能缓存、以及常见模式（选择对话框、异步操作、设置列表、状态指示器等）。重点强调了组件必须正确实现 invalidate 以支持主题切换，以及覆盖层的焦点控制与生命周期管理。文章还提供了多个实用示例和关键规则，适合需要为 Pi 智能助手扩展定制 UI 的开发者。
