pi 里最缺的那个功能,我自己写了个插件补上

终端 AI 效率的真相

真正卡住你的不是 AI，是人和文件之间的三次往返

你让 AI 改代码，它干得又快又漂亮，然后回你一句：

接下来你要做的事，才是真正吃时间的：

找到目录 → 翻到 118 行 → 看完 → 把路径复制回输入框。

AI 干活用了 10 秒，你自己找文件花了 2 分钟。

在终端里用 AI 写代码，真正卡住你节奏的从来不是模型，而是人跟文件之间的三次往返：

我给 pi（终端里的 AI 编程助手）写了个插件，只干一件事：把这三步压成一步。

它叫 pi-file-preview。

以前看一个文件，是一条完整的劳动链：cd 找目录 → cat 整个文件 → 数行号 → 发现数错了再数一遍。

现在，AI 在终端里打印出的每一个文件路径，都是可以点的。

点一下，文件就在右侧面板展开，光标自动定位到它提到的位置，那几行高亮显示。看一眼，按 q 关掉，继续干活。全程不切窗口、不开 IDE、手指不离开键盘。

它为什么知道你关心哪几行？因为 AI 输出的路径通常长这样：

插件会把 :110-149 这段后缀 折叠进链接里——所以你点开的不是一个文件，而是文件里的那 40 行：直接滚动到起点、范围高亮。这是它和普通“打开文件”最本质的区别。

还有 Quick Open：按 Alt+O（或输入 /preview），弹出搜索框，用 fd 边打字边过滤整个工作区，快到不需要犹豫。而且它支持 VSCode 那套写法：

冒号后面带上行号，回车直接跳到第 88 行。

终端里改代码最烦的不是“改”，而是改完之后的那一串动作：退出、找到文件、重新定位、再切回来。

在预览面板里按一下 e，插件会用你自己的编辑器（externalEditor / VISUAL / EDITOR）打开当前文件；你保存，预览自动刷新。想跳到别的位置，按 g 输入行号就行。

整个过程 pi 不用退出，上下文不丢，你也不用在“终端”和“编辑器”两个窗口之间反复横跳。

这一步省的时间最多，也最容易被忽视。

面板开着的时候：

以前你要手打路径、复制粘贴、或者在文件管理器里翻半天；现在看到哪一行，按一下 l，那一行就进了对话。不用记路径、不用拼文件名，看到什么就能立刻引用什么。

这一条是我写这个插件最原始的动机。

当 AI 干活的目录在远程服务器上时，本地编辑器根本打不开那些文件——于是你要 SSH 登录、vim 打开、找行号，来回折腾。

插件会自动识别远程环境（--ssh 参数、PI_SSH_TARGET 环境变量，或项目里的 .pi/ssh.json），然后：

装完重启 pi，或者在当前会话里执行 /reload即刻生效。

先记住这五个键就够用了：

键位不顺手可以全改，写进 ~/.pi/agent/settings.json，/reload 生效：

用 AI 写代码，被浪费掉的从来不是 AI 的思考时间，而是你和代码之间那些来回折腾的几秒钟：一个文件、一次跳转、一次窗口切换。看着不多，一天下来能磨掉你一半的注意力。

这个插件很小，做的事也很单一：让“看一眼代码”这件事，不再需要付出代价。

MIT 协议，开源，欢迎试用、提 Issue、提 PR：

我是 nephen，pi-file-preview 的作者。如果你也在终端里用 AI 写代码，装一个试试，然后告诉我它帮你省了多少时间。

既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。

THANKS FOR READING