Understand Anything: граф знаний для любого кода
Открытый плагин Understand Anything превращает любой кодовый репозиторий в интерактивный граф знаний с поиском, чатом и анализом зависимостей.
Граф, который учит, а не впечатляет
Understand Anything — open-source плагин для Claude Code, который анализирует любой кодовый репозиторий или базу знаний с помощью мультиагентного пайплайна и генерирует интерактивный граф знаний. Инструмент извлекает файлы, функции, классы и зависимости, затем отображает их в визуальном дашборде с нечётким и семантическим поиском, экскурсиями по архитектуре, анализом diff-изменений, доменным представлением и адаптивным UI для разных ролей. Поддерживаются платформы Cursor, GitHub Copilot, Codex, Gemini CLI, OpenCode, а сгенерированный JSON-граф можно закоммитить в репозиторий для совместного онбординга и код-ревью.
Зачем это нужно
Представьте: вы выходите на новый проект, а там 200 000 строк кода. С чего начать? Мультиагентный пайплайн сканирует проект, извлекает каждый файл, функцию, класс и зависимость, а затем строит граф знаний, сохранённый в .understand-anything/knowledge-graph.json.
«Цель — не граф, который поражает сложностью кодовой базы, а граф, который тихо учит, как все части связаны друг с другом.»
Интерактивный веб-дашборд открывается с кодом, визуализированным в виде графа — с цветовой кодировкой по архитектурным слоям, поиском и кликабельными узлами. Выбирая любой узел, вы видите его код, связи и понятное объяснение на естественном языке.
Ключевые возможности
| Функция | Что делает |
|---|---|
| Структурный граф | Файлы, функции, классы — кликабельные узлы с описаниями |
| Доменное представление | Код в разрезе бизнес-процессов, потоков и шагов |
| Fuzzy & Semantic Search | Поиск по имени или смыслу: «какие части отвечают за авторизацию?» |
| Diff Impact Analysis | Показывает, какие части системы затрагивают ваши изменения до коммита |
| Guided Tours | Автогенерируемые экскурсии по архитектуре в правильном порядке зависимостей |
| Persona-Adaptive UI | Уровень детализации адаптируется под джуна, PM или опытного разработчика |
| Layer Visualization | Автогруппировка по слоям: API, Service, Data, UI, Utility |
| Language Concepts | 12 паттернов программирования с объяснениями в контексте кода |
Дашборд адаптирует уровень детализации в зависимости от роли: junior dev, PM или power user. Архитектурные слои — API, Service, Data, UI, Utility — автоматически группируются и отображаются с цветовой легендой.
Мультиагентный пайплайн под капотом
graph TD
A[/understand] --> B[project-scanner\nОбнаружение файлов и фреймворков]
B --> C[file-analyzer\nФункции, классы, импорты]
C --> D[architecture-analyzer\nАрхитектурные слои]
D --> E[tour-builder\nЭкскурсии по архитектуре]
E --> F[graph-reviewer\nВалидация графа]
A --> G[/understand-domain]
G --> H[domain-analyzer\nБизнес-домены и процессы]
Команда /understand запускает 5 специализированных агентов последовательно, а /understand-domain добавляет шестой — domain-analyzer — для извлечения бизнес-логики. Анализаторы файлов работают параллельно, обрабатывая до 5 файлов одновременно.
Установка и поддерживаемые платформы
Для Claude Code достаточно двух команд:
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
Затем запустите /understand — и граф готов.
Для всех остальных платформ работает единый скрипт:
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
# Или с явным указанием платформы:
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex
| Платформа | Статус | Метод установки |
|---|---|---|
| Claude Code | ✅ Нативный | Plugin marketplace |
| Cursor | ✅ Поддерживается | Автообнаружение |
| VS Code + GitHub Copilot | ✅ Поддерживается | Автообнаружение |
| Copilot CLI | ✅ Поддерживается | copilot plugin install |
| Codex | ✅ Поддерживается | install.sh codex |
| Gemini CLI | ✅ Поддерживается | install.sh gemini |
| OpenCode | ✅ Поддерживается | install.sh opencode |
| Cline | ✅ Поддерживается | install.sh cline |
| KIMI CLI | ✅ Поддерживается | install.sh kimi |
Установщик клонирует репозиторий в ~/.understand-anything/repo и создаёт нужные симлинки для выбранной платформы. После этого нужно перезапустить CLI или IDE.
Полезные команды после установки
# Задать вопрос о кодовой базе
/understand-chat How does the payment flow work?
# Проанализировать влияние текущих изменений
/understand-diff
# Подробный разбор конкретного файла или функции
/understand-explain src/auth/login.ts
# Создать гайд по онбордингу для новых коллег
/understand-onboard
# Извлечь бизнес-доменные знания
/understand-domain
/understand, откройте дашборд командой /understand-dashboard, затем сгенерируйте онбординг-гайд через /understand-onboard. Вместо недель погружения в чужой код — структурированная карта всего проекта за минуты.Командный режим: граф как артефакт
Граф — это просто JSON: достаточно закоммитить его один раз, и коллеги смогут пропустить запуск пайплайна. Это удобно для онбординга, PR-ревью и подхода docs-as-code.
| Сценарий | Как использовать |
|---|---|
| Онбординг новичка | Закоммитить .understand-anything/ и поделиться ссылкой |
| PR-ревью | Запустить /understand-diff перед открытием пулл-реквеста |
| Документация | Хранить граф в репозитории как живую документацию |
| Большие графы (10 МБ+) | Подключить git-lfs для хранения JSON-файлов |
.understand-anything/intermediate/ и файл .understand-anything/diff-overlay.json — это локальные временные данные, не нужные остальным участникам команды.Значение для отрасли
Understand Anything поднимает важную тему: инструменты визуализации кода существовали и раньше, но большинство генерировали статичные схемы ради красоты. Этот инструмент позволяет исследовать каждый файл, функцию и зависимость — или переключиться в режим бизнес-знаний и увидеть код как потоки аутентификации, платёжные пайплайны и жизненные циклы пользователей.
Поддержка сразу 14+ платформ с единым скриптом установки делает Understand Anything одним из наиболее доступных инструментов для разработчиков независимо от предпочитаемой AI-среды. В эпоху, когда огромные legacy-кодовые базы становятся нормой, а скорость онбординга напрямую влияет на бизнес-результаты, подобные open-source решения способны изменить привычные рабочие процессы целых команд — от джуниоров до архитекторов.