pi-lens
在每次写入与回合结束时自动运行 LSP、Linter、类型检查与结构分析,并把阻塞错误直接回注模型。
pi install npm:pi-lens pi -e npm:pi-lens 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。 |
看完「pi-lens」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。