PR Lens AI Pull Request 可视化与代码审查指南

PR Lens 是一款开源的 AI Pull Request 可视化工具。它读取代码改动及必要的仓库上下文，把 PR 转换为动画架构图和数据流图，并直接放进 GitHub 的 Pull Request 评论中，帮助开发者先建立整体理解，再聚焦真正需要细读的 Diff。

通俗易懂地说，PR Lens 是干什么用的？

一个大型 PR 可能同时修改多份文件、多个服务和若干调用路径。传统文件列表告诉你“改了哪里”，却不一定说明这些部分如何连接。PR Lens 会把新增、修改、删除和作为上下文保留的组件画在同一张图里；如果改动存在明确的运行顺序，还会用动画数据流逐步展示。它解决的是“这个 PR 整体改变了什么”这一理解问题，并不是自动找 Bug 或安全漏洞的代码扫描器。

两种视角怎样帮助代码审查

架构视角会把组件按系统层级或边界分到不同泳道，并保留未修改但相关的邻近组件，方便 Reviewer 判断潜在影响范围。数据流视角适合追踪 API、队列、Worker 或第三方集成的执行顺序。对于较大的改动，可以打开全尺寸 Canvas 进行缩放、拖动、切换明暗主题，并播放分步讲解。渲染结果是无 JavaScript 的 SVG；同一个通过 Schema 校验的图文档会得到确定性的输出。

GitHub App、Action、CLI 与 Agent Skill 怎么选

GitHub App 最省配置：选择要授权的仓库后，它会为每个 PR 维护一条评论，并在每次 Push 后更新。GitHub Action 在你自己的 CI 中运行，使用自己的模型 Key，可连接 Gemini、OpenAI 或兼容接口。CLI 把分析、校验、渲染、生成评论和导出拆成可控的本地命令。Agent Skill 则让已经打开的 Coding Agent 直接生成图文档，无需再配置第二套模型。一个仓库应在 App 与 Action 中二选一，避免出现两条重复评论。

一次真实的 PR 审查流程

先安装 App 或配置 Action，再打开处于 Ready for review 状态的 Pull Request。第一步查看架构图，确认新增组件、修改边界和删除路径；第二步查看数据流，沿执行顺序检查关键调用；改动较大时再打开 Canvas。随后根据图中影响范围决定哪些文件需要深入阅读，同时继续检查原始 Diff、CI 结果和边界测试。若组件名称、分组或排除项不准确，应把修正规则写进 .github/pr-lens.yml，不要手工改生成的 SVG，因为下一次 Push 会重新生成。

费用、隐私与使用边界

PR Lens 对开源项目免费，官方仓库采用 MIT 许可证。使用 Action 或 CLI 时，分析调用的费用由你向所选模型服务商支付；官网没有公布可核实的私有仓库 Hosted App 统一价格。Hosted App 会把 PR Head 以浅克隆方式放入一次性沙箱，使用 Gemini 分析，把图文档和渲染图片存入对象存储，并在任务结束后删除沙箱。官方同时说明，已存储对象没有由应用设置自动过期时间，持有渲染图链接的人可能访问该图片。处理敏感代码前应阅读官方数据处理与保留说明，不符合团队策略时可选择本地 CLI 或 Agent Skill。

常见问题

PR Lens 会自动发现 Bug 或安全问题吗？

不会。它只解释代码改动的结构与路径；缺陷检测、安全扫描和人工判断仍需单独完成。

使用 PR Lens 必须提供 API Key 吗？

Hosted App 不需要用户提供 Key。Action 和 CLI 使用你自己的模型服务商 Key；Agent Skill 复用当前 Coding Agent 的模型。

PR Lens 能用于私有仓库吗？

Hosted App 可安装到用户选择的私有仓库，但团队应先评估对象存储和链接访问机制。需要更强数据控制时，应优先考虑本地模式。

再次 Push 后图会怎样更新？

GitHub App 会改写原有的 Sticky Comment，展示最新 PR Head 对应的图，而不是不断新增评论。

官方资源与开发者社区

• PR Lens 是什么：产品范围与四种运行方式
• GitHub App 安装、读取范围与写入权限
• MIT 开源仓库、配置文档与 Issue