$ cat ~/map/pi-conversation-outline.md

pi-conversation-outline

全屏对话区右侧的只读大纲轨：每轮提问一根刻度，悬停预览，点击跳回原提问。

extensions✓ 9月18日

运行 pi install npm:pi-conversation-outline（或 pi install git:github.com/youxia-2025/pi-conversation-outline）；需要 tuiMode fullscreen（pi 当前默认已是），装完 /reload 或新开会话

## 速览

pi 全屏 TUI 的只读大纲轨：右缘每轮提问一根刻度，悬停预览问题，点击跳到那一轮；对话本身不会被回退、分叉或改动。

## 要点

• $全程只读：大纲轨只渲染当前根到叶的会话分支，不回退、不分叉、不改上下文；预览只显示每条提问的首行，不含工具轨迹与思考过程。
• $导航方式：每轮提问一根刻度、按对话顺序排列（不是滚动比例），当前视口顶部那一轮高亮，上下方向键在轮次间跳转，悬停显示预览，点击跳到该条提问，Ctrl+Alt+O 显示或隐藏大纲轨。
• $出现条件：全屏模式（pi 当前默认）下、终端宽度至少 60 列且有两轮以上提问时，大纲轨才会出现；regular 模式没有应用内鼠标，轨道不出现。
• $坦诚的兼容性警告：扩展会触碰 pi TUI 的未公开结构——对话 ScrollView、gutter 与 nonCapturing overlay——因此 pi 大版本更新后可能失效；失效表现是轨道消失或跳转不准，文档给出的出路是 pi remove npm:pi-conversation-outline。
• $与工具卡扩展共存：若同时装着会改 hasOverlay 或折叠卡点击的 Claude Code 风格工具卡扩展，大纲轨会把 hasOverlay 收窄为抢输入的 overlay 并挡住原生单击 toggle，避免两者抢鼠标；没有这类扩展时这些补丁是空操作。
• $开发方式：npm test 覆盖扩展逻辑，pi -e ./extensions/index.ts 可在本地试跑且不写入设置。

## 常见问题

## 参考链接

• README ↗

最后更新: 2026年9月18日