Теперь Хабр может объяснить, что это за код

2025-12-05 в 10:30, admin, рубрики: sourcecraft, ИИ, ии-агенты, хабр

TL; DR
Мы встроили SourceCraft во все кодовые сниппеты в публикациях на Хабре. Он объяснит, что делает код. Как это работает, кому нужно и как использовать — читайте ниже.

Хабр — площадка для технических специалистов, всегда имевшая уклон в сторону IT. Поэтому в статьях много кода, который привычен хабрапользователям. Постепенно Хабр разрастается в других направлениях, и аудитория, не знакомая с разработкой, администрированием и другими, привычными для нас вещами, растёт. Авторам, которые хотят максимального охвата, иногда приходится как в статье, так и в комментариях подробно рассказывать про каждую строчку кода и описывать очевидные вещи. В итоге вместо погружения читателя в конкретную технологию или идею статья размывается описанием базовых вещей.

За 2024 год было написано 7598 статей, в которых используются сниппеты для размещения кода, это почти 20% всех публикаций на Хабре. Код может быть труден для части читателей — начинающих, специалистов из смежных областей или тех, кто работает на другом стеке.

Как я писал выше, можно понадеяться, что автор прокомментирует каждую строчку кода, или же спросить у него напрямую. Некоторые комментаторы так и делают, уточняя конкретные детали.

А можно… Да, можно попросить ИИ посмотреть этот код и объяснить всё, что там написано. Именно это и делает новая фича на Хабре, которую мы разработали совместно с SourceCraft. Она даёт возможность получить комментарии с помощью ИИ-ассистента SourceCraft Code Assistant от Яндекса по коду для тех, кому этот код непонятен. Теперь авторы смогут сосредоточиться на действительно важном и в статьях будет меньше воды с объяснением базы. А начинающим, пишущим на других языках и непрограммистам будет проще разобраться в статьях с кодом.

Как же это работает?

В статьях появилась кнопка «Объяснить код с SourceCraft» — непосредственно в сниппетах с кодом.

Скрин из статьи Clean Architecture во frontend: почему я ушёл от FSD

Когда вы нажимаете на кнопку, мы отправляем запрос ИИ-помощнику на платформе SourceCraft. Помощник в качестве контекста берёт всю статью и конкретный блок кода.

Далее оверлеем появляется окно, в которое подгружается ответ нейросети с объяснением кода в контексте данной статьи.

На смартфонах и планшетах объяснение появится снизу, а на десктопе — в боковой панели.

Теперь Хабр может объяснить, что это за код - 2

Как видите по скриншоту, там подробно, по шагам рассказывается про код: какие импорты и для чего нужны, какие объекты, функции, классы и т. д. нужны и какую роль они выполняют.

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

В редких случаях ИИ всё же может ошибаться. Если вы заметили неточности, ошибки или неверную интерпретацию кода, отзыв можно отправить в техническую поддержку.

Если информации в оверлее с объяснением недостаточно или остались вопросы, можно нажать кнопку «Подробнее в SourceCraft». При её нажатии в новой вкладке откроется интерфейс SourceCraft, в который подгружается контекст из статьи и блока кода. Далее с этим можно взаимодействовать как с любой IDE с ассистентом: задавать вопросы и получать ответы.

Эта кнопка нужна тем, кому недостаточно базового описания кода. ИИ-помощнику SourceCraft Code Assistant можно задавать любые вопросы по коду, попросить адаптировать код под свою задачу или переписать его на другой язык.

Теперь Хабр может объяснить, что это за код - 3

Дмитрий Иванов

Руководитель платформы SourceCraft

Мы видим здесь два сценария, для которых разработали разные инструменты. Первый — быстро получить суть: для этого код объясняет в статье наш ИИ-помощник на базе Yandex AI Studio. Второй — если нужно по-настоящему поработать с фрагментом: углубиться, доработать, обсудить. Тогда пользователь одним кликом переходит на платформу SourceCraft — это среда для разработки, где можно вести диалог с полноценным ИИ-агентом, экспериментировать и сразу тестировать идеи из статьи.

Для кого?

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

Скрин из статьи Ответ фронтендера на «Не занимайтесь преждевременной оптимизацией»

Для тех, кто пишет на других языках. Бывает, что в статье написано нужное решение, но на неизвестном языке. Привет ИИ-агент, перепиши этот Java-код на язык Swift, а дальше я уже сам разберусь.

В статье про генерации QR-кода Генерируем и сканируем QR/BAR-коды нажимаем «Объяснить код с SourceCraft» — получаем краткое описание для понимания логики Java-кода.

Теперь Хабр может объяснить, что это за код - 5

Нажимаем «Подробнее в SourceCraft» и просим переписать на Swift:

Теперь Хабр может объяснить, что это за код - 6

Опытные разработчики могут копнуть глубже, разобравшись в неочевидных нюансах написанного кода (или мнения ИИ-помощника о нём).

Скрины получены по сниппету кода из статьи Как писать кодогенераторы в Go

Или можно открыть для себя что-то новое, наконец разобравшись с тем, что написано тут:

>>>+[[-]>>[-]++>+>+++++++[<++++>>++<-]++>>+>+>+++++[>++>++++
++<<-]+>>>,<++[[>[->>]<[>>]<<-]<[<]<+>>[>]>[<+>-[[<+>-]>]<[[
[-]<]++<-[<+++++++++>[<->-]>>]>>]]<<]<]<[[<]>[[>]>>[>>]+[<<]
<[<]<+>>-]>[>]+[->>]<<<<[[<<]<[<]+<<[+>+<<-[>-->+<<-[>+<[>>+
<<-]]]>[<+>-]<]++>>-->[>]>>[>>]]<<[>>+<[[<]<]>[[<<]<[<]+[-<+
>>-[<<+>++>-[<->[<<+>>-]]]<[>+<-]>]>[>]>]>[>>]>>]<<[>>+>>+>>
]<<[->>>>>>>>]<<[>.>>>>>>>]<<[>->>>>>]<<[>,>>>]<<[>+>]<<[+<<
]<]

В заключение

Это наш первый эксперимент с добавлением ИИ в пользовательский опыт. Мы постарались сделать так, чтобы ИИ был помощником для пользователя, а не заменял его, принося в ленту и комменты сгенерированный контент, который у вас, как мы знаем, не в почёте.