Труды КНЦ. Технические науки. – 2026. - № 1

Это обеспечивает навигацию по всей структуре проекта — от общего списка модулей к конкретным страницам с описаниями классов, методов и свойств и обратно через ссылки "Источник". Повторный запуск на том же репозитории подтвердил корректность реализации принципа идемпотентности: для файлов, уже обработанных в предыдущем запуске, повторных запросов к большой языковой модели не происходило. Система корректно определяла существующие описания и пропускала эти сущности. Обработка каждого файла занимала в среднем 12-15 секунд (включая время генерирования XML и потенциальный запрос к LLM), что для всего проекта составило около 10 минут. Все сгенерированные Markdown-файлы были успешно опубликованы в вики-репозиторий проекта. Инкрементальные коммиты после обработки каждого файла обеспечили детальную историю изменений. Полученная вики полностью функциональна: поддерживает навигацию по ссылкам, отображает форматирование и доступна через веб-интерфейс Gitea для всей команды разработки. Гипертекстовая структура автоматически сгенерированной документации не только обеспечивает удобство навигации через веб-интерфейс Gitea W iki, но и открывает дополнительные возможности при локальной работе с файлами. Поскольку документация сохраняется в виде стандартных Markdown-файлов с двунаправленными ссылками, ее можно напрямую открыть в инструментах для управления персональными базами знаний, таких как Obsidian. В Obsidian эти ссылки автоматически строят визуальный граф зависимостей, наглядно отображающий архитектурные связи между модулями и классами проекта. Разработчик видит не просто список файлов, а карту взаимосвязей: какие модули содержат какие классы, как типы используются в разных частях системы. Заключение В ходе выполнения исследования разработана и апробирована автоматизированная система документирования унаследованных программных проектов, интегрирующая методы статического анализа исходного кода и генеративные возможности больших языковых моделей. Предложенное решение реализует полный конвейер обработки — от извлечения метаданных программных сущностей до публикации структурированной гипертекстовой документации в вики-репозиторий. Принципиальной особенностью предложенного подхода является не просто автоматическое создание технической документации, а формирование связанной гипертекстовой структуры. Двунаправленные перекрестные ссылки между страницами модулей и классов образуют полноценную базу знаний, пригодную как для навигации через стандартный веб-интерфейс, так и для визуального анализа архитектурных связей в инструментах персональных баз знаний. Это качественно меняет восприятие унаследованного кода, превращая разрозненные исходные файлы в исследовательское пространство, где разработчик может отслеживать зависимости и прослеживать логику взаимодействия компонентов. Несмотря на возможность оперативного создания документации, в текущей реализации генерирование описаний осуществляется на основе контента одного обрабатываемого файла без учета семантического контекста связанных модулей, классов или общей архитектуры проекта. Данное ограничение приводит к тому, что полученные описания могут носить локальный характер и не всегда отражать роль сущности в масштабе всей системы. В связи с этим в качестве дальнейшего развития предполагается интеграция механизмов генерации с дополненным извлечением (RAG, Retrieval-Augmented Generation). Предполагается создание индексного хранилища векторных представлений всех документированных программных сущностей и их метаданных. При обработке нового модуля или класса система сможет извлекать релевантный контекст: описания родительских классов, интерфейсов, типов данных, а также примеры использования анализируемой сущности в смежных модулях. Таким образом, предложенная система автоматизированного документирования на основе статического анализа и генеративного искусственного интеллекта представляет собой действенный инструмент снижения порога входа в унаследованные проекты и поддержания актуальности проектной документации. Дальнейшая эволюция системы в направлении контекстно-осведомленной генерации с применением RAG-архитектуры позволит перейти от автоматического документирования к интеллектуальному моделированию предметной области программной системы с формированием полноценного семантического описания ее структуры и поведения. Труды Кольского научного центра РАН. Серия: Технические науки. 2026. Т. 17, № 1. С. 115-128. Transactions of the Kola Science Centre of r A s . Series: Engineering Sciences. 2026. Vol. 17, No. 1. P. 115-128. © Федоров А. М., Датьев И. О., Илясов М. О., Вишняков И. Г., 2026 1 2 6