$ cat ~/map/pi-reverse.md

pi-reverse

全屏 TUI 布局扩展：输入框固定在顶部，问答对最新在前，问题始终留在视野内。

extensions✓ 9月14日

事实速查

安装

pi install git:github.com/panbergco/pi-reverse（需全屏 TUI 模式：在 ~/.pi/agent/settings.json 设置 tuiMode fullscreen，或运行 pi --tui-mode fullscreen）

## 速览

全屏 TUI 布局扩展：把 pi 的输入框固定在顶部，对话按问答对堆叠、最新在前，每一对仍按先问后答的自然顺序阅读。

$名字取自 Warp 面向命令块的 reverse mode；README 自称这是 agent 对话里的第一个此类布局，并提到 VS Code 把 Copilot Chat 的同类请求以超出范围为由关闭（issue #12321，2025 年 12 月）。
$以轮为单位：每个轮次从用户提问开始，扩展只反转轮次分组、从不反转组内内容，因此每个问题仍顺着读进它的回答；长回答默认占窗格 70%（answer-lines），自带内部滚动。
$分区滚轮导航：原生 pi 上右半屏滚动整个对话，左半屏在单个回答内的滚轮滚动则需要打过补丁的 pi（一个小型 ScrollView 补丁，修复尚待上游合入）；alt+j / alt+k 在问答对之间跳转，/reverse next、/reverse prev、/reverse tail、/reverse question、/reverse flip 与 /reverse reset 同样可用。
$仅改显示：绝不修改会话文件，旧会话经 pi --session 打开同样套用这一布局；普通（非全屏）TUI 模式下扩展会打印警告并拒绝不完整地应用。
$性能：屏外轮次保留上次渲染的行、接近视口才重新渲染；实测 1,165 组件的会话上滚轮到重绘中位数为 25-28 毫秒（同转录下原生 pi 为 45-73 毫秒），每帧开销与屏幕而非会话长度成比例。
$已知边界：依赖 pi 内部结构（七个挂载区域与作为轮次标记的 UserMessageComponent），pi 发布改变该形状时会拒绝应用并打印警告；已在 pi 0.84.2 与 0.85.1 上验证。

Q pi-reverse 会改变会话的存储吗？

不会——它只改渲染。会话文件从不被修改，纯属显示层；用 pi --session 重开旧转录时同样套用这一布局。

Q 非全屏 TUI 模式下会怎样？

普通模式渲染进终端自身的回滚缓冲区，而回滚区只会在底部增长——没有任何扩展能在那里钉住顶行，因此 pi-reverse 会打印警告并拒绝应用，而不是在不满足前提时硬套。