pi-lens

在每次写入与回合结束时自动运行 LSP、Linter、类型检查与结构分析,并把阻塞错误直接回注模型。

安装命令
pi install npm:pi-lens
临时试用 / 替代安装命令
pi -e npm:pi-lens
挂接事件钩子与注册入口
session_startresources_discovertool_call(可选 read-before-edit 与 git commit 阻塞门)tool_result(单次写入后回注阻塞错误)turn_end / context / context_with_system(回合末尾注入增量诊断)model_select / session_tree / session_shutdown
pi.registerTool()(lens_diagnostics 等代码导航与状态标记工具)pi.registerCommand("lens-toggle" / "lens-health" / "lens-tdi" / "lens-map" / "lens-tools" / "lens-allow-edit")ctx.ui.setStatus() / notify()

1. 是什么

pi-lens 是 apmantza 开发的实时代码质量反馈扩展,要求 Node.js >= 22.19.0 以及 Pi 0.86.1 或更高版本。

除了 Pi 扩展(./dist/index.js)外,包内还提供 pi-lens / pi-lens-mcp / pi-lens-analyze 等 MCP 命令行工具供其他宿主复用。

2. 解决什么问题

模型改完代码如果不主动跑 tsc、ruff、biome 或 cargo check,经常在回合末尾直接宣布完成,把隐性类型错误或未用变量留给人工或后续 CI 才暴露。

pi-lens 把多语言静态检查前置到每一次编辑工具返回和回合收尾,发现 [阻塞级] 问题就直接在上下文里要求模型修完才能宣告结束。

3. 作用原理(事件钩子与工具注册层)

同时挂接 tool_call、tool_result、turn_end 与 context_with_system,在编辑后即时跑检查管线并将增量/阻塞问题回注提示流。

  • 在 tool_call 阶段可开启 read-before-edit 防止模型盲改未读过的文件,也可启用 git 守卫在仍有阻塞报错时拦截 git commit。
  • 每次文件修改工具完成后,流水线自动调度语言服务器(LSP)、Linter(如 Biome、Ruff)、类型检查与 ast-grep / tree-sitter 结构规则,并沿依赖图对受影响文件做级联检查。
  • 如果发现阻塞问题,直接在 tool_result 中附带带行号的 STOP 提示;回合结束时再通过 turn_end 与 context / context_with_system 把尚未消化的警告与错误(Advisory / delta)注入下一轮上下文。
  • 针对不完整或过时的检查结果会明确标记 partial / stale,避免模型误报“检查已通过”。

4. 怎么装与基本配置

  • 运行 pi install npm:pi-lens;务必确认宿主 Pi 版本 >= 0.86.1(旧版 0.80–0.85 无法向提示写入反馈结果)。
  • 内置语言服务器与部分 Linter 可无配置启动;使用 /lens-health 检查当前项目检测到的分析器状态,用 /lens-toggle 临时开关检查流水线。

5. 和同类怎么选

pi-lens 专注于“边改边检、错误不消化不让收工”的实时静态检查流水线,职责单一明确。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-agent-ide 包含受保护编辑、LSP、终端自动化、DAP 调试器与 Playwright 等完整 IDE 工具面,功能广度更大。 只想在现有编辑流程上加上自动化 LSP/Linter/类型检查门禁,选 pi-lens;需要扩展接入调试器和多终端管理选 pi-agent-ide。
pi-lsp 仅提供声明式 LSP 诊断和符号跳转工具,不包含 ast-grep 规则、自动格式化或 git 提交守卫。 追求最薄的一层纯 LSP 接入时选 pi-lsp。

同方向对比包与顺序阅读

@ff-labs/pi-fff

用 Rust 原生 SIMD 引擎 FFF 替换 Pi 内置 find / grep 与 @ 自动补全,支持常驻预索引和访问频率排序。

阅读该包机制详评

pi-agent-ide

把受保护事务编辑、LSP、AST 搜索、终端进程管理、DAP 调试与可观测能力打包为一体的 Agent IDE 扩展。

阅读该包机制详评

06 代码智能

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「pi-lens」后的下一步

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

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

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

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

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

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

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