Transcription
Привет всем. Google только что анонсировал Code Wiki, и он призван устранить самую большую проблему в разработке программного обеспечения — понимание кода. Они начинают с реальной проблемы. Чтение кода — это медленно и дорого, и, честно говоря, это правда. Большинство команд разработчиков тратят часы, пытаясь понять устаревшие модули. Это основная идея. Code Wiki поддерживает вашу документацию в актуальном состоянии. Больше никаких устаревших файлов markdown. Больше никаких застывших диаграмм. Документация автоматически развивается вместе с кодом. Эти три пункта описывают все, что вам нужно знать.
Во-первых, автоматизированная и всегда актуальная. Она сканирует всю вашу кодовую базу и перегенерирует документацию каждый раз, когда код меняется. Больше никакого устаревшего markdown, больше никаких устаревших диаграмм. Документация автоматически развивается вместе с вашим репозиторием.
Во-вторых, интеллектуальная и контекстно-зависимая. Сама вики становится мозгом для чата Gemini. Поэтому, когда вы задаете вопросы, вы не разговариваете с общей моделью. Вы разговариваете с ИИ, который на самом деле понимает ваш репозиторий от начала до конца.
И в-третьих, интегрированная и действенная. Каждый раздел имеет гиперссылку на точный файл, функцию или класс. Таким образом, чтение и исследование кода становится единым непрерывным рабочим процессом. Больше никакой охоты по папкам.
Code Wiki запускается как общедоступный веб-сайт для предварительного просмотра публичных репозиториев. Он обрабатывает репозиторий, сканирует весь код и перегенерирует документацию после каждого изменения. Code Wiki, по сути, превращает статическую документацию в живую, всегда точную документацию с глубокими ссылками на точные файлы, классы и функции, стоящие за каждым объяснением. И если вы застряли в сложном модуле, вы можете просто спросить встроенный чат Gemini, который дает релевантные ответы, потому что все его знания исходят из актуальной вики вашего репозитория. Наконец, вы получаете документацию, которая остается точной без постоянного присмотра. Кроме того, он автоматически генерирует диаграммы архитектуры, классов и последовательностей, которые фактически отражают текущее состояние вашего кода, поэтому визуальные эффекты никогда не лгут.
Google также работает над расширением Gemini CLI для Code Wiki, и это та часть, которая больше всего волнует команды. Публичные репозитории — это просто, но настоящая проблема кроется внутри частных кодовых баз компаний, особенно когда оригинальных авторов больше нет, а устаревшие модули представляют собой лабиринт. Версия CLI позволит вам запускать Code Wiki локально и безопасно на ваших собственных внутренних репозиториях, предоставляя командам реальную документацию и реальное понимание, не отправляя код никуда. Они открыли список ожидания для нее, и как только она будет выпущена, это станет революционным изменением для корпоративной разработки.
В качестве примера я загружаю shadcn.ui, одну из самых популярных библиотек пользовательского интерфейса, и Code Wiki отлично ее разбирает. Это самый чистый способ увидеть инструмент в действии. Он генерирует документацию непосредственно из официального репозитория shadcn.ui. Он сгенерировал чистую, хорошо организованную документацию для каждой части проекта, разбивая все по разделам таким образом, чтобы ее было легко понять. И впечатляет то, что каждый из этих разделов включает свою собственную автоматически созданную диаграмму, давая вам визуальное представление о том, как все взаимосвязано. Он также добавляет глубокие гиперссылки по всей документации. Поэтому, когда упоминается файл, класс или компонент, вы можете щелкнуть и мгновенно перейти к точному местоположению в коде. Никакого поиска, никакого угадывания. Все напрямую связано.
Что меня действительно впечатлило, так это чат-бот, знающий репозиторий. Вы можете задавать конкретные вопросы о кодовой базе, и он отвечает объяснениями, напрямую связанными с файлами. Например, я спросил: «Как работает компонент кнопки?» И он разобрал код с прямыми ссылками. Он даже показал мне, как использовать все варианты кнопок с реальными примерами кода. И на этом он не остановился. Он объяснил, как комбинировать кнопку с другими компонентами, такими как значки, выпадающие меню, и даже как правильно использовать ссылку Next.js внутри кнопки.
Вы также можете использовать Code Wiki для генерации контекстных файлов для вашего ИИ-кодера. Например, я попросил его создать файл instructions.mmarkdown для Copilot, используя запрос «создать instructions.mmarkdown для Copilot, суммирующий архитектурные стандарты и шаблоны, которым должен следовать Copilot в этом проекте». И немедленно он произвел полный файл markdown. Вы можете вставить его прямо в свой проект, и ваш ИИ-кодер поймет структуру, правила и шаблоны, что означает, что он будет генерировать гораздо лучший код.
Я слежу за выпуском для частных репозиториев, потому что именно тогда эта вещь становится невероятно мощной для реальных команд. Спасибо за просмотр. Увидимся в следующем видео.