09 终端 UI 与体验
交互面从纯文本流变成富渲染、折叠面板、原生微窗与 Web 驾驶舱
1. 这个方向的插件试图解决什么问题
随着 Agent 频繁读文件、跑命令、调子代理,原生连续滚动的纯文本日志会迅速变得难以扫读:大段 diff 和命令输出刷屏、状态栏缺少上下文与耗时感知、复杂图表或表单难以在 TUI 里直接操作。
这一方向的扩展沿着两条路径升级交互面:一条留在终端内部,通过语法高亮、工具调用结果折叠、可定制底部状态栏和 Leader 键菜单提升信息密度;另一条则跨出终端,把实时对话与遥测投影到本地 Web 驾驶舱或跨平台原生 WebView 微窗口。
2. 在 Pi 里怎么体现
Pi 内置 @earendil-works/pi-tui 与丰富的 UI 扩展接口:扩展可用 pi.registerMessageRenderer() 自定义工具块渲染,用 ctx.ui.setStatus() / setWidget() / custom() 接管页脚状态栏与浮层;跨出终端的扩展则在 session_start 启动本地 HTTP+SSE 服务(pi-webman)或通过 stdio JSON Lines 协议拉起原生系统 WebView(glimpseui)。
涉及的 Pi 事件钩子与注册接口
3. 代表包与生态实例
下表包名均核实自 npm、GitHub 与 pi.dev/packages(核对日期 2026-11-22)。前 3 项已上线独立机制详评页,正文不展示容易过期的静态下载量快照。
| 包名 | 分发形态 | 主要作用 | 详情 / 源码 |
|---|---|---|---|
pi-webman | npm | 零运行时依赖的本地 Web 驾驶舱扩展,为运行中的 Pi 终端会话提供实时对话流、上下文与费用遥测及命令面板。 | |
glimpseui | npm | 面向脚本与 Agent 的原生微 UI 引擎,用原生 WebView 打开独立窗口并通过双向 JSON 通信。 | |
@heyhuynhgiabuu/pi-pretty | npm | 终端渲染增强扩展,提供 Shiki 语法高亮、树形 ls、内联图片预览、折叠工具体及内嵌 FFF 检索。 | |
pi-starline | npm | 受 Starship 启发的状态栏与 OpenCode 风格 Pi TUI 视觉扩展。 | |
pi-tidy | npm | 工具输出折叠扩展,将常规工具调用压缩为单行可展开摘要,失败与代码 diff 保持可见。 | |
@agimon-ai/po-ui | npm | Po 与 Pi 扩展生态的 Leader 键菜单、主题及 TUI 组件基础设施。 | |
@narumitw/pi-statusline | npm | 替换 Pi 默认页脚的信息增强型状态栏扩展。 |
4. 怎么装
pi install npm:@heyhuynhgiabuu/pi-pretty - @heyhuynhgiabuu/pi-pretty 内置了 FFF 搜索并接管内置 find/grep,官方明确提示开启该模式时不要同时加载 @ff-labs/pi-fff。
- 终端内联图片预览依赖终端协议支持(Ghostty、Kitty、iTerm2、WezTerm),在 tmux 中需开启 allow-passthrough。
- glimpseui 在 macOS / Linux / Windows 安装时会触发原生 WebView 桥接二进制的构建或预编译检查。
5. 和同类怎么选
| 包名 | 交互形态 | 核心能力 | 适用场景 |
|---|---|---|---|
pi-webman | 本地零依赖 Web 驾驶舱 | 通过 /web 启动本地网页,提供 SSE 实时流、上下文仪表盘、工具卡片与弹窗桥接 | 想在浏览器双屏实时监控与遥控当前终端 Pi 会话 |
glimpseui | 跨平台原生 WebView 微窗口 | 基于 WKWebView / WebKitGTK / WebView2 的轻量窗口,stdin/stdout 双向 JSON 通信 | 脚本或 Agent 需要弹出原生表单、图表或悬浮伴随小窗(非 Electron) |
@heyhuynhgiabuu/pi-pretty | 终端输出全面美化 | read 语法高亮与内联图、bash 状态着色、树状 ls、微光状态提示与折叠输出 | 留在纯终端工作,想把阅读和工具输出体验一次性升级 |
pi-starline | Starship 风格状态栏与主题 | 提供多段信息状态栏与 OpenCode 风格 TUI 视觉定制 | 想要高信息密度页脚和统一视觉主题 |
pi-tidy | 工具调用自动折叠降噪 | 把长工具输出折叠为可点击单行摘要,仅保留报错、diff 与运行中任务展开 | Agent 连调十几个工具时不想被长输出刷满屏幕 |
@narumitw/pi-statusline | 信息增强页脚状态栏 | 替换默认页脚,集中展示模型、上下文、分支与运行状态 | 偏好极简、只改底部状态栏不改消息渲染 |
@agimon-ai/po-ui | Leader 键菜单与 TUI 组件库 | 为 Po 与 Pi 扩展提供 Leader 键菜单系统、主题与可复用 TUI 组件 | 开发或使用 Po 套件生态时的统一终端组件层 |
看完「09 终端 UI 与体验」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。