Understand Anything - biến cả kho code thành một tấm bản đồ bấm vào là hiểu (hơn 80.000 sao GitHub)
Bạn vừa nhận một dự án 200.000 dòng code của người khác. Mở lên, không biết bắt đầu từ đâu.
Có một kho mã nguồn mở tên Understand Anything giải đúng chuyện đó. Nó quét toàn bộ dự án rồi dựng ra một knowledge graph (đồ thị tri thức - hiểu nôm na là tấm bản đồ, mỗi file, mỗi hàm, mỗi lớp là một điểm, các đường nối cho thấy cái nào liên quan tới cái nào). Bấm vào bất kỳ điểm nào, nó giải thích bằng tiếng người: phần này để làm gì, liên quan tới ai.
Vài thứ mình thấy đáng chú ý:
1/ Không chỉ vẽ sơ đồ, mà còn trả lời. Gõ
/understand-chat luồng thanh toán chạy thế nào? và nó trả lời dựa trên chính tấm bản đồ vừa dựng. Có cả lệnh xem một thay đổi của bạn sẽ ảnh hưởng tới những phần nào trước khi commit.2/ Có lệnh riêng để làm tài liệu nhập môn.
/understand-onboard sinh ra hướng dẫn cho người mới vào đội. Ngoài ra bản thân đồ thị đi kèm những "tour" tự sinh, xếp theo đúng thứ tự phụ thuộc - học từ móng lên nóc chứ không nhảy cóc.3/ Đồ thị chỉ là một file JSON, commit vào repo là xong. Đồng đội mở ra xem được mà không cần Claude Code, không cần khóa API, không gọi tới mô hình nào cả - chỉ cần Node.js (từ bản 18 trở lên). Repo ghi rõ mọi thứ đọc từ ổ đĩa máy bạn, dữ liệu không rời khỏi máy.
4/ Không khóa vào một công cụ. Repo ghi rõ chạy được với Claude Code, Cursor, Codex, Copilot, Gemini CLI, OpenCode, Trae, Kiro và nhiều nền tảng khác.
5/ Đọc code bằng cả máy lẫn mô hình. Phần cấu trúc do Tree-sitter (bộ phân tích cú pháp) bóc ra nên chạy lại bao nhiêu lần cũng ra kết quả y hệt; phần diễn giải "file này để làm gì" mới giao cho mô hình.
Một lưu ý: repo tự ghi rõ lần quét đầu tiên trên dự án lớn tốn kha khá token, nên chạy khi đang có gói thuê bao hoặc dùng mô hình chạy tại máy. Những lần sau chỉ quét lại file đã đổi nên nhẹ hơn nhiều.
Câu mình thích nhất trong repo: mục tiêu không phải một đồ thị làm bạn choáng vì kho code phức tạp cỡ nào, mà là một đồ thị lặng lẽ dạy bạn từng mảnh ghép khớp vào nhau ra sao.
Trang chủ có sẵn một bản demo xem thẳng trên trình duyệt, kéo thả và tìm kiếm thử được ngay.
Bạn nào sắp phải nhảy vào một kho code lạ thì lưu bài này lại.
Đăng nhận xét