Этот AI-инструмент создает карту любого кода до того, как вы начнете с ним работать (Understand-Anything)

BBetter Stack
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00Вы приходите в новую команду, клонируете репозиторий и открываете кодовую базу.
00:00:04И вот она — 200 000 строк кода, которые смотрят на вас, как олень на фары.
00:00:09Поэтому вы делаете то, что делает каждый разработчик.
00:00:11Вы используете grep, прыгаете по файлам и, вероятно, просите Claude объяснить, что это за репо.
00:00:17А что, если бы у вас была карта — настоящая интерактивная карта, которая учит вас кодовой базе?
00:00:22Потоки, архитектурные слои, изменения, влияние — это Understand Anything.
00:00:27Проект уже набрал более 14 000 звезд на GitHub за пару недель, и многие разработчики
00:00:32говорят о нем.
00:00:33В следующую минуту я покажу вам, как это работает и как это значительно ускорит
00:00:36понимание вашей кодовой базы.
00:00:44Understand Anything — это open-source плагин для Claude Code.
00:00:47Он также может встраиваться в рабочие процессы с такими инструментами, как Cursor, Copilot и Gemini CLI.
00:00:53Вы направляете его на репозиторий или даже базу знаний, и он превращает этот проект в запрашиваемый,
00:00:58интерактивный граф знаний.
00:01:00Это достигается с помощью статического анализа и мультиагентной обработки LLM.
00:01:05Но важно не то, какой там стек технологий.
00:01:07Важно то, какую проблему он решает, ведь с этим сталкивался каждый разработчик.
00:01:13Вы новичок в какой-то легаси-кодовой базе, легаси-приложении.
00:01:16Документация устарела.
00:01:18Инженер, который знал все, уволился полгода назад.
00:01:22А ваш ИИ-агент для кодинга продолжает просто гадать снова и снова.
00:01:26Вот тут-то этот инструмент становится очень полезным.
00:01:28Давайте его запустим.
00:01:29Если вам нравятся инструменты для ускорения рабочего процесса, обязательно подпишитесь.
00:01:33Мы постоянно выпускаем новые видео.
00:01:35А вот проект среднего размера.
00:01:36Он достаточно большой, чтобы быть по-настоящему раздражающим, но достаточно маленький,
00:01:40чтобы я мог показать, как это круто.
00:01:42Это просто репо, которое я клонировал из микросервисов Google, и оно достаточно мало,
00:01:46чтобы мы могли протестировать это без лишней показухи.
00:01:49Сначала я установлю плагин, прямо здесь в Claude: plugin install understand-anything.
00:01:54Далее,
00:01:55когда все сгенерируется, нам, конечно, нужно перезагрузить плагины, а затем просто запустить
00:01:58команду understand.
00:02:00Теперь он просканирует весь репозиторий.
00:02:03Он извлечет структуру, взаимосвязи, ключевые модули и, вероятно, бизнес-концепции.
00:02:09Теперь можно запустить команду dashboard, чтобы все запустить.
00:02:11Сначала это заняло целую вечность, минут 30, и сожрало кучу токенов.
00:02:16Так что хороший тарифный план Claude — необходимость.
00:02:19У меня Claude Max, и это использовало 25% моего лимита, так что расходуется он быстро.
00:02:24Но как только все готово, мы можем открыть эту панель управления, и вот тут начинается
00:02:29самое интересное.
00:02:30Я могу отдалить и увидеть высокоуровневую архитектуру.
00:02:32Я могу приблизить и получить доступ к внутренним частям.
00:02:35Я могу кликнуть, чтобы увидеть структуру кода и то, как все это связано.
00:02:40Я даже могу провалиться внутрь и посмотреть сам код.
00:02:43Затем я могу найти что-то здесь, например, “платежи”.
00:02:46Обычно мне пришлось бы прыгать между маршрутами, сервисами, моделями, обработчиками, просто документацией,
00:02:52которая даже больше не полезна, а здесь инструменты собирают все кусочки вместе.
00:02:56Теперь я могу нажать “guided tour” (обзор с гидом), и он проведет по потоку по порядку.
00:03:01Точка входа, валидация, логика, база данных, внешние API, обработка ошибок.
00:03:07Это уже очень полезно.
00:03:09Этот гид раскладывает все по полочкам.
00:03:11Мы можем зайти внутрь и получить доступ к различным компонентам.
00:03:14Это разница между “Эй, это очень крутой граф” и “Я действительно проверю это,
00:03:18прежде чем трогать продакшн-код”.
00:03:20Но очевидный вопрос: разве у нас уже нет таких инструментов?
00:03:25Как разработчикам, нам не нужно больше красивых дашбордов.
00:03:29Нам нужно меньше тратить время зря, и этот инструмент бьет по одному из самых больших пожирателей времени в разработке.
00:03:35Получение контекста, верно?
00:03:37Где все это связано?
00:03:38Как это использовать?
00:03:39Люди тестируют это на крупных проектах, легаси-монолитах на Java, репозиториях с микросервисами, сотнях
00:03:45файлов, и реакция примерно такая, как у меня.
00:03:48Это сэкономило бы мне две первые недели на работе, потому что это разбирает все по частям,
00:03:53связывает все воедино и показывает, как все переплетено.
00:03:56Это первый по-настоящему большой кейс: онбординг.
00:03:58Вместо того чтобы сказать “Прочитай эти 12 страниц и спроси, если что непонятно” — что
00:04:03само по себе уже запутывает — мы теперь можем сказать: “Открой граф, пройди тур, а потом мы сможем задать более
00:04:08грамотные вопросы”.
00:04:09Теперь, второй действительно хороший кейс — это ИИ-агенты, потому что большинство ИИ-инструментов
00:04:14хороши ровно настолько, насколько хорош контекст, который мы им даем.
00:04:17Если агент видит три файла, он будет просто гадать.
00:04:20Если же у него есть структурированная карта системы с доменами, потоками, зависимостями и фактическими объяснениями,
00:04:27у него больше шансов сразу внести правильные изменения.
00:04:30Затем, конечно, рефакторинг, верно?
00:04:32Прежде чем трогать код, мы теперь можем спросить: “От чего зависит этот код?
00:04:36К какому потоку он относится?
00:04:38Что может сломаться, если его переместить?”
00:04:40Вот как избежать превращения изменения в одну строчку в крупный инцидент.
00:04:44И это настоящая причина, почему разработчики так воодушевлены этим проектом.
00:04:48Не потому, что мы заботимся о диаграммах, хотя я люблю диаграммы, верно?
00:04:51Они крутые, полезные, я визуал, но мы ненавидим теряться.
00:04:55Но здесь нужно быть осторожным, потому что разработчики уже видели инструменты визуализации кода.
00:05:00Графы IDE, навигацию в стиле Sourcegraph, графы Nx, визуализаторы tree-sitter, и у многих
00:05:05из них одна и та же проблема.
00:05:09Что они делают?
00:05:10Они показывают структуру, но не объясняют истинный смысл.
00:05:13Они говорят вам, что этот файл импортирует тот, отлично, но почему?
00:05:18Частью какого потока это является?
00:05:19Где начинается запрос?
00:05:20Что сломается, если я изменю его?
00:05:22Вот этого слоя и не хватает.
00:05:24Understand Anything пытается добавить этот слой.
00:05:27Вместо того чтобы просто показывать TypeScript-файл или что-то еще, он пытается превратить это в нечто
00:05:31близкое к фактическому потоку работы системы.
00:05:35Вот в чем главная фишка.
00:05:37От файлов — к смыслу, от импортов — к поведению системы, от “вот здесь кусочки” — к “вот
00:05:42как работает машина”.
00:05:43По сравнению со многими LLM или RAG-инструментами для кода, он также более нагляден и понятен.
00:05:48Многие ИИ-инструменты для кода — это, по сути, просто поисковые строки.
00:05:52Вы задаете вопрос, получаете ответ.
00:05:54Это дает вам полную картину, помогая понять, куда все движется, что с чем переплетено,
00:06:00как связано, позволяя нам при этом видеть сам код.
00:06:04Теперь давайте поговорим о том, что людям действительно нравится.
00:06:05Очевидный плюс здесь — онбординг.
00:06:07Если вы присоединяетесь к большой кодовой базе, это дает хорошую отправную точку.
00:06:12Также архитектурные слои, верно?
00:06:13Они отлично проработаны.
00:06:15Вы можете начать с системного уровня и затем углубиться в модули и детали реализации.
00:06:20Влияние диффов — еще один важный момент.
00:06:21Каждый опытный разработчик знает страх внести крошечное изменение
00:06:23в кодовую базу, которую он пока не понимает.
00:06:27Для пользователей Claude Code этот граф может стать лучшим контекстом,
00:06:29поэтому вместо того, чтобы сваливать случайные файлы в промпт, вы даете агенту
00:06:34структурированные архитектурные знания.
00:06:39Это также бесплатно, имеет лицензию MIT, инкрементально и разработано для работы в различных средах разработки.
00:06:45Теперь о скептической стороне: когда проект так быстро взлетает, мы начинаем задаваться вопросом:
00:06:49он полезен или просто обыграл алгоритм GitHub?
00:06:53Хороший вопрос.
00:06:55Также есть зависимости от LLM, а это стоимость токенов.
00:06:59Это взорвало затраты на токены.
00:07:02Так что это заняло время и потребовало много токенов.
00:07:05Убедитесь, что у вас хороший план, если собираетесь использовать это.
00:07:08Вам все еще нужно хорошее суждение.
00:07:09Это просто дает вам общий обзор.
00:07:11Это не заменяет чтение кода.
00:07:13Это просто помогает лучше понять его, понять, куда все движется.
00:07:16Если вам нравятся инструменты и советы по кодингу, подпишитесь на канал Better Stack.
00:07:20Увидимся в следующем видео.

Key Takeaway

Understand Anything ускоряет онбординг в новые кодовые базы и минимизирует риски при рефакторинге, преобразуя статический код в интерактивную карту поведения системы вместо простого отображения структуры импортов.

Highlights

  • Understand Anything превращает кодовую базу в интерактивный граф знаний с помощью статического анализа и мультиагентной обработки LLM.

  • Инструмент является open-source плагином для Claude Code и поддерживает интеграцию с такими средами, как Cursor, Copilot и Gemini CLI.

  • Функция «guided tour» визуализирует логические потоки выполнения кода, включая валидацию, взаимодействие с базой данных и обработку внешних API.

  • Первичное сканирование крупного репозитория может занять около 30 минут и расходует значительное количество токенов LLM.

  • Инструмент помогает разработчикам оценивать последствия изменений кода, выявляя зависимости и потоки выполнения перед внесением правок в продакшн.

  • Проект получил более 14 000 звезд на GitHub за первые две недели после публикации.

Timeline

Проблема понимания больших кодовых баз

  • Разработчики часто тратят время на навигацию по тысячам строк кода без четкого понимания архитектурных связей.
  • Традиционные инструменты навигации часто опираются на устаревшую документацию или интуицию.

При работе с легаси-проектами или при входе в новую команду разработчики сталкиваются с избытком файлов. Использование grep или обычных ИИ-агентов часто приводит к гаданиям, так как контекст ограничивается лишь несколькими просмотренными файлами.

Функционал и установка Understand Anything

  • Установка плагина выполняется командой plugin install understand-anything в Claude Code.
  • Команда dashboard запускает визуализацию архитектурных слоев, модулей и бизнес-логики проекта.

Инструмент анализирует репозиторий для создания графа знаний. Процесс сканирования требует существенных вычислительных ресурсов и лимитов токенов, поэтому рекомендуется наличие тарифного плана Claude Max. Интерфейс позволяет переходить от высокоуровневой архитектуры к конкретным участкам кода.

Практические сценарии использования

  • Функция guided tour позволяет отследить полный путь запроса: от точки входа до обработки ошибок и обращений к базе данных.
  • Инструмент значительно сокращает время онбординга, заменяя чтение абстрактной документации интерактивным изучением потоков системы.
  • Структурированные данные о зависимостях позволяют ИИ-агентам вносить более точные изменения в код.

Понимание переплетения компонентов критично для безопасности рефакторинга. Возможность задать вопрос «что сломается, если я перемещу этот код?» снижает вероятность инцидентов при внесении правок в продакшн.

Отличия от существующих решений и ограничения

  • Большинство визуализаторов кода показывают импорты, но не раскрывают смысловое поведение системы.
  • Understand Anything переводит фокус с структуры файлов на потоки выполнения системы.
  • Высокое потребление токенов требует осторожного планирования бюджета при использовании на больших проектах.

Инструмент дополняет, но не заменяет необходимость чтения кода человеком. Несмотря на высокую популярность проекта, пользователям следует учитывать затраты на LLM-токены и необходимость критического анализа выводов, предоставляемых визуальной панелью.

Community Posts

No posts yet. Be the first to write about this video!

Write about this video