Open Code Review: Công cụ dòng lệnh AI hỗ trợ kiểm duyệt mã nguồn tự động

OpenCodeReview

English | | | 한국어 | Русский

Open Code Review là gì?

Open Code Review là một công cụ CLI hỗ trợ review code bằng AI. Công cụ này bắt nguồn từ trợ lý AI review code nội bộ chính thức của Alibaba Group — trong hai năm qua, nó đã phục vụ hàng chục nghìn lập trình viên và phát hiện hàng triệu lỗi code. Sau khi được kiểm chứng kỹ lưỡng ở quy mô lớn, chúng tôi đã phát triển nó thành một dự án mã nguồn mở cho cộng đồng. Chỉ cần cấu hình một model endpoint là bạn có thể bắt đầu sử dụng.

Công cụ này đọc các Git diff, gửi các tệp đã thay đổi đến một LLM có thể cấu hình thông qua một agent có khả năng sử dụng công cụ, và tạo ra các nhận xét review có cấu trúc với độ chính xác đến từng dòng. Agent có thể đọc toàn bộ nội dung tệp, tìm kiếm trong codebase, kiểm tra các tệp đã thay đổi khác để lấy ngữ cảnh và đưa ra các đánh giá chuyên sâu — không chỉ là phản hồi trên bề mặt diff. Ngoài việc review diff, ocr scan còn review toàn bộ tệp để kiểm tra các codebase lạ hoặc các thư mục không có diff đáng kể.

Truy cập trang web chính thức để biết thêm chi tiết.

Benchmark

So với các agent đa năng (Claude Code), Open Code Review đạt được độ Precision và F1 cao hơn đáng kể với cùng một model nền tảng, trong khi chỉ tiêu tốn khoảng 1/9 lượng token và hoàn thành việc review nhanh hơn. Lưu ý rằng Recall của nó thấp hơn so với các agent đa năng — đây là một sự đánh đổi có chủ đích nhằm ưu tiên độ chính xác thay vì nhiễu thông tin.

Một benchmark review code thực tế được xây dựng từ 50 kho lưu trữ mã nguồn mở phổ biến, 200 Pull Request thực tế và 10 ngôn ngữ lập trình — được kiểm chứng chéo bởi hơn 80 kỹ sư cấp cao (1.505 vấn đề ground-truth đã được chú giải).

Vấn đề với các Agent đa năng

Nếu bạn đã từng sử dụng các agent đa năng như Claude Code với Skills để review code, có lẽ bạn đã gặp phải những điểm đau (pain points) sau:

Nguyên nhân gốc rễ: kiến trúc thuần túy dựa trên ngôn ngữ thiếu các ràng buộc cứng đối với quy trình review.

Thiết kế cốt lõi: Kết hợp giữa Kỹ thuật tất định (Deterministic Engineering) × Agent

Triết lý cốt lõi của Open Code Review là kết hợp kỹ thuật tất định với một agent, mỗi bên xử lý những gì chúng làm tốt nhất.

Kỹ thuật tất định — Các ràng buộc cứng

Đối với các bước review không được phép sai sót, logic kỹ thuật — chứ không phải mô hình ngôn ngữ — sẽ đảm bảo tính chính xác:

Agent — Ra quyết định linh hoạt

Thế mạnh của agent tập trung vào những nơi quan trọng nhất — ra quyết định linh hoạt và truy xuất ngữ cảnh động:

Cách sử dụng

Điều kiện tiên quyết

CLI

Cài đặt

Qua NPM (Khuyên dùng)

Sau khi cài đặt, lệnh ocr sẽ khả dụng trên toàn hệ thống.

Từ GitHub Release

Cài đặt binary mới nhất cho hệ điều hành/kiến trúc của bạn bằng một lệnh duy nhất (macOS / Linux):

Tập lệnh sẽ chọn đúng binary phát hành, xác minh mã kiểm tra SHA-256 và cài đặt nó dưới dạng ocr trong /usr/local/bin. Ghi đè mục tiêu bằng OCR_INSTALL_DIR hoặc ghim một phiên bản phát hành bằng OCR_VERSION:

Tải xuống binary cho nền tảng của bạn từ GitHub Releases:

Từ mã nguồn

Bắt đầu nhanh

1. Cấu hình LLM

Bạn phải cấu hình LLM trước khi review code.

OCR quản lý cấu hình LLM thông qua hệ thống Provider thống nhất. Nó đi kèm với nhiều provider tích hợp sẵn phổ biến và cũng hỗ trợ thêm các provider tùy chỉnh để kết nối với các triển khai riêng hoặc các endpoint tương thích khác. Cấu hình được lưu trữ tại ~/.opencodereview/config.json.

Lựa chọn A: Thiết lập tương tác (Khuyên dùng)