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

— Создание страниц модулей (Units): для каждого модуля создается файл [UnitName].md. Страница включает техническое описание (исходное или сгенерированное ИИ), списки типов (//type) и глобальных переменных (//variable[not(parent::structure)]), извлеченные из XML, а также автоматически сформированный перечень всех классов модуля с гиперссылками. — Создание страниц классов (Classes): для каждого класса создается отдельная страница [ClassName].md. Страница содержит описание, иерархию наследования, секции методов, полей и свойств, сформированные на основе XPath-запросов к XML. Важным элементом является перекрестная ссылка «Источник: [[UnitName]]», устанавливающая связь между классом и его модулем. — Обеспечение целостности: при обработке файла, страница для которого уже существует, скрипт не перезаписывает ее полностью, а дополняет (например, добавляя ссылку на новый модуль, где встречается класс). Это позволяет накапливать знания о связях в проекте. 5. П убликация и поддержка актуальности вики -репозитория Финальная стадия, управляемая функциями publish_single_file и create_index_file, обеспечивает интеграцию результата в процесс коллективной разработки. # Инкрементальный коммит после обработки каждого файла publish_single_file() { cd "$wiki_clone_dir" git add . if !git diff --cached --quiet; then git commit -m "Добавлен/обновлён файл: $processed_file ($NOW)" git push origin main 2>/dev/null fi } # Создание навигационного индекса create_index_file() { cat > "$wiki_dir/Home.md" << EOF # Документация проекта ## Unit'bi (модули) EOF ls *.md | grep -v Home.md | sort | while read file; do echo "- [[${file%.md}]]" >> Home.md done } # Очистка временных данных rm-rf "$WIKI_CLONE_DIR" "$TMP_GIT_DIR" Листинг 5. Публикация в вики-репозиторий — Инкрементальные коммиты: после обработки каждого файла изменения в вики-директории ($WIKI_CLONE_DIR) сразу добавляются, коммитятся и пушатся в удаленный репозиторий. Такой подход минимизирует риск конфликтов и предоставляет разработчикам актуальную документацию в режиме, близком к реальному времени. — Генерирование навигационного индекса: после обработки всех файлов автоматически создается или обновляется главная страница Home.md. Она содержит два структурированных списка с гиперссылками: все документированные модули и все классы, что добавляет в уже сформированную вики возможность для оперативного поиска и обзора. — Очистка: по завершении работы все временные директории ($WIKI_CLONE_DIR, $TMP_GIT_DIR) рекурсивно удаляются. Последовательность взаимодействия компонентов системы визуализирована на диаграмме последовательностей (рис. 2). Предложенная архитектура обеспечивает высокую степень автоматизации, сохраняя гибкость за счет параметризации (URL репозиториев, пути, модель LLM) и устойчивость за счет обработки ошибок и идемпотентности операций. Труды Кольского научного центра РАН. Серия: Технические науки. 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 2