06 代码智能

IDE 能力接进终端:LSP 诊断、AST 结构分析、极速检索与调试

1. 这个方向的插件试图解决什么问题

原生的 read/grep/find 只能做纯文本行读取和子进程正则匹配,模型既看不到实时的类型报错和引用关系,每次全局搜索也要反复拉起 fd/rg 进程并消费大量冗余上下文。

没有类型检查与 Linter 实时回流,模型往往要等到最后人工跑构建才发现自己改坏了上游接口签名;而靠纯文本 grep 定位重名符号,也极易漏掉或误改。

这一方向的扩展把语言服务器(LSP)、AST 结构化匹配(ast-grep / tree-sitter)、预索引模糊搜索(FFF)以及调试适配器(DAP)直接塞进终端 Agent 的工具面和回合反馈环里。

2. 在 Pi 里怎么体现

代码智能扩展在 Pi 中主要走两条路径:第一条是拦截 tool_result 和 turn_end(如 pi-lens),每次编辑完文件立刻跑 LSP/Linter/类型检查并将阻塞级错误注回给模型;第二条是通过 pi.registerTool() 与 pi.setActiveTools() 替换内置 find/grep 或新增 LSP 跳转、受保护编辑与 AST 搜索工具(如 @ff-labs/pi-fff、pi-agent-ide)。

涉及的 Pi 事件钩子与注册接口

tool_result(回注诊断)turn_end / contextpi.registerTool()pi.setActiveTools()session_start(预索引/起 LSP)ui.addAutocompleteProvider()

3. 代表包与生态实例

下表包名均核实自 npm、GitHub 与 pi.dev/packages(核对日期 2026-11-22)。前 3 项已上线独立机制详评页,正文不展示容易过期的静态下载量快照。

包名 分发形态 主要作用 详情 / 源码
pi-lens npm 在代码编辑与回合结束时自动运行 LSP、Linter、格式化、类型检查与结构分析,并向模型回注阻塞级问题。
pi-agent-ide npm 为 Pi 提供受保护编辑、代码搜索、LSP、终端管理、DAP 调试与观测的一体化 IDE 扩展。
@ff-labs/pi-fff npm 使用 Rust 原生 SIMD 搜索引擎 FFF 替换内置 find、grep 及 @ 自动补全,支持基于访问频率(frecency)排序。
pi-lsp npm 声明式 Pi 扩展,提供轻量级的 LSP 诊断与语言服务器符号导航工具。
pi-ast-grep npm 向 Pi 注册基于 ast-grep 的只读语法树结构搜索工具。

4. 怎么装

代表包安装命令示例
pi install npm:pi-lens
  • Pi 扩展对同一内置工具名(如 find/grep)是排他接管的,如果同时加载 @ff-labs/pi-fff 和自带 FFF 接管的 UI 包(如 @heyhuynhgiabuu/pi-pretty 的 FFF 模式),需注意避免重复接管冲突。
  • pi-lens 要求 Pi 0.86.1+(Node.js >= 22.19.0)以支持把诊断结果写入上下文提示。
  • LSP 类扩展依赖本地语言服务器(如 typescript-language-server、pyright、rust-analyzer),未安装的语言会自动跳过或降级。

5. 和同类怎么选

包名核心定位内置主要能力适用场景
pi-lens 编辑即反馈的实时代码诊断 LSP、Linter、格式化、类型检查、ast-grep 规则与变更影响级联检查 希望模型每改一个文件就自动拿到类型/Lint 报错并修完再收工
pi-agent-ide Agent 原生一体化 IDE 扩展 受保护编辑、LSP、AST 搜索、终端管理、DAP 调试与可观测性 需要把编辑、终端、调试器和静态分析打包接进一个扩展
@ff-labs/pi-fff Rust 原生 FFF 极速文件与内容搜索 用内存预索引与 SIMD 检索替换 find/grep 与 @ 文件补全 大型仓库高频搜索,想消除每次调用 fd/rg 子进程的延迟
pi-lsp 声明式轻量 LSP 导航与诊断 只暴露标准 LSP 诊断与符号导航工具,配置声明化 只需要干净的 LSP 能力,不想要重型打包方案
pi-ast-grep 只读 AST 结构化搜索 基于 ast-grep 按语法树模式匹配代码结构 按语法结构精准查找特定调用模式,减少正则误匹配

看完「06 代码智能」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)