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 事件钩子与注册接口

pi.registerMessageRenderer()ctx.ui.setStatus()ctx.ui.setWidget()ctx.ui.custom()message_update / message_endtool_execution_start / endsession_start / session_shutdown

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 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)