Задача: проверка содержания шаблона Revit с получением рекомендаций от AI DeepSeak.
Решение: python плагин, он собирает данные из открытого файла, записывает в JSON файл, на основе него дает ответы, используя DeepSeek.
Установка
Для начала нужно установить PyRevit по ссылке
После этого скачать AVRO_BIM — Template Check, доступно в конце статьи
Распаковываем скачанное в:
C:\Users\%USERNAME%\AppData\Roaming\pyRevit\Extensions
Получаем API key от DeepSeek по ссылке
Вписываем DeepSeek ключ в файл avro_ai.py вместо YOUR_API_KEY_HERE:
C:\Users\%USERNAME%\AppData\Roaming\pyRevit\Extensions\AVRO_BIM.extension\lib\avro_ai.py
Template Check (версия 1.0)
Плагин протестирован на Revit 2022 и 2023 версии
Плагин Template Check (версия 1.0) представляет собой интеллектуальный ассистент для Revit, предназначенный для глубокого аудита BIM-шаблонов и моделей с использованием технологий искусственного интеллекта.
1. Глубокий аудит модели (Scanning Engine)
Основная задача плагина — автоматический сбор данных о структуре проекта. В версии 1.0 реализовано сканирование 16 ключевых разделов:
- Проектные данные: информация о проекте, уровни, сетки осей и связанные файлы.
- Элементы и стили: анализ семейств, типоразмеров, материалов, а также текстовых и размерных стилей.
- Параметры: проверка параметров типов, параметров проекта и общих параметров (Shared Parameters).
- Организация данных: аудит шаблонов видов, фильтров, спецификаций, листов и структуры Диспетчера проекта.
- Статистика: автоматический подсчет количества элементов по категориям.
2. Интеграция с ИИ (DeepSeek API)
Плагин использует библиотеку avro_ai.py для связи с моделью DeepSeek, что превращает обычный отчет в интерактивного консультанта:
- Интеллектуальный чат: после сканирования пользователь может задавать вопросы по модели в свободном стиле.
- Быстрые команды (Quick Actions): в интерфейс встроены готовые сценарии для мгновенной оценки:
- «Оценить шаблон»: получение общего балла по 10-балльной шкале с перечнем критических проблем.
- «ISO 19650»: проверка модели на соответствие международным стандартам.
- «Семейства»: аудит именования семейств и типов на наличие ошибок.
- «Шаблоны видов»: анализ полноты и достаточности настроенных видов в шаблоне.
3. Работа с данными и отчетность
Плагин предлагает инструменты для сохранения и обмена результатами анализа:
- Импорт/Экспорт JSON: результаты сканирования можно выгрузить в формате JSON для архивации или загрузить ранее созданный отчет для консультации с ИИ без повторного запуска Revit-скриптов.
- Сравнение с эталоном: функция загрузки эталонного JSON-файла позволяет сравнивать текущий проект с «идеальным» стандартом компании.
- Интерактивное «Дерево шаблона»: генерация визуальной карты структуры проекта в формате HTML для удобного просмотра вне Revit.
Технические особенности v1.0
- Совместимость: работает в версиях Revit от 2019 до 2025.
- Стек: написан на IronPython 2.7 с использованием pyRevit и .NET WebClient для работы с API.
- Интерфейс: современный темный UI, построенный на
System.Windows.Forms, с рендерингом Markdown-ответов от ИИ прямо в окне плагина.
Template Check (версия 1.1)
Плагин протестирован на Revit 2022 и 2023 версии, а также на 2024!
В версии 1.1 плагин Template Check получил обновления, направленные на улучшение пользовательского опыта (UX) и расширение аналитических возможностей. Основной акцент сделан на визуализацию ответов ИИ и функции сравнения моделей.
1. Глубокий аудит модели (Scanning Engine)
Главное изменение версии — полная переработка глубины анализа каждого из разделов. плагин научился правильно сканировать диспетчер проекта, виды, листы и спецификации.
2. Переход на интерактивный Web-интерфейс чата
Самое заметное изменение — замена стандартного текстового поля (RichTextBox) на полноценный WebBrowser.
- Markdown-рендеринг: Теперь ответы ИИ отображаются с качественной типографикой: заголовками, жирным текстом, списками и блоками кода с подсветкой.
- Стилизация: Весь чат теперь оформлен в современном темном стиле с использованием CSS, что делает чтение длинных отчетов BIM-менеджера гораздо удобнее.
3. Функция «Сравнение с эталоном» (Benchmarking)
В версии 1.1 появилась кнопка «Сравнить с эталоном», вынесенная в панель быстрого доступа.
- Механика: Пользователь может загрузить JSON-файл идеального шаблона (эталона), и ИИ проведет сравнительный анализ текущей модели относительно этого файла.
- Цель: Это позволяет мгновенно выявлять отклонения от корпоративных стандартов без ручного сопоставления параметров.
4. Улучшенная навигация и UX
Интерфейс стал более динамичным и информативным:
- Статус-бар: В нижнюю часть окна добавлены кнопки для быстрого экспорта/импорта данных и генерации интерактивной карты («Дерево шаблона»).
- Отображение контекста: В заголовке окна теперь выводится имя активного документа Revit, с которым работает плагин.
- Обновленные «Быстрые действия»: Панель пресетов (Оценка шаблона, ISO 19650 и др.) переработана для более компактного размещения над чатом.
5. Технические оптимизации
- Обработка данных: Оптимизирована функция
prepare_context_text, которая готовит данные для отправки в DeepSeek. Теперь она лучше структурирует информацию оShared Parameters и View Templates, делая ответы ИИ более точными. - Стабильность: Улучшена обработка ошибок при сканировании категорий элементов и стилей, что минимизирует риск вылета плагина на тяжелых моделях.
