Làm Thế Nào Để Hiểu Nhanh Một Dự Án Mới Mà Không Cần Đọc Từng Dòng Code?

Giới thiệu chi tiết về Understand Anything

Understand Anything là một công cụ mạnh mẽ giúp chuyển đổi bất kỳ mã nguồn, cơ sở tri thức hoặc tài liệu nào thành một sơ đồ tri thức (knowledge graph) có tính tương tác cao. Thay vì phải đọc hàng trăm ngàn dòng code một cách thụ động, công cụ này cho phép bạn khám phá, tìm kiếm và đặt câu hỏi trực tiếp về kiến trúc của hệ thống.

Công cụ này đặc biệt hữu ích khi bạn mới gia nhập một dự án lớn, giúp bạn ngừng việc "đọc mù" mã nguồn và bắt đầu nhìn thấy bức tranh tổng thể một cách rõ ràng nhất.

Các tính năng cốt lõi:

• Khám phá sơ đồ cấu trúc: Điều hướng dự án dưới dạng sơ đồ tương tác. Mỗi tệp, hàm, và lớp là một nút. Nhấp vào để xem tóm tắt bằng ngôn ngữ tự nhiên và các mối quan hệ.

• Hiểu logic nghiệp vụ: Cung cấp góc nhìn về cách mã nguồn ánh xạ tới các quy trình nghiệp vụ thực tế (domain, flow, steps).

• Hướng dẫn từng bước: Tự động tạo các lộ trình hướng dẫn để bạn học mã nguồn theo đúng thứ tự phụ thuộc.

• Tìm kiếm ngữ nghĩa và mờ: Tìm kiếm thông tin theo tên hoặc theo ý nghĩa (ví dụ: gõ "phần nào xử lý xác thực" để nhận kết quả liên quan trên toàn sơ đồ).

• Phân tích tác động (Diff Impact): Xem những phần nào của hệ thống sẽ bị ảnh hưởng bởi đoạn code bạn vừa thay đổi trước khi commit.

• Cơ chế hoạt động: Kết hợp sức mạnh của phân tích tĩnh (Tree-sitter) để bóc tách cấu trúc chính xác (imports, exports, định nghĩa) và trí tuệ nhân tạo (LLMs) để hiểu ngữ nghĩa, tạo tóm tắt và phân lớp kiến trúc.

---

Hướng dẫn sử dụng từng bước

Công cụ này hỗ trợ đa nền tảng (Claude Code, Cursor, Copilot, Gemini CLI, v.v.). Dưới đây là quy trình thao tác chung nhất:

Bước 1: Cài đặt Plugin Tùy thuộc vào nền tảng bạn đang sử dụng mà lệnh cài đặt sẽ khác nhau.

• Nếu dùng Claude Code: Bạn nhập hai lệnh sau vào terminal: /plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything

• Nếu dùng các trình biên dịch khác (như Cursor hay VS Code + Copilot), plugin có tính năng tự động khám phá khi bạn clone kho lưu trữ về. Bạn cũng có thể dùng lệnh cài đặt một dòng có sẵn trong tài liệu dự án để tạo các liên kết hệ thống cho nền tảng cụ thể.

Bước 2: Quét và phân tích dự án Mở terminal tại thư mục gốc của dự án bạn cần phân tích và nhập lệnh: /understand

• Lúc này, một hệ thống đa tác nhân (multi-agent) sẽ hoạt động. Nó sẽ quét toàn bộ dự án, trích xuất cấu trúc và xây dựng một sơ đồ tri thức (được lưu tự động vào tệp dạng JSON ở thư mục ẩn .understand-anything).

• Lưu ý: Quá trình này có hỗ trợ cập nhật tăng dần, nghĩa là ở các lần chạy sau, nó chỉ phân tích lại những tệp đã bị thay đổi để tiết kiệm thời gian.

Bước 3: Mở bảng điều khiển tương tác (Dashboard) Sau khi quá trình quét hoàn tất, bạn mở giao diện trực quan bằng lệnh: /understand-dashboard

• Một giao diện web sẽ hiện ra trên trình duyệt. Tại đây, dự án của bạn được hiển thị dưới dạng một sơ đồ lớn, được phân loại bằng màu sắc theo các lớp kiến trúc (API, Service, Data, UI, v.v.).

• Bạn có thể phóng to, thu nhỏ, tìm kiếm và nhấp vào bất kỳ điểm nào để xem mã nguồn cũng như lời giải thích bằng tiếng Anh (hoặc ngôn ngữ khác nếu bạn đã thiết lập).

Bước 4: Sử dụng các tính năng nâng cao Để hiểu sâu hơn về mã nguồn, bạn có thể tiếp tục sử dụng các lệnh tương tác sau trong terminal:

• Đặt câu hỏi trực tiếp về code: /understand-chat [câu hỏi của bạn] (ví dụ: Luồng thanh toán hoạt động như thế nào?).

• Phân tích chi tiết một tệp cụ thể: /understand-explain [đường_dẫn_tệp]

• Trích xuất kiến thức về logic nghiệp vụ: /understand-domain

• Phân tích những tệp code bạn đang sửa để xem mức độ ảnh hưởng: /understand-diff

• Tự động tạo tài liệu hướng dẫn cho người mới vào dự án: /understand-onboard

Bước 5: Đồng bộ cùng đội ngũ Bản chất của sơ đồ tri thức sinh ra chỉ là các tệp JSON. Bạn có thể commit các tệp cấu trúc này lên Git (ngoại trừ thư mục nháp intermediate/ và tệp diff-overlay.json). Khi đó, những thành viên khác trong đội ngũ chỉ cần pull code về là có thể xem ngay sơ đồ mà không phải chạy lại toàn bộ quá trình phân tích từ đầu.