Understand Anything — граф знаний для любой кодовой базы
📂 Исходный код на GitHubOpen-source инструмент от Egonex, превращающий код, документацию и LLM-вики в интерактивные графы знаний. Гибридный подход Tree-sitter + LLM, мультиагентный пайплайн, инкрементальные обновления и поддержка 15+ AI-платформ.
Вы зашли в новый проект. 200 000 строк кода. С чего начать?
Understand Anything решает эту проблему — это открытый AI-инструмент, который анализирует кодовую базу через мультиагентный пайплайн, строит граф знаний (каждый файл, функция, класс и зависимость становятся узлом) и отдаёт интерактивный дашборд для визуального исследования.
Как это работает
Understand Anything использует гибридный подход: Tree-sitter для детерминированного парсинга (импорты, экспорты, определения функций и классов, точки вызовов, наследование) и LLM для семантического слоя — краткие описания на естественном языке, теги, распределение по архитектурным слоям, бизнес-домены и экскурсии по коду.
Структурная часть графа воспроизводима (одинаковый код → одинаковые рёбра), семантическая — отражает намерения (зачем файл нужен, а не только что он импортирует).
Мультиагентный пайплайн
Команда /understand запускает 5 специализированных агентов, а /understand-domain добавляет шестого:
| Агент | Роль |
|---|---|
project-scanner |
Обнаружение файлов, определение языков и фреймворков |
file-analyzer |
Извлечение функций, классов, импортов; создание узлов и рёбер графа |
architecture-analyzer |
Определение архитектурных слоёв (API, Service, Data, UI, Utility) |
tour-builder |
Генерация обучающих экскурсий по архитектуре |
graph-reviewer |
Валидация полноты графа и ссылочной целостности |
domain-analyzer |
Извлечение бизнес-доменов, потоков и шагов процессов |
article-analyzer |
Извлечение сущностей и связей из LLM-вики (паттерн Karpathy) |
Анализаторы файлов работают параллельно — до 5 одновременно, батчами по 20–30 файлов. Последующие запуски инкрементальны: переанализируются только изменившиеся файлы.
Ключевые возможности
Структурный граф — каждый файл, функция и класс как узел. Кликните на узел — увидите его код, связи и текстовое описание.
Бизнес-логика — переключитесь в режим доменов и увидите, как код отображается на реальные бизнес-процессы: домены, потоки, шаги.
Управляемые экскурсии (Guided Tours) — автоматически сгенерированные маршруты по архитектуре, упорядоченные по зависимостям. Изучаете кодовую базу в правильном порядке.
Нечёткий и семантический поиск — ищете по имени или по смыслу. Запрос «какие части отвечают за аутентификацию?» находит релевантные узлы по всему графу.
Анализ влияния изменений (Diff Impact Analysis) — перед коммитом видите, какие части системы затронут ваши правки.
Адаптивный интерфейс — дашборд подстраивает уровень детализации под роль: junior-разработчик, PM или опытный программист.
Визуализация слоёв — автоматическая группировка по архитектурным слоям с цветовой легендой.
Объяснение языковых концепций — 12 паттернов программирования (generics, closures, декораторы и др.) объясняются в контексте там, где встречаются.
Анализ баз знаний
Команда /understand-knowledge принимает LLM-вики в паттерне Karpathy (index.md с викиссылками) и строит граф знаний с кластеризацией сообществ. Детерминированный парсер извлекает викиссылки и категории, а LLM-агенты находят неявные связи, выделяют сущности и формулируют утверждения.
Совместное использование
Граф — это просто JSON. Закоммитьте один раз — и коллеги получают готовый граф без повторного запуска пайплайна. Полезно для онбординга, код-ревью и документации.
Просмотр дашборда без Claude Code — одной командой, нужен только Node.js >= 18:
npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/project
Всё работает локально, без LLM-вызовов и API-ключей.
Платформы
Understand Anything работает на 15+ AI-платформах: Claude Code (нативный плагин), Codex, Cursor, GitHub Copilot, Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Antigravity, Pi Agent, Vibe CLI, Hermes, Cline, KIMI CLI, Trae, Nanobot, Kiro.
Установка одной командой:
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash
Локализация — через --language (поддерживаются en, zh, zh-TW, ja, ko, ru). При первом запуске язык определяется автоматически.
Итог
Understand Anything — это не граф, который впечатляет сложностью, а граф, который тихо учит понимать, как всё устроено. 75k+ звёзд на GitHub, активное сообщество, MIT-лицензия.