Giới Thiệu
code-review-graph giúp giải quyết vấn đề Claude Code phải đọc lại toàn bộ mã nguồn mỗi khi thực hiện các nhiệm vụ. Công cụ này xây dựng một bản đồ cấu trúc mã bằng Tree-sitter, theo dõi các thay đổi và cung cấp ngữ cảnh chính xác cho Claude.
Biện pháp này đã được kiểm nghiệm trên ba dự án nguồn mở lớn với kết quả giảm 6.8 lần token cho kiểm tra mã và đến 49 lần cho các tác vụ hàng ngày.
Cài Đặt
Plugin Claude Code (khuyến nghị)
claude plugin add tirth8205/code-review-graphPip
pip install code-review-graph
code-review-graph installKhởi động lại Claude Code sau khi cài đặt. Yêu cầu Python 3.10+ và uv.
Bắt Đầu
Mở dự án của bạn trong Claude Code và chạy:
Build the code review graph for this projectQuá trình xây dựng ban đầu mất khoảng 10 giây cho dự án 500 file. Sau đó, đồ thị sẽ tự động cập nhật mỗi khi có chỉnh sửa file hoặc commit git.
Cách Hoạt Động
Đồ thị này lập bản đồ cho mọi hàm, lớp, nhập, gọi, quan hệ kế thừa và kiểm tra trong mã nguồn của bạn. Khi yêu cầu Claude kiểm tra mã hoặc thực hiện thay đổi, nó sẽ truy vấn đồ thị trước để xác định những gì đã thay đổi và chỉ đọc các file có liên quan.
Benchmark
Kiểm Tra Mã: Giảm 6.8 lần Token
Được thử nghiệm trên 6 commit git thực tế. Đồ thị thay thế việc đọc toàn bộ các file nguồn bằng một tóm tắt cấu trúc.
| Repo | Số File | Cách Tiêu Chuẩn | Với Đồ Thị | Giảm | Chất Lượng |
|---|---|---|---|---|---|
| httpx | 125 | 12,507 | 458 | 26.2x | 9.0 vs 7.0 |
| FastAPI | 2,915 | 5,495 | 871 | 8.1x | 8.5 vs 7.5 |
| Next.js | 27,732 | 21,614 | 4,457 | 6.0x | 9.0 vs 7.0 |
| Trung Bình | 13,205 | 1,928 | 6.8x | 8.8 vs 7.2 |
Tác Vụ Mã Trực Tiếp: Trung Bình 14.1x, Đỉnh 49x
Được kiểm tra với 6 tác vụ mã hóa thực tế trên cùng các repo.
| Tác Vụ | Repo | Với Đồ Thị | Không Đồ Thị | Giảm | File Bỏ Qua |
|---|---|---|---|---|---|
| Add rate limiter | httpx | 14,090 | 64,666 | 4.6x | 58 |
| Fix streaming bug | httpx | 14,090 | 64,666 | 4.6x | 59 |
| Add rate limiter | FastAPI | 37,217 | 138,585 | 3.7x | 1,120 |
| Fix streaming bug | FastAPI | 36,986 | 138,585 | 3.7x | 1,121 |
| Add rate limiter | Next.js | 15,049 | 739,352 | 49.1x | ~16,000 |
| Fix streaming bug | Next.js | 16,135 | 739,352 | 45.8x | ~16,000 |
Sử Dụng
Slash Commands
| Lệnh | Mô Tả |
|---|---|
/code-review-graph:build-graph | Xây dựng hoặc xây dựng lại đồ thị mã |
/code-review-graph:review-delta | Kiểm tra các thay đổi kể từ commit cuối |
/code-review-graph:review-pr | Kiểm tra PR đầy đủ với phân tích blast-radius |
CLI
code-review-graph install
code-review-graph build
code-review-graph update
code-review-graph status
code-review-graph watch
code-review-graph visualize
code-review-graph serveCác Công Cụ MCP
Claude tự động sử dụng những công cụ này sau khi đồ thị được xây dựng.
| Công Cụ | Mô Tả |
|---|---|
build_or_update_graph_tool | Xây dựng hoặc cập nhật đồ thị |
get_impact_radius_tool | Xác định blast radius của file thay đổi |
get_review_context_tool | Ngữ cảnh kiểm tra tối ưu bằng token |
query_graph_tool | Truy vấn hàm gọi, kiểm thử, nhập, kế thừa |
semantic_search_nodes_tool | Tìm kiếm mã theo tên hoặc ý nghĩa |
embed_graph_tool | Tính vector nhúng cho tìm kiếm ngữ nghĩa |
list_graph_stats_tool | Thống kê đồ thị |
get_docs_section_tool | Lấy phần tài liệu |
Tính Năng
| Tính Năng | Chi Tiết |
|---|---|
| Cập nhật gia tăng | Chỉ phân tích lại các file thay đổi. Cập nhật sau hoàn thành dưới 2 giây. |
| 12 ngôn ngữ | Hỗ trợ nhiều ngôn ngữ lập trình phổ biến |
| Phân tích blast-radius | Hiển thị chính xác chức năng, lớp và file bị ảnh hưởng |
| Tự động cập nhật | Đồ thị tự cập nhật mỗi khi chỉnh sửa hoặc commit file |
| Tìm kiếm ngữ nghĩa | Tùy chọn vector nhúng thông qua sentence-transformers |
| Hình ảnh tương tác | Biểu đồ lực với D3.js |
| Lưu trữ cục bộ | File SQLite trong .code-review-graph/ |
| Chế độ xem | Cập nhật đồ thị liên tục khi làm việc |
Cấu Hình
Để loại bỏ các đường dẫn khỏi chỉ mục, hãy tạo file .code-review-graphignore:
generated/**
*.generated.ts
vendor/**
node_modules/**Với tìm kiếm ngữ nghĩa, cài đặt phụ thuộc nhúng tùy chọn:
pip install code-review-graph[embeddings]Đóng Góp
git clone https://github.com/tirth8205/code-review-graph.git
cd code-review-graph
python3 -m venv .venv && source .venv/bin/activate
pip install -e "[dev]"
pytestĐể thêm ngôn ngữ mới, sửa code_review_graph/parser.py và mở PR.
Bản Quyền
MIT. Xem LICENSE.
pip install code-review-graph && code-review-graph install