$ cat ~/map/pi-open-tui.md
pi-open-tui
为 pi 精心打磨的终端界面——模型与思考级别头部、运行时感知的页脚、带边框的编辑器、本轮统计(TPS / TTFT / 卡顿 / 成本),以及 50 多种运行时探测;全部可通过 /open-tui 配置。
extensions✓ 10月16日
事实速查
- GitHub Stars
- ★ 111
- Forks
- 31
- 许可证
- MIT
- npm / 月
- —
- 最后推送
- 2026年10月2日
安装
pi install npm:pi-open-tui## 速览
为 pi 打造的精致终端界面扩展——可配置的头部与页脚,识别 50 多种运行时并细致展示 Git 状态,附带每轮遥测和中英双语的 /open-tui 设置面板。
## 要点
- $头部显示模型、思考档位、工作目录和常用斜杠命令提示;自适应页脚显示 Git 状态、检测到的运行时、上下文占用、token 数、成本与扩展状态。
- $识别 50 多种运行时,Git 状态细致到 ahead/behind、已暂存、已修改、未跟踪、stash 和 detached HEAD。
- $每轮遥测报告 TPS、首 token 时间(TTFT)、时长、卡顿、token 数与牌价费率;TPS 由 provider 上报的输出 token 除以总生成时间得出,轮间工具执行时间不计入。
- $通过 /open-tui 打开交互设置,分常规、外观、页脚、遥测四个标签页——涵盖 cursorStyle(block、bar、underline)、icons.mode(auto、nerd、ascii)、页脚段落与遥测开关,配置存于 ~/.pi/agent/open-tui.json。
- $内置 ASCII 图标,Nerd Font 可选;全屏滚轮速度设置带版本守卫的兼容垫片,运行时字段不存在时自动回退 pi 默认滚动。
- $要求 pi 0.80 或更高版本,以及支持 UTF-8 与颜色的终端;可用 pi -e npm:pi-open-tui 单次会话试用。
- $集 pi-haiku、pi-claude-code-tui、pi-zentui、pi-tps 众家之长,logo 帧取自 pi 官方安装脚本。
## 常见问题
Q 不安装能先试用吗?
运行 pi -e npm:pi-open-tui 即可在单次会话中加载;pi install npm:pi-open-tui 则是正式安装。
Q 图标显示成方框怎么办?
安装 Nerd Font 并在终端配置文件里选中它(VS Code、Windows Terminal 这类应用要改终端配置而非只装到系统),再到 /open-tui 把 icons.mode 设为 nerd;或改用 ascii 模式,完全不需要补丁字体。默认 auto 检测的是终端环境而非已安装的字体文件。
Q 设置存在哪里?
在 ~/.pi/agent/open-tui.json,通过 /open-tui 面板修改;settingsLanguage 可在 en 与 zh 之间切换面板语言。
## 参考链接
## 相关条目
最后更新: 2026年8月31日