pi-nvim-bridge

将pi自动补全引擎桥接到Neovim编辑器

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-nvim-bridge。
它的用途是:将pi自动补全引擎桥接到Neovim编辑器
完整的 Skill 内容见:https://321skill.com/skills/pi-nvim-bridge/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我安装 pi-nvim-bridge 并配置 Neovim 连接',AI会先检查是否已安装 pi 引擎,然后执行 npm install -g pi-nvim-bridge,指导用户将桥接启动命令添加到 Neovim 配置中(如 init.vim 或 lazy.nvim),最后测试补全是否正常工作。

介绍

pi-nvim-bridge 解决的是在 Neovim 编辑器中使用 pi 智能自动补全引擎的问题。pi 本身是一个强大的 AI 自动补全工具,但默认需要特定的编辑器支持,而许多开发者更习惯使用 Neovim 进行编码。该工具通过本地 Unix socket 建立连接,让 Neovim 能够实时调用 pi 的补全能力,从而获得流畅、上下文感知的代码建议。

使用方式非常简洁:首先通过 npm 全局安装 pi-nvim-bridge,然后在 Neovim 中配置对应的插件或直接启动桥接进程。启动后,Neovim 会自动与 pi 引擎通信,在编辑代码时实时弹出补全候选,包括函数名、变量、代码片段等。整个过程无需切换编辑器,也无需手动触发,完全融入日常编码流程。

适合主要使用 Neovim 进行开发的程序员,尤其是那些已经熟悉 pi 但希望坚持使用 Neovim 的用户。也适合那些在多个编辑器间切换、希望统一补全体验的开发者。无论是写 Python、TypeScript、React 组件还是后端逻辑,这个桥接工具都能提供智能补全,减少重复输入,提升编码效率。

建议在安装前确保 Neovim 版本较新(0.5+),并且 pi 引擎已正确安装与运行。由于依赖 Unix socket,目前在 Windows 上可能需要额外配置(如 WSL)。如果遇到补全不响应,可以先检查 socket 是否正常监听,或重启桥接进程。对于追求极致性能的用户,可以调整补全延迟和触发字符等参数以匹配个人偏好。

核心特点

与依赖 HTTP 或 WebSocket 的 AI 补全方案不同,pi-nvim-bridge 使用本地 Unix socket 通信,延迟更低、安全性更高,且无需额外网络服务,特别适合离线或内网开发环境。

注意事项

仅支持 Neovim 编辑器,且 pi 引擎必须预先安装并运行;在 Windows 上原生支持有限,建议使用 WSL。

常见问题

pi-nvim-bridge 需要安装 pi 吗?

是的,pi 引擎必须提前安装并启动,该桥接工具只是负责连接 Neovim 和 pi 之间的通信。

如何确认连接是否成功?

启动桥接后,在 Neovim 中输入代码时应该能看到补全提示。也可以检查 /tmp/pi-nvim.sock 文件是否存在(默认路径)来确认 socket 已建立。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-nvim-bridge/raw/index.md 读取 pi-nvim-bridge 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。