PR Lens để trực quan hóa và review pull request

PR Lens là công cụ AI mã nguồn mở để trực quan hóa pull request. Công cụ đọc thay đổi mã cùng ngữ cảnh cần thiết trong repository, tạo sơ đồ kiến trúc và luồng dữ liệu có hoạt ảnh rồi hiển thị ngay trong bình luận GitHub PR. Reviewer có thể nắm bức tranh tổng thể trước khi đọc kỹ các phần Diff quan trọng.

Nói đơn giản, PR Lens dùng để làm gì?

Một pull request lớn buộc người review phải ghi nhớ nhiều tệp, dịch vụ, lời gọi và đường xử lý bị xóa cùng lúc. PR Lens gom chúng thành bản đồ trực quan. Góc nhìn Architecture đánh dấu component được thêm, sửa, xóa và giữ các phần không đổi làm ngữ cảnh. Góc nhìn Data Flow trình bày từng bước theo thứ tự khi thay đổi thực sự có một chuỗi chạy. Đây là lớp hỗ trợ hiểu “PR đã thay đổi toàn hệ thống ra sao”, không phải công cụ tự động tìm bug hay lỗ hổng bảo mật.

Sơ đồ hỗ trợ code review như thế nào?

Component được nhóm thành các lane đại diện cho tầng hoặc ranh giới hệ thống, giúp thấy phạm vi ảnh hưởng thay vì chỉ danh sách tệp. Luồng có hoạt ảnh phù hợp để lần theo endpoint, queue, worker hoặc integration theo thứ tự thực thi. Với thay đổi lớn, Canvas toàn màn hình hỗ trợ zoom, kéo, đổi giao diện sáng-tối và chạy walkthrough theo bước. SVG không chứa JavaScript và được render xác định từ tài liệu có kiểu đã qua kiểm tra.

Chọn GitHub App, Action, CLI hay Agent Skill

GitHub App cần ít cấu hình nhất: chọn repository và App sẽ duy trì một bình luận cho mỗi PR, cập nhật sau mỗi Push. GitHub Action chạy trong CI của bạn với model Key riêng, hỗ trợ Gemini, OpenAI và Endpoint tương thích. CLI cung cấp từng bước cục bộ để phân tích, validate, render, tạo comment và export. Agent Skill dùng model của Coding Agent đang mở để tạo tài liệu graph. Nên chọn App hoặc Action cho một repository để tránh hai bình luận trùng nhau.

Quy trình review thực tế

Cài App hoặc thêm Action rồi mở pull request ở trạng thái sẵn sàng review. Bắt đầu với sơ đồ Architecture để kiểm tra ranh giới bị tác động, component mới và đường bị loại bỏ. Tiếp theo, theo dõi Data Flow và mở Canvas nếu thay đổi rộng. Dùng bản đồ để ưu tiên tệp và đường chạy cần đọc sâu, nhưng vẫn phải xem Diff gốc, kết quả CI và test trường hợp biên. Nếu tên hoặc nhóm sai, hãy thêm sửa đổi bền vững vào .github/pr-lens.yml thay vì chỉnh SVG được tạo.

Chi phí, quyền riêng tư và giới hạn

PR Lens miễn phí cho dự án mã nguồn mở và repository chính dùng giấy phép MIT. Với Action hoặc CLI, bạn chỉ trả chi phí phân tích cho nhà cung cấp model đã chọn; trang chính thức không công bố một mức giá Hosted App có thể xác minh cho repository riêng tư. Hosted App Shallow Clone PR Head vào Sandbox dùng một lần, phân tích bằng Gemini, lưu tài liệu graph và SVG trong Object Storage rồi xóa Sandbox khi chạy xong. Ứng dụng không đặt thời hạn tự xóa cho các Object đó và người có link ảnh có thể truy cập bản render. Với mã nhạy cảm, hãy đọc giải thích chính thức về xử lý và lưu giữ dữ liệu và cân nhắc CLI hoặc Skill chạy cục bộ.

Câu hỏi thường gặp

PR Lens có tìm bug hoặc lỗi bảo mật không?

Không. Công cụ mô tả cấu trúc thay đổi; phát hiện lỗi, Security Scan và đánh giá của con người vẫn là các bước riêng.

Có cần API Key không?

Hosted App không cần Key của bạn. Action và CLI dùng Provider Key riêng; Skill dùng model của Coding Agent hiện có.

Có dùng được với repository riêng tư không?

App có thể chạy trên repository riêng tư được chọn, nhưng đội ngũ cần đánh giá cách lưu trữ và truy cập bằng link. Chế độ cục bộ cho phép kiểm soát tốt hơn.

Điều gì xảy ra sau một Push mới?

App cập nhật Sticky Comment hiện tại bằng sơ đồ của PR Head mới nhất thay vì tạo thêm bình luận.

Tài nguyên chính thức

• Giới thiệu PR Lens và bốn cách chạy
• Cài GitHub App, phạm vi đọc và quyền
• Mã nguồn MIT, cấu hình và Issue