Understand Anything

Biến mọi codebase, cơ sở tri thức hay tài liệu thành đồ thị tri thức tương tác bạn có thể khám phá, tìm kiếm và đặt câu hỏi.
Hoạt động với Claude Code, Codex, Cursor, Copilot, Gemini CLI, và nhiều hơn nữa.

Understand Anything. Understand Anyone.
AI nên giúp con người, không phải thay thế họ.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Tiếng Việt

` được hỗ trợ: `gemini`, `codex`, `opencode`, `pi`, `openclaw`, `antigravity`, `vibe`, `vscode`, `hermes`, `cline`, `kimi`, `trae`, `nanobot`, `kiro` - Cập nhật sau: - macOS / Linux: `./install.sh --update` - Windows: `& "$HOME/.understand-anything/repo/install.ps1" -Update` - Gỡ cài đặt: - macOS / Linux: `./install.sh --uninstall ` - Windows: `& "$HOME/.understand-anything/repo/install.ps1" -Uninstall ` ### Cursor Cursor tự động phát hiện plugin qua `.cursor-plugin/plugin.json` khi repo này được clone. Không cần cài đặt thủ công — chỉ cần clone và mở trong Cursor. Nếu tự động phát hiện không hoạt động, hãy cài đặt thủ công: mở **Cursor Settings → Plugins**, dán `https://github.com/Egonex-AI/Understand-Anything` vào ô tìm kiếm và thêm từ đó. ### VS Code + GitHub Copilot VS Code với GitHub Copilot (v1.108+) tự động phát hiện plugin qua `.copilot-plugin/plugin.json` khi repo này được clone. Không cần cài đặt thủ công — chỉ cần clone và mở trong VS Code. Để sử dụng skill cá nhân (khả dụng trên mọi dự án), chạy `install.sh` ở trên với nền tảng `vscode`. ### Copilot CLI ```bash copilot plugin install Egonex-AI/Understand-Anything:understand-anything-plugin ``` ### Kiro CLI / IDE ```bash curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s kiro ``` Sau khi cài đặt: - **Kiro CLI**: `kiro-cli chat --agent understand "Analyze this project"` - **Kiro IDE**: các skill được symlink vào `~/.kiro/skills/` và agent `understand` được ghi vào `~/.kiro/agents/understand.json`, nên cả hai đều khả dụng sau khi khởi động lại IDE. Để sử dụng skill cá nhân (khả dụng trên mọi dự án), chạy `install.sh` ở trên với nền tảng `kiro`. ### Tương thích nền tảng | Nền tảng | Trạng thái | Phương thức cài đặt | |----------|------------|---------------------| | Claude Code | ✅ Bản địa | Plugin marketplace | | Cursor | ✅ Hỗ trợ | Tự động phát hiện | | VS Code + GitHub Copilot | ✅ Hỗ trợ | Tự động phát hiện | | Copilot CLI | ✅ Hỗ trợ | Plugin install | | Codex | ✅ Hỗ trợ | `install.sh codex` | | OpenCode | ✅ Hỗ trợ | `install.sh opencode` | | OpenClaw | ✅ Hỗ trợ | `install.sh openclaw` | | Antigravity | ✅ Hỗ trợ | `install.sh antigravity` | | Gemini CLI | ✅ Hỗ trợ | `install.sh gemini` | | Pi Agent | ✅ Hỗ trợ | `install.sh pi` | | Vibe CLI | ✅ Hỗ trợ | `install.sh vibe` | | Hermes | ✅ Hỗ trợ | `install.sh hermes` | | Cline | ✅ Hỗ trợ | `install.sh cline` | | KIMI CLI | ✅ Hỗ trợ | `install.sh kimi` | | Trae | ✅ Hỗ trợ | `install.sh trae` | | Nanobot | ✅ Hỗ trợ | `install.sh nanobot` | | Kiro CLI / IDE | ✅ Hỗ trợ | `install.sh kiro` | --- ## 📦 Chia sẻ đồ thị với nhóm Đồ thị chỉ là JSON — **commit một lần, đồng đội bỏ qua pipeline**. Rất hữu ích cho onboarding, đánh giá PR và docs-as-code. > **Ví dụ:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — Go / Java / Python / Node tham khảo kèm đồ thị đã commit. **Nên commit những gì:** mọi thứ trong `.ua/` *ngoại trừ* `intermediate/` và `diff-overlay.json` (đó là dữ liệu tạm địa phương). (Các dự án cũ dùng `.understand-anything/` — hãy thay tên thư mục tương ứng ở dưới nếu đó là thư mục hiện diện.) ```gitignore .ua/intermediate/ .ua/diff-overlay.json ``` **Giữ nó luôn mới:** bật `/understand --auto-update` — một post-commit hook cập nhật dần đồ thị để mỗi commit luôn đi kèm đồ thị tương ứng. Hoặc chạy lại `/understand` thủ công trước các bản phát hành. **Đồ thị lớn (10 MB+):** theo dõi với **git-lfs**. ```bash git lfs install git lfs track ".ua/*.json" git add .gitattributes .ua/ ``` ### Xem dashboard mà không cần Claude Code Khi đồ thị đã được tạo và commit, bất kỳ ai trong nhóm cũng có thể mở nó bằng một lệnh — không cần Claude Code, không cần LLM, không cần API key. Chỉ cần Node.js (>= 18): ```bash npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/analyzed/project ``` Terminal sẽ in ra URL kèm token (`http://127.0.0.1:5173/?token=…`) và mở dashboard tương tác đầy đủ trong trình duyệt. Thư mục dự án (mặc định: thư mục hiện tại) phải chứa thư mục dữ liệu đã commit (`.ua/`, hoặc `.understand-anything/` cũ). Mọi thứ được phục vụ chỉ đọc từ ổ đĩa cục bộ — không có lệnh gọi LLM, không có dữ liệu nào rời khỏi máy của bạn. Đang làm việc từ bản clone? `pnpm install && pnpm --filter @understand-anything/core build`, sau đó `GRAPH_DIR=/path/to/analyzed/project pnpm dev:dashboard` cũng cho kết quả tương tự qua Vite dev server. --- ## 🔧 Bên trong ### Kết hợp Tree-sitter + LLM Phân tích mã tĩnh và LLM làm điều mỗi bên làm tốt nhất: - **Tree-sitter (tất định)** — phân tích mã nguồn thành cây cú pháp cụ thể và trích xuất các sự kiện cấu trúc: import, export, định nghĩa hàm/lớp, vị trí gọi, kế thừa. Được giải trước thành `importMap` trong giai đoạn quét và truyền cho file-analyzer để chúng không phải suy lại import từ mã nguồn. Cùng đầu vào → cùng đầu ra, mỗi lần chạy. Cũng hỗ trợ phát hiện thay đổi dựa trên vân tay (fingerprint) cho cập nhật tăng dần. - **LLM (ngữ nghĩa)** — đọc cấu trúc đã phân tích cùng với mã nguồn gốc để tạo ra những thứ trình phân tích không thể: tóm tắt tiếng Việt tự nhiên, thẻ, gán lớp kiến trúc, ánh xạ miền nghiệp vụ, hành trình hướng dẫn, đánh dấu khái niệm ngôn ngữ. Sự tách biệt này là lý do đồ thị có thể tái tạo được về mặt cấu trúc (cùng code luôn cho cùng các cạnh) trong khi vẫn nắm bắt được ý định về mặt ngữ nghĩa (một tệp *dùng để làm gì*, không chỉ nó import cái gì). ### Đường ống đa tác nhân Lệnh `/understand` điều phối 5 tác nhân chuyên biệt, `/understand-domain` thêm tác nhân thứ 6, và `/understand-knowledge` thêm tác nhân thứ 7: | Tác nhân | Vai trò | Được dùng bởi | | ----------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------- | | `project-scanner` | Khám phá tệp, phát hiện ngôn ngữ và framework | `/understand` | | `file-analyzer` | Trích xuất hàm, lớp, import; tạo nút và cạnh đồ thị | `/understand` | | `architecture-analyzer` | Xác định lớp kiến trúc | `/understand` | | `tour-builder` | Tạo hành trình học có hướng dẫn | `/understand` | | `graph-reviewer` | Kiểm tra tính đầy đủ và toàn vẹn tham chiếu của đồ thị. Chạy nội tuyến mặc định; dùng `--review` để LLM đánh giá đầy đủ | `/understand` | | `domain-analyzer` | Trích xuất miền nghiệp vụ, luồng và bước xử lý | `/understand-domain` | | `article-analyzer` | Trích xuất thực thể, tuyên bố và quan hệ ngầm từ bài viết wiki | `/understand-knowledge` | Các file-analyzer chạy song song (tối đa 5 đồng thời, 20-30 tệp mỗi đợt). Pipeline cũng hỗ trợ cập nhật tăng dần: chỉ phân tích lại các tệp đã thay đổi kể từ lần chạy trước. --- ## 🎥 Cộng đồng Một bài hướng dẫn từ cộng đồng bởi **Better Stack**.

Xem trên YouTube →

Đã làm video, bài blog hay hướng dẫn? Mở issue hoặc PR — rất vui được giới thiệu ở đây. --- ## 🤝 Đóng góp Mọi đóng góp đều được chào đón! Đây là cách bắt đầu: 1. Fork repository 2. Tạo feature branch (`git checkout -b feature/my-feature`) 3. Chạy kiểm thử (`pnpm --filter @understand-anything/core test`) 4. Commit thay đổi và mở pull request Vui lòng mở issue trước cho các thay đổi lớn để chúng ta có thể thảo luận về hướng tiếp cận. ---

Đừng đọc code mù quáng. Hãy bắt đầu hiểu mọi thứ.

## Star History

Cảm ơn tất cả những ai đã sử dụng và đóng góp — biết rằng điều này giúp mọi người tiết kiệm thời gian là điều khiến nó đáng được xây dựng.

Giấy phép MIT © Yuxiang Lin và Infinite Universe, Inc.