УВЕДОМЛЕНИЕ:

Это редакция v35 форка Studio 5000 AI Assistant, поддерживаемая независимо. По умолчанию используется Studio 5000 Logix Designer v35, но поддерживается любая установленная версия через флаг --version скрипта настройки (см. Выбор версии Studio 5000 ниже). Благодарность оригинальному проекту, на котором это основано: rivie13/studio5000-AI-Assistant (по умолчанию v36). Этот репозиторий — прототип — вы можете форкнуть его и сделать своим.

🤖 Studio 5000 AI-ассистент для программирования ПЛК

Этот революционный MCP-сервер (Model Context Protocol) преобразует программирование ПЛК, предоставляя генерацию кода на основе ИИ, создание подпрограмм L5X, создание реальных файлов .ACD и бесшовную интеграцию со Studio 5000. Преобразуйте спецификации на естественном языке непосредственно в работающую лестничную логику и полные проекты Studio 5000!

⚡ TL;DR — Настройка одной командой

# 1. Get Python 3.12 (NOT 3.11!) from python.org
python --version  # Must show 3.12.x

# 2. Clone the repo
git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
cd THE_Studio5000_AI_Assistant_V35

# 3. Run the setup script — installs everything and writes your config for you
python setup.py

setup.py определяет установленную версию Studio 5000 (по умолчанию v35), устанавливает requirements.txt, устанавливает wheel-файл Logix Designer SDK, если он найден, генерирует готовые к использованию файлы конфигурации MCP с правильными путями для вашей машины и запускает встроенный самотест. См. Выбор версии Studio 5000, если у вас не v35, и Что генерирует setup.py для того, что делать с созданными файлами.

Вот и всё! ✅ Перейдите к Настройке для Claude Desktop, если хотите настроить вручную, или просто укажите Claude Desktop/Claude Code на файлы, которые уже сгенерировал setup.py.

Related MCP server: tiacommander-mcp

🔀 Выбор версии Studio 5000

Этот форк по умолчанию использует v35, но вы не привязаны к нему. setup.py сканирует вашу машину на предмет всех установленных версий Logix Designer и позволяет выбрать:

# Auto-detect and prompt interactively (default: v35 if present)
python setup.py

# Force a specific version, e.g. the upstream project's v36
python setup.py --version 36

# Non-interactive, accept every default (CI / scripted installs)
python setup.py --yes

# Skip prompts but still write straight into Claude Desktop's config
python setup.py --version 37 --write-claude-desktop --yes

Если версия не обнаружена автоматически, скрипт использует стандартный путь установки Rockwell (...\Logix Designer\ENU\v<N>\Bin\Help\ENU\rs5000) для любого указанного номера — переопределите с помощью --doc-root на самом сервере (см. Шаг 5), если ваша установка находится в нестандартном месте.

📦 Что генерирует setup.py

Каждый файл ниже зависит от конкретной машины (абсолютные пути, ваш интерпретатор Python) и игнорируется git — перегенерируйте их в любое время, повторно запустив python setup.py:

mcp_config.json (без .local) остаётся в репозитории как простой шаблон для справки — не редактируйте его вручную, вместо этого запустите setup.py.

📚 Ресурсы для новых членов команды

🎯 Доступны полные руководства для команды:

• 📖 TEAM_USAGE_GUIDE.md — Полное руководство по рабочему процессу с реальными примерами

• ⚡ QUICK_REFERENCE_CARD.md — Ежедневные команды и ярлыки

• 🔧 TEAM_TROUBLESHOOTING_GUIDE.md — Частые проблемы и решения

🚀 Быстрый старт для коллег

Готовы использовать этот инструмент? Следуйте этим шагам:

Предварительные требования ⚠️ КРИТИЧЕСКИ ВАЖНО

• Python 3.12 (НЕ 3.11 или более ранние — SDK не будет работать!)

• Studio 5000 Logix Designer v35 или новее установлен на вашей машине

• Операционная система Windows (SDK Studio 5000 доступен только для Windows)

Шаги установки

1. Проверьте Python 3.12:

   python --version
   # Must show Python 3.12.x - if not, install Python 3.12 from python.org

2. Клонируйте и запустите настройку:

   git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
   cd THE_Studio5000_AI_Assistant_V35
   python setup.py

   Это установит зависимости, wheel-файл SDK и сгенерирует вашу конфигурацию за один шаг — см. TL;DR выше. Шаги 2–3 ниже — это ручной пошаговый эквивалент, если вы предпочитаете сделать это самостоятельно.

3. Установите Studio 5000 SDK (для файлов .ACD) — требуется только если вы пропускаете setup.py:

   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

4. Проверьте установку:

   python src/mcp_server/studio5000_mcp_server.py --test

   ✅ Должно показать: документация проиндексирована, SDK доступен, тесты проходят

5. Готово к использованию! — Сервер автоматически определит пути установки Studio 5000

Возникли проблемы? См. раздел Устранение неполадок ниже.

🚀 Возможности на основе ИИ

🧠 Преобразование естественного языка в код ПЛК

• Генерация кода с помощью ИИ: Преобразование простого английского в работающую лестничную логику

  • «Запустить двигатель при нажатии кнопки пуска и остановить при нажатии кнопки остановки» → Полная лестничная логика с правильной блокировкой пуска/остановки

• Умное распознавание шаблонов: Автоматически обнаруживает шаблоны пуска/остановки, таймеров, счетчиков и базового ввода/вывода

• Интеллектуальное создание тегов: Автоматически генерирует подходящие теги ввода/вывода с описательными именами

• Проверка инструкций: Проверяет сгенерированный код по официальной базе документации Studio 5000

📁 Генерация проекта L5X

• Создание структуры проекта: Генерирует файлы проекта L5X с программами, подпрограммами и тегами (может создавать подпрограммы для импорта в существующие проекты и может создавать пустые файлы L5X для ручной разработки)

• Поддержка нескольких контроллеров: Поддержка различных контроллеров Allen-Bradley (1756-L83E, 1756-L85E и т. д.)

• ⚠️ Текущее ограничение: Сгенерированные файлы L5X могут иметь проблемы с форматированием RLL, требующие ручного исправления

• Структурированный вывод: XML-структура соответствует схеме Studio 5000, но может потребовать проверки

• 💡 Лучшая практика: Используйте для шаблонов проектов, затем добавляйте логику вручную в Studio 5000

🏭 Создание реального проекта .ACD

• Интеграция с официальным SDK Studio 5000: Создает подлинные файлы .ACD с использованием официального SDK Rockwell

• Прямая совместимость со Studio 5000: Файлы .ACD открываются непосредственно в Studio 5000 без преобразования

• ✅ Создание пустого проекта: Чистые шаблоны ACD, готовые для ручной разработки (НАДЕЖНО)

• ⚠️ Создание полного проекта: Экспериментально — частичный импорт SDK для MainProgram/MainTask (НЕНАДЕЖНО)

• Контроль версий: Поддерживает разные основные ревизии Studio 5000 (по умолчанию v35)

• 💡 Рекомендуется: Используйте создание пустого ACD + ручной импорт L5X

🔍 Векторный семантический поиск

• Интеллектуальный анализ L5X: Семантический поиск по огромным файлам L5X (протестировано на 49k+ строках)

• Обработка производственного масштаба: Работает со сложными проектами промышленной автоматизации

• Умная вставка кода: ИИ находит оптимальные позиции для новой логики в существующих подпрограммах

• Анализ зависимостей: Автоматическое обнаружение связей и зависимостей компонентов

• Распознавание шаблонов: Понимает шаблоны управления конвейером, логику энкодера, обработку ошибок и таймеров

• Векторная база данных FAISS: Молниеносный семантический поиск с подобием на основе эмбеддингов

📐 Анализ технических чертежей

• PDF-инженерные чертежи: Извлечение и поиск по техническим чертежам (P&IDs, электрические схемы, диаграммы логики управления)

• Интеграция с AutoCAD: Разбор PDF-файлов, созданных в CAD, с богатым текстовым и векторным графическим содержимым

• Контекст оборудования: Автоматический поиск чертежей, на которые ссылаются теги оборудования и системные компоненты

• Улучшение с помощью Vision AI: Расширенный анализ сложных технических диаграмм и соединений оборудования

• Возможность перекрестных ссылок: Связывание чертежей с существующим кодом L5X и базами тегов для полного понимания системы

📊 Расширенная система анализа L5X

• Реальное производственное тестирование: Проверено на реальных файлах L5X размером 2,9 МБ из промышленных систем

• Оценка сложности: Автоматическая оценка сложности подпрограмм и необходимости рефакторинга

• Сопоставление компонентов: Отслеживает таймеры, счетчики, теги и их взаимосвязи

• Хирургические модификации: Точная вставка ступеней без нарушения существующей логики

• Профессиональный рабочий процесс: Анализ только для чтения с возможностями модификации на основе SDK

📚 Доступ к документации

• Полная база данных инструкций: Поиск по официальной документации Studio 5000

• Умный поиск: Поиск инструкций ПЛК по имени, описанию, категории или функциональности

• Подробная информация: Получение исчерпывающих сведений о синтаксисе, параметрах и использовании инструкций

• Просмотр по категориям: Просмотр инструкций по функциональным категориям (Аварийная сигнализация, Математика, Движение, Таймер и т. д.)

• Поддержка языков: Информация о том, какие языки программирования поддерживают каждую инструкцию (Ladder, ST, FBD)

• Проверка в реальном времени: Мгновенная проверка с использованием официальной документации Rockwell

📋 Подробное руководство по установке

Предварительные требования — ПРОЧТИТЕ ЭТО СНАЧАЛА! ⚠️

🚨 КРИТИЧЕСКИ ВАЖНОЕ ТРЕБОВАНИЕ: ТОЛЬКО Python 3.12

• Этот проект ТРЕБУЕТ Python 3.12 — более ранние версии не будут работать

• SDK Studio 5000 несовместим с Python 3.11 и более ранними версиями

• Сначала проверьте версию Python перед продолжением

Системные требования:

• Python 3.12.x (Загрузите с python.org)

• Studio 5000 Logix Designer v35 или новее установлен

• Операционная система Windows (SDK Studio 5000 доступен только для Windows)

• Права администратора могут потребоваться для начальной настройки

Пошаговая настройка

Шаг 1: Установите Python 3.12

1. Загрузка: Перейдите на python.org и загрузите Python 3.12

2. Установка: Во время установки ОТМЕТЬТЕ «Add Python to PATH» ✅

3. Проверка: Откройте командную строку и выполните:

   python --version
   # Must show: Python 3.12.x (if not, restart command prompt)

Шаг 2: Получите проект

1. Клонируйте репозиторий:

   git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
   cd THE_Studio5000_AI_Assistant_V35

2. Предпочитаете путь одной командой? Запустите python setup.py сейчас и перейдите к Шагу 4 — он выполнит шаги 3 и 3.5 за вас, включая выбор версии Studio 5000. Ручные шаги ниже предназначены для тех, кто хочет полный контроль над каждым этапом.

Шаг 3: Установите зависимости (КРИТИЧЕСКИ ВАЖНО!)

1. Установите все необходимые пакеты:

   pip install -r requirements.txt

   Это устанавливает:

   • Основные компоненты: BeautifulSoup, обработка XML, асинхронная поддержка

   • ИИ и векторный поиск: PyTorch, sentence-transformers, векторная база данных FAISS

   • Семантический анализ: Векторные эмбеддинги для поиска инструкций и L5X

   • Производительность: Оптимизированные версии для производственного использования

   Если возникают ошибки, попробуйте:

   python -m pip install --upgrade pip
   pip install -r requirements.txt

   Примечание: Компоненты векторной базы данных (torch, sentence-transformers, faiss-cpu) включены для возможностей семантического поиска. Они обеспечивают расширенный анализ L5X и функции поиска инструкций.

Шаг 3.5: Установите Studio 5000 SDK (КРИТИЧЕСКИ ВАЖНО для файлов .ACD!) 🚨

⚠️ КОЛЛЕГИ ДОЛЖНЫ ВЫПОЛНИТЬ ЭТОТ ШАГ — Пропустите, только если вам не нужно создание файлов .ACD

1. Найдите wheel-файл SDK в вашей установке Studio 5000:

   # Look for this file (version may vary):
   dir "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

2. Установите wheel-файл SDK:

   # Replace with your actual file path and version:
   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-2.0.1-py3-none-any.whl"

3. Альтернатива — если вы не можете найти wheel-файл:

   # Navigate to the SDK directory and install from there:
   cd "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python"
   pip install logix_designer_sdk-*-py3-none-any.whl

Без этого шага: Документация и генерация L5X будут работать, но создание файлов .ACD завершится ошибкой!

Шаг 4: Проверьте установку ✅

1. Выполните тестовую команду:

   python src/mcp_server/studio5000_mcp_server.py --test

2. Вы должны увидеть:

   • ✅ «Документация успешно проиндексирована» (найдено 500+ инструкций)

   • ✅ «SDK Available: True» (если вы правильно установили wheel-файл SDK)

   • ✅ «SDK Available: False» (нормально, если вы пропустили установку SDK — генерация L5X все равно работает)

   • ✅ Примеры результатов поиска и тесты генерации кода

3. Если SDK Available показывает False, но вы установили wheel-файл:

   • Проверьте, что путь к wheel-файлу был правильным

   • Попробуйте: python -c "import logix_designer_sdk; print('SDK OK')"

4. Если тесты полностью не проходят, обратитесь к разделу Устранение неполадок

🎉 Вы готовы использовать инструмент! 🎉

Сервер автоматически обнаружит пути установки вашего Studio 5000. Перейдите к разделу Конфигурация для Claude Desktop, чтобы начать использовать его!

Шаг 5: Настройка переменных среды (только для продвинутых пользователей)

⚠️ ПРОПУСТИТЕ ЭТОТ ШАГ — Нужен только если Studio 5000 установлен в нестандартных местах

Вариант A: Настройка через переменные среды Windows

• Откройте «Свойства системы» → «Переменные среды»

• Добавьте следующие пользовательские или системные переменные:

STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python
PYTHON312_PATH=C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe

Вариант B: Создайте файл .env (в корне проекта):

STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python
PYTHON312_PATH=C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe

4. Найдите пути к вашему Studio 5000:

   Путь к документации: Найдите этот файл в вашей установке Studio 5000:

   <Studio5000_Install>\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm

   Стандартные расположения:

   • C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000

   • C:\Program Files\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000

   Путь к SDK: Найдите папку SDK Python:

   C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python

5. Проверьте сервер:

   # Test with environment variables (recommended)
   python src/mcp_server/studio5000_mcp_server.py --test
   
   # Or test with explicit path
   python src/mcp_server/studio5000_mcp_server.py --doc-root "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000" --test

   При успешном выводе должно отображаться:

   • Индексация документации (найдены сотни инструкций)

   • Примеры результатов поиска

   • Тест генерации ИИ-кода

   • Статус доступности SDK

Конфигурация для Claude Desktop

Если вы запустили python setup.py, это уже сделано — он записал ваши реальные, правильные пути (в какую бы папку вы ни клонировали, каким бы ни было ваше имя пользователя Windows) в claude_desktop_config.snippet.json, или объединил их напрямую в конфиг Claude Desktop, если вы передали --write-claude-desktop. Ниже ничего заполнять вручную не нужно.

Настраиваете вручную? Добавьте следующее в файл конфигурации Claude Desktop (обычно находится по адресу %APPDATA%\Claude\config.json). Замените YourUsername и имя папки на то место, куда вы на самом деле клонировали этот репозиторий — папка называется THE_Studio5000_AI_Assistant_V35 только если вы клонировали её с именем по умолчанию:

Конфигурация для Windows

Вариант A: Использование переменных среды (рекомендуется)

{
  "mcpServers": {
    "studio5000-ai-assistant": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35\\src\\mcp_server\\studio5000_mcp_server.py"
      ],
      "cwd": "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35",
      "env": {
        "STUDIO5000_DOC_PATH": "C:\\Program Files (x86)\\Rockwell Software\\Studio 5000\\Logix Designer\\ENU\\v35\\Bin\\Help\\ENU\\rs5000",
        "STUDIO5000_SDK_PATH": "C:\\Users\\Public\\Documents\\Studio 5000\\Logix Designer SDK\\python"
      }
    }
  }
}

Вариант B: Использование аргументов командной строки

{
  "mcpServers": {
    "studio5000-ai-assistant": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35\\src\\mcp_server\\studio5000_mcp_server.py",
        "--doc-root",
        "C:\\Program Files (x86)\\Rockwell Software\\Studio 5000\\Logix Designer\\ENU\\v35\\Bin\\Help\\ENU\\rs5000"
      ],
      "cwd": "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35"
    }
  }
}

Важные замечания:

• Замените YourUsername на ваше реальное имя пользователя Windows

• Отрегулируйте пути к Studio 5000 в соответствии с вашей установкой

• Используйте Python 3.12 — при необходимости укажите полный путь: "command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"

Альтернатива: использование Cursor IDE

Если вы используете Cursor IDE, MCP-сервер доступен по умолчанию при работе в рабочей области этого проекта. Сервер автоматически использует переменные среды, если они заданы, или вы можете настроить его вручную в настройках MCP в Cursor. Настоятельно рекомендуем использовать Cursor IDE для этого проекта и настроить его через настройки MCP в Cursor (mcp.json)

🛠️ Доступные ИИ-инструменты

После настройки в ваших ИИ-диалогах будут доступны следующие мощные инструменты:

🧠 Инструменты генерации ИИ-кода

1. Генерация релейно-контактной логики

Инструмент: generate_ladder_logic Параметры:

• specification (строка): Описание желаемого поведения ПЛК на естественном языке

Возможности:

• Распознавание шаблонов: Автоматически определяет шаблоны пуска/останова, таймеров, счётчиков и базового ввода/вывода

• Умная генерация тегов: Создаёт подходящие имена тегов и типы данных

• Проверка инструкций: Использует базу документации Studio 5000 для проверки

Пример: «Создайте логику для запуска двигателя кнопкой пуска и остановки кнопкой останова»

2. Создание проекта L5X

Инструмент: create_l5x_project Параметры:

• project_spec (объект): Спецификация проекта, включающая:

  • name (строка): Имя проекта

  • controller_type (строка): Модель контроллера (например, "1756-L83E")

  • specification (строка): Описание логики на естественном языке

  • save_path (необязательная строка): Путь к файлу для сохранения L5X-файла

Результат: Полный файл проекта L5X Studio 5000, готовый к импорту

3. Создание пустого шаблона .ACD ✅

Инструмент: create_acd_project
Параметры:

• project_spec (объект): Спецификация проекта ACD, включающая:

  • name (строка): Имя проекта

  • controller_type (строка): Модель контроллера

  • major_revision (целое число): Версия Studio 5000 (по умолчанию 36)

  • save_path (строка): Путь к файлу для .ACD-файла

Результат: Пустой .ACD-файл, созданный с помощью официального SDK Studio 5000 — готов к ручной разработке

⚠️ Важно: Создаёт только ПУСТЫЕ проекты. Утверждения о «полных проектах с MainProgram/MainTask» ненадёжны.

💡 Рекомендуемый рабочий процесс: Создать пустой ACD → Разрабатывать логику вручную в Studio 5000

4. Проверка релейно-контактной логики ⚡ Быстрая и надёжная проверка

Инструмент: validate_ladder_logic Параметры:

• logic_spec (объект): Содержит:

  • ladder_logic (строка): Код релейно-контактной логики для проверки

  • instructions_used (массив): Список использованных инструкций ПЛК

🎯 Быстрая система проверки:

Готовая к производству быстрая проверка ⚡

• Скорость: 0,001–0,020 секунды

• Надёжность: 100% надёжность, без внешних зависимостей

• Обнаруживает: Синтаксические ошибки, недопустимые инструкции, несбалансированные скобки, проблемы структуры, логические шаблоны

• Требования: Нет — работает всегда

• Покрытие: Проверяет по более чем 500 инструкциям Studio 5000

Результат: Полный отчёт о проверке с ошибками, предупреждениями и предложениями

💡 Почему быстрая проверка лучше: Мгновенные результаты, 100% надёжность, выявляет все критические ошибки программирования ПЛК и бесшовно интегрируется в ваш рабочий процесс разработки. Не требует сложной настройки!

📚 Инструменты документации

5. Поиск инструкций

Инструмент: search_instructions Параметры:

• query (строка): Поисковый запрос (имя инструкции, описание, функциональность)

• category (необязательная строка): Фильтр по категории инструкций

Возможности: Поиск по официальной базе документации Studio 5000

6. Получение сведений об инструкции

Инструмент: get_instruction Параметры:

• name (строка): Точное имя инструкции (например, "TON", "MOV", "ADD", "PID")

Результат: Полная информация об инструкции, включая синтаксис, параметры, примеры и поддерживаемые языки

7. Список категорий

Инструмент: list_categories Параметры: Нет (требуется фиктивный параметр)

Результат: Все доступные категории инструкций (Alarm, Math, Motion, Timer и т. д.)

8. Список инструкций по категории

Инструмент: list_instructions_by_category Параметры:

• category (строка): Название категории

Результат: Все инструкции в указанной категории

9. Получение синтаксиса инструкции

Инструмент: get_instruction_syntax Параметры:

• name (строка): Имя инструкции

Результат: Подробный синтаксис и информация о параметрах инструкции

🔍 Инструменты анализа L5X и векторного поиска

10. Поиск содержимого L5X

Инструмент: search_l5x_content Параметры:

• query (строка): Поисковый запрос на естественном языке (например, "счётчик импульсов энкодера", "логика обнаружения застревания")

• project_file (строка): Путь к L5X-файлу для поиска

• max_results (целое число): Максимальное количество возвращаемых результатов (по умолчанию: 5)

Возможности: Семантический поиск по существующим L5X-файлам для поиска релевантных логических шаблонов

11. Анализ структуры проекта L5X

Инструмент: analyze_routine_structure Параметры:

• project_file (строка): Путь к L5X-файлу для анализа

• routine_name (необязательная строка): Конкретная подпрограмма для анализа

Результат: Анализ сложности, карта зависимостей и рекомендации по рефакторингу

12. Поиск оптимальной точки вставки

Инструмент: find_insertion_point Параметры:

• project_file (строка): Целевой L5X-файл

• new_logic_description (строка): Описание логики для вставки

• routine_name (строка): Целевая подпрограмма для вставки

Результат: Рекомендуемая позиция в цепи с оценкой уверенности для оптимального размещения кода

13. Умная вставка логики

Инструмент: smart_insert_logic Параметры:

• project_file (строка): Целевой L5X-файл

• routine_name (строка): Целевая подпрограмма

• logic_specification (строка): Описание новой логики на естественном языке

• insertion_point (целое число): Позиция цепи для вставки

Возможности: Вставка логики, сгенерированной ИИ, в оптимальные позиции с анализом существующего кода

📚 Инструменты поиска по документации SDK

14. Поиск по документации SDK

Инструмент: search_sdk_documentation Параметры:

• query (строка): Запрос на естественном языке об операциях SDK

• limit (целое число): Максимальное количество возвращаемых результатов (по умолчанию: 10)

Возможности: Поиск по документации SDK Studio 5000 с семантическим пониманием

15. Получение сведений об операции SDK

Инструмент: get_sdk_operation_info Параметры:

• name (строка): Имя операции SDK

• operation_type (необязательная строка): Фильтр по типу (method, class, enum, example)

Результат: Подробная информация об операции SDK с примерами и параметрами

📐 Инструменты для технических чертежей PDF

16. Индексация PDF-чертежей

Инструмент: index_pdf_drawings Параметры:

• pdf_file_path (строка): Путь к PDF-файлу с техническими чертежами

• force_rebuild (логическое значение): Принудительная переиндексация существующего кэша

• use_vision_ai (логическое значение): Включить расширенный анализ с помощью ИИ-зрения

Возможности: Обработка и индексация технических PDF-чертежей для семантического поиска

17. Поиск по техническим чертежам

Инструмент: search_drawings Параметры:

• query (строка): Поисковый запрос на естественном языке (например, "электрические соединения двигателя M001")

• drawing_type_filter (необязательная строка): Фильтр по типу (electrical, pid, logic, io_list)

• equipment_filter (необязательная строка): Фильтр по тегу оборудования

Результат: Ранжированные результаты поиска с контекстом чертежа и ссылками на страницы

18. Поиск контекста оборудования

Инструмент: find_equipment_context Параметры:

• equipment_tag (строка): Идентификатор оборудования (например, "M001", "CV-001")

• context_type (необязательная строка): Тип необходимого контекста (electrical, process, safety)

Возможности: Поиск всех чертежей и документации, связанных с конкретным оборудованием

🎯 Три мощных подхода к созданию проектов ПЛК

Ваш MCP-сервер поддерживает ТРИ различных подхода к созданию проектов ПЛК, каждый из которых оптимизирован для разных сценариев использования:

🥇 Подход 1: Генерация L5X + ручной импорт (С ОГРАНИЧЕНИЯМИ)

🎯 Генерирует: Структуру проекта L5X с MainProgram и MainTask
⚠️ Результат: L5X-файл, который может потребовать ручного исправления форматирования RLL
🎯 Лучше всего подходит для: Шаблонов проектов и создания базовой структуры
🎯 Ручные шаги:

1. Сгенерируйте шаблон L5X (30 секунд)

2. Исправьте проблемы форматирования RLL в текстовом редакторе

3. Импортируйте исправленный L5X в Studio 5000

Использование: «Создайте шаблон проекта L5X для управления конвейером»
Инструмент: create_l5x_project

⚡ Реальная оценка:

• ⚠️ Сгенерированный L5X может иметь проблемы с XML-форматированием

• ✅ Хорошо подходит для шаблонов структуры проекта

• ✅ Импортируйте только исправленную логику, которая вам нужна

• ✅ Профессиональный рабочий процесс после проверки файлов

🥈 Подход 2: Пустые шаблоны .ACD (НАДЁЖНО)

✅ Генерирует: Пустой файл проекта .ACD (чистый шаблон)
✅ Результат: Пустой проект, который открывается напрямую в Studio 5000
✅ Лучше всего подходит для: Отправной точки для полностью ручной разработки
🛠️ Ручные шаги: Создайте MainProgram и MainTask самостоятельно, разрабатывайте логику вручную

Использование: «Создайте пустой шаблон .ACD для ручной разработки»
Инструмент: create_acd_project

Почему это работает:

• ✅ 100% надёжное создание пустого проекта

• ✅ Нет сложных операций SDK, которые могут завершиться ошибкой

• ✅ Чистая основа для ручной разработки

🥉 Подход 3: Только генерация ИИ-логики (для существующих проектов)

🧠 Генерирует: Профессиональную релейно-контактную логику с проверкой
🧠 Результат: Готовый к копированию код релейно-контактной логики
🧠 Лучше всего подходит для: Добавления логики в существующие корпоративные проекты
🧠 Ручные шаги: Скопируйте сгенерированную логику в свои существующие подпрограммы

Использование: «Сгенерируйте логику управления конвейером для моего существующего проекта»
Инструмент: generate_ladder_logic

🎯 Текущий статус и рекомендуемый рабочий процесс

Что действительно работает: ✅ Генерация ИИ-логики + Пустые шаблоны ACD + Ручная разработка

Реалистичный промышленный рабочий процесс:

1. Генерация AI-логики: «Создать управление конвейером с обнаружением затора» → Профессиональный код релейно-контактной логики

2. Создание пустого ACD: Чистый шаблон проекта, готовый к разработке

3. Ручная разработка: Скопируйте логику в Studio 5000, создайте MainProgram/MainTask вручную

4. Готово к производству: Полностью функциональная логика, разработанная с помощью AI

Почему это честно и практично:

• ✅ 100% надежное создание пустого ACD — без сложных сбоев

• ✅ AI-сгенерированная логика работает — хорошая основа для ручной разработки

• ✅ Профессиональный рабочий процесс — AI помогает, инженер-человек проверяет и внедряет

• ✅ Ноль проблем с импортом — без битого XML или сложностей с SDK

Реальная оценка расширенных функций:

• ⚠️ Генерация L5X: Создает структуру, но может потребовать исправлений XML перед импортом

• ⚠️ Полные проекты ACD: Экспериментальные функции SDK, которые часто дают сбой

• ✅ Быстрая проверка: 100% надежность для выявления ошибок логики

• ✅ Векторный поиск: Отлично работает для анализа существующих проектов

💡 Примеры использования

После настройки MCP-сервера вы можете задавать вопросы и генерировать код, например:

🧠 Примеры генерации AI-кода

• «Создайте релейно-контактную логику для запуска двигателя при нажатии кнопки пуска и остановки при нажатии кнопки стопа»

• «Сгенерируйте систему управления конвейером с пуском, остановкой и аварийной остановкой»

• «Создайте таймер задержки на 5 секунд для соленоидного клапана»

• «Постройте релейно-контактную логику для управления насосом с режимами авто/ручной и счетчиком наработки часов»

• «Разработайте трехпозиционную сборочную линию с блокировками и схемами безопасности»

📁 Примеры создания проектов

• «Создайте полный проект .ACD с логикой управления конвейером и защитными блокировками» → Полный .ACD с MainProgram + логикой

• «Сгенерируйте проект .ACD для управления двигателем для контроллера 1756-L83E» → Готовый к использованию файл .ACD

• «Создайте полный проект Studio 5000 L5X для управления двигателем с функциями пуска/останова» → L5X для импорта

• «Постройте полный проект L5X для 3-позиционной сборочной линии с защитными блокировками» → Сложные проекты L5X

• «Создайте пустой шаблон .ACD для ручной разработки» → Чистые файлы шаблонов

📚 Примеры документации

• «Какие инструкции таймеров доступны в Studio 5000?»

• «Покажите полный синтаксис и параметры для инструкции PID»

• «Какие все инструкции управления движением доступны?»

• «Как использовать инструкцию GSV (Get System Value) в релейно-контактной логике?»

• «В чем разница между инструкциями таймеров TON, TOF и RTO?»

🔍 Примеры проверки

• «Проверьте эту релейно-контактную логику: XIC(START)XIO(STOP)OTE(MOTOR)»

• «Проверьте, правильно ли я использую инструкцию таймера TON с этими параметрами»

• «Убедитесь, что моя логика счетчика соответствует лучшим практикам Studio 5000»

🔍 Примеры анализа L5X и векторного поиска

• «Найдите в моем существующем проекте конвейера логику подсчета импульсов энкодера»

• «Найдите все шаблоны обнаружения неисправностей на основе таймеров в моем файле L5X»

• «Проанализируйте сложность моей подпрограммы отслеживания сортировщика»

• «Куда мне вставить логику обнаружения затора в моей существующей подпрограмме конвейера?»

• «Найдите всю логику управления скоростью VFD в моих производственных файлах L5X»

• «Покажите карту зависимостей для моей системы обратной связи по энкодеру»

📚 Примеры поиска по документации SDK

• «Как использовать метод LogixProject.partial_import_rungs_from_xml_file?»

• «Какие все доступные методы SDK для манипуляции тегами?»

• «Покажите примеры использования Studio 5000 SDK для создания проектов»

• «Найдите операции SDK, связанные с анализом и модификацией подпрограмм»

📐 Примеры анализа технических чертежей

• «Индексируйте PDF технических чертежей для моего проекта конвейерной системы Amazon»

• «Найдите все электрические соединения для двигателя M001 на чертежах»

• «Покажите диаграммы P&ID, связанные с конвейером CV-001»

• «Какие защитные блокировки показаны для отклоняющих заслонок на чертежах?»

• «Найдите схемы управления логикой для системы отслеживания сортировщика»

• «Ищите на чертежах проводку и соединения датчиков обнаружения затора»

🏭 Реальные приложения

• «Сгенерируйте релейно-контактную логику для системы автомойки с 5 последовательными шагами»

• «Создайте полный проект для упаковочной линии с управлением конвейером и подсчетом продукции»

• «Постройте систему контроля температуры с ПИД-регулятором и обработкой аварийных сигналов»

AI автоматически использует инструменты MCP-сервера для предоставления точной, актуальной информации на основе вашей фактической документации Studio 5000 и генерирует рабочий код ПЛК.

🔄 Ручной рабочий процесс импорта (рекомендуется)

Пошагово: от естественного языка до рабочего кода ПЛК

Сценарий: Вам нужна логика управления конвейером с обнаружением затора

Шаг 1: Сгенерируйте проект L5X

Спросите вашего AI-ассистента:

«Создайте полный проект L5X для управления конвейером с обнаружением затора с использованием фотоэлементов на входе и выходе»

Результат: Полный файл L5X с:

• ✅ MainProgram и MainTask

• ✅ Профессиональная релейно-контактная логика

• ✅ Все необходимые теги с описаниями

• ✅ Проверенные инструкции

Шаг 2: Импортируйте в Studio 5000

1. Откройте Studio 5000 с вашим существующим проектом (или создайте новый)

2. Перейдите: Файл → Импорт

3. Выберите: Ваш сгенерированный файл L5X

4. Выберите: Импорт MainProgram (или конкретных компонентов)

5. Нажмите: Импорт

6. Готово! — Рабочая логика готова к тестированию

Шаг 3: Настройте и протестируйте

• Сопоставьте ваши адреса ввода/вывода с сгенерированными тегами

• Протестируйте логику в вашем конкретном приложении

• Измените по мере необходимости для ваших требований

🏭 Для корпоративных проектов

• Используйте существующие корпоративные шаблоны ACD

• Генерируйте только ту логику, которая вам нужна

• Импортируйте в установленную структуру проекта

• Соблюдайте ваши стандарты кодирования и практики

⚡ Профессиональные советы

• Генерируйте несколько файлов L5X для разных разделов (безопасность, процесс, ввод/вывод)

• Импортируйте выборочно — выбирайте только программы, только теги или только конкретные подпрограммы

• Удобно для контроля версий — файлы L5X отлично работают с Git

• Командное сотрудничество — делитесь сгенерированными файлами L5X с членами команды

Устранение неполадок

❗ Критические проблемы

1. Несоответствие версии Python

Проблема: MCP-сервер запускается, но функции SDK не работают, или возникают ошибки импорта.

Решение:

# Check your Python version
python --version
# Must show 3.12.x

# If not 3.12, install Python 3.12 and use full path in Claude config:
"command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"

Почему: Studio 5000 SDK требует именно Python 3.12. Более ранние версии вызовут сбои импорта SDK.

2. Путь к документации не найден

Проблема: «Файл главного индекса не найден» или «Инструкции не найдены»

Решение — Найдите путь к вашей документации:

1. Откройте Проводник и найдите: 17691.htm

2. Посмотрите в этих распространенных местах:

   C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm
   C:\Program Files\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm
   C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v37\Bin\Help\ENU\rs5000\17691.htm

3. Установите правильный путь (все, кроме имени файла):

   # Via environment variable
   set STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
   
   # Or via command line
   python src/mcp_server/studio5000_mcp_server.py --doc-root "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000" --test

3. SDK недоступен

Проблема: «Studio 5000 SDK недоступен» или «Импорт SDK не удался»

Наиболее распространенная причина: Вы не установили файл колеса SDK! ⚠️

Решение:

1. 🚨 КРИТИЧЕСКИ ВАЖНО: Сначала установите файл колеса SDK:

   # Find and install the wheel file (most teammates miss this step!)
   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

2. Проверьте установку SDK:

   • Ищите: C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\

   • Если отсутствует, переустановите Studio 5000 с компонентами SDK

3. Проверьте, что SDK работает:

   # Test if SDK is now available
   python -c "import logix_designer_sdk; print('SDK OK')"

4. Если все еще не работает, установите путь к SDK:

   set STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python

⚠️ Распространенные проблемы настройки

4. Сервер не запускается

Симптомы: Сервер немедленно падает или показывает ошибки JSON-RPC.

Решения:

• Проверьте путь к Python в конфигурации Claude — используйте полный путь к Python 3.12

• Проверьте рабочую директорию — "cwd" должен указывать на корень проекта

• Проверьте права доступа к файлам — убедитесь, что есть доступ на чтение ко всем файлам проекта

• Протестируйте изолированно:

  python src/mcp_server/studio5000_mcp_server.py --test

5. Переменные окружения не работают

Проблема: Сервер все еще использует жестко заданные пути, несмотря на установленные переменные окружения.

Решения:

1. Перезапустите командную строку/IDE после установки переменных окружения

2. Проверьте имена переменных (чувствительны к регистру):

   • STUDIO5000_DOC_PATH

   • STUDIO5000_SDK_PATH

   • PYTHON312_PATH

3. Проверьте переменные окружения:

   echo %STUDIO5000_DOC_PATH%
   echo %STUDIO5000_SDK_PATH%

6. Проблемы с конфигурацией Claude Desktop

Проблема: MCP-сервер не появляется в Claude Desktop.

Решения:

1. Проверьте синтаксис config.json — используйте валидатор JSON

2. Полностью перезапустите Claude Desktop после изменений конфигурации

3. Используйте абсолютные пути — никаких относительных путей в конфигурации Claude

4. Проверьте журналы Claude в %APPDATA%\Claude\logs\

🔧 Расширенное устранение неполадок

Быстрая проверка: 100% надежность, нулевая настройка

✅ Текущий статус: Система быстрой проверки

Система теперь использует готовую к производству быструю проверку, которая обеспечивает мгновенные, надежные результаты:

Почему быстрая проверка лучше:

• ✅ Мгновенные результаты: время проверки 0.001–0.020 секунды

• ✅ 100% надежность: нет внешних зависимостей или требований к сервисам

• ✅ Полное покрытие: проверяет по 500+ инструкциям Studio 5000

• ✅ Нулевая настройка: работает сразу на любой системе

• ✅ Готово к производству: выявляет все критические ошибки программирования ПЛК

Покрытие проверки:

• ✅ Проверка синтаксиса: сбалансированные скобки, правильный формат инструкций

• ✅ Проверка инструкций: по официальному набору инструкций Studio 5000

• ✅ Проверка структуры: логические шаблоны и лучшие практики

• ✅ Отчеты об ошибках: подробные сообщения об ошибках с номерами строк

• ✅ Система предупреждений: выявляет потенциальные проблемы и улучшения

Больше никакой сложной настройки!

Система вышла за рамки зависимостей проверки SDK. Быстрая проверка обеспечивает все обнаружение ошибок, необходимое для профессиональной разработки ПЛК, без сложности настройки, зависимостей от сервисов или проблем с надежностью.

🔧 Расширенное устранение неполадок

7. Несколько версий Python

Если у вас установлено несколько версий Python:

# Use specific Python 3.12 executable
C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe src/mcp_server/studio5000_mcp_server.py --test

# Or create virtual environment with Python 3.12
py -3.12 -m venv studio5000_env
studio5000_env\Scripts\activate
pip install -r requirements.txt

8. Корпоративные/сетевые ограничения

Проблема: Нет доступа к файлам документации из-за прав.

Решения:

• Запускайте от имени администратора при тестировании

• Проверьте исключения антивируса для каталогов Python и Studio 5000

• Проверьте доступ к сетевому диску, если Studio 5000 находится в сетевой папке

9. Совместимость версий Studio 5000

Проблема: Другая версия Studio 5000, чем v35.

Решения:

• Обновите путь к документации в соответствии с вашей версией (v37, v38 и т. д.)

• Обновите параметр major_revision при создании проекта .ACD

• Проверьте совместимость версий SDK

🧪 Команды тестирования

Проверьте вашу настройку с помощью этих команд:

# Test 1: Python version
python --version

# Test 2: Basic server test
python src/mcp_server/studio5000_mcp_server.py --test

# Test 3: Documentation path
dir "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm"

# Test 4: SDK availability (after installing wheel file)
python -c "import logix_designer_sdk; print('SDK Available')"

# Test 5: Environment variables
echo %STUDIO5000_DOC_PATH%
echo %STUDIO5000_SDK_PATH%

📞 Получение помощи

Если у вас все еще есть проблемы:

1. Запустите тестовую команду и сохраните полный вывод

2. Проверьте версию Python и пути установки Studio 5000

3. Убедитесь, что все пути к файлам существуют, прежде чем сообщать о проблемах

4. Включите вашу точную конфигурацию при обращении за помощью

Тестирование сервера

Инструкции по тестированию см. в Шаге 4 в руководстве по установке выше.

Технические детали

Архитектура

MCP-сервер состоит из четырех основных компонентов:

1. Парсер документации (studio5000_mcp_server.py):

   • Разбирает HTML-файлы документации с помощью BeautifulSoup

   • Строит индекс всех инструкций в памяти

   • Извлекает имена инструкций, категории, описания, синтаксис и параметры

   • Обеспечивает быстрый поиск и извлечение информации

2. AI-ассистент кода (ai_assistant/code_assistant.py):

   • Разбор естественного языка с распознаванием шаблонов

   • Генерация релейно-контактной логики для шаблонов пуска/останова, таймеров, счетчиков

   • Умное создание тегов с соответствующими типами данных

   • Проверка кода с использованием базы данных документации

3. Генератор L5X (code_generator/l5x_generator.py):

   • Генерация XML-файлов проекта L5X

   • Полная структура проекта с программами, подпрограммами и тегами

   • Соответствие схеме Studio 5000

   • XML-вывод с красивым форматированием

4. Интерфейс Studio 5000 SDK (sdk_interface/studio5000_sdk.py):

   • Создание реальных проектов .ACD с использованием официального Rockwell SDK

   • Требование Python 3.12 для совместимости с SDK

   • Генерация шаблона пустого проекта

   • Прямая интеграция со Studio 5000

Протокол MCP

• Следует спецификации Model Context Protocol для интеграции с ИИ

• Взаимодействие через JSON-RPC 2.0 через stdin/stdout

• Архитектура на основе инструментов с 15+ доступными инструментами

• Возможности семантического поиска на основе векторных представлений

• Анализ L5X-файлов производственного масштаба

• Асинхронная поддержка всех операций

📁 Структура проекта

THE_Studio5000_AI_Assistant_V35/        # (folder name is whatever you clone it as)
├── setup.py                             # One-command installer — run this first
├── src/                                # Main source code
│   ├── mcp_server/
│   │   └── studio5000_mcp_server.py    # Main MCP server with AI features
│   ├── code_generator/
│   │   ├── l5x_generator.py            # L5X project file generation
│   │   └── templates/                  # L5X XML templates
│   ├── ai_assistant/                   # Enhanced AI assistance
│   │   ├── code_assistant.py           # AI-powered natural language processing
│   │   ├── enhanced_main_assistant.py  # Production-ready AI assistant
│   │   ├── mcp_integration.py          # MCP protocol integration
│   │   └── warehouse_automation_patterns.py # Industrial automation patterns
│   ├── sdk_interface/
│   │   └── studio5000_sdk.py           # Real Studio 5000 SDK integration
│   ├── documentation/                  # Vector-powered documentation search
│   │   ├── instruction_vector_db.py    # Instruction search vector database
│   │   └── instruction_mcp_integration.py # MCP tools for instruction search
│   ├── l5x_analyzer/                   # Advanced L5X file analysis
│   │   ├── l5x_vector_db.py           # L5X semantic search system
│   │   ├── l5x_mcp_integration.py     # L5X analysis MCP tools
│   │   └── sdk_powered_analyzer.py    # SDK-enhanced L5X analysis
│   ├── sdk_documentation/              # SDK documentation search
│   │   ├── sdk_vector_db.py           # SDK documentation vector search
│   │   ├── sdk_doc_parser.py          # SDK documentation parser
│   │   └── mcp_sdk_integration.py     # SDK documentation MCP tools
│   ├── tag_analyzer/                   # Tag analysis and management
│   │   ├── tag_vector_db.py           # Tag-based vector search
│   │   ├── csv_tag_parser.py          # CSV tag file parsing
│   │   └── tag_mcp_integration.py     # Tag analysis MCP tools
│   └── verification/                   # Code validation system
│       ├── sdk_verifier_clean.py      # Fast validation (production)
│       └── sdk_verifier.py           # Legacy SDK validation (deprecated)
├── *_vector_cache/                     # Vector database cache directories
│   ├── instruction_vector_cache/       # Instruction search cache
│   ├── l5x_vector_cache/              # L5X analysis cache
│   ├── sdk_vector_cache/              # SDK documentation cache
│   └── tag_vector_cache/              # Tag analysis cache
├── examples/                           # Example generated projects
├── docs/                              # Additional documentation
├── requirements.txt                    # Python dependencies (includes vector DB)
├── mcp_config.json                    # Sample MCP configuration for Claude
└── README.md                          # This comprehensive documentation

Ключевые файлы

• Основной сервер: src/mcp_server/studio5000_mcp_server.py (основной MCP-сервер с 15+ инструментами)

• ИИ-ассистент: src/ai_assistant/enhanced_main_assistant.py (готовый к продакшену ИИ-ассистент)

• Генератор L5X: src/code_generator/l5x_generator.py (создаёт импортируемые L5X-файлы)

• Анализатор L5X: src/l5x_analyzer/l5x_vector_db.py (семантический поиск по L5X-файлам)

• Быстрая валидация: src/verification/sdk_verifier_clean.py (производственная система валидации)

• SDK-интерфейс: src/sdk_interface/studio5000_sdk.py (создаёт настоящие .ACD-файлы)

• Векторные базы данных: каталоги *_vector_cache/ (семантический поиск на основе FAISS)

• Конфигурация: переменные окружения или аргументы командной строки

Участие в разработке

Текущие возможности — ЧЕСТНАЯ ОЦЕНКА

✅ Что реально работает (готово к продакшену):

• ✅ Разбор официальной документации Studio 5000 (HTML с векторным поиском)

• ✅ Генерация текста релейно-контактной логики с помощью ИИ (хорошая основа для ручной разработки)

• ✅ Создание пустых .ACD-файлов (надёжная генерация шаблонов на основе SDK)

• ✅ Быстрая система валидации (ответ за 0,001 с, 100% надёжность)

• ✅ Семантический поиск на основе векторных представлений (на базе FAISS, производственного масштаба)

• ✅ Анализ L5X-файлов (протестировано на файлах с 49 000+ строк)

• ✅ Поиск по документации SDK (всеобъемлющая база методов)

• ✅ Распознавание шаблонов (шаблоны пуск/стоп, таймеров, счётчиков)

⚠️ Что работает частично (требует ручных исправлений):

• ⚠️ Генерация L5X-файлов проекта (создаёт структуру, но есть проблемы с форматированием RLL)

• ⚠️ Полное создание ACD (экспериментальные функции частичного импорта SDK)

• ⚠️ Умная вставка кода (анализ работает, вставка зависит от SDK)

🔧 Что требует разработки:

• 🔧 Корректная генерация XML для RLL (в настоящее время выводит необработанный текст в CDATA)

• 🔧 Надёжный частичный импорт SDK (сложный и подверженный ошибкам)

• 🔧 Сквозная автоматизация проектов (в настоящее время требует ручных шагов)

Будущие возможности для улучшения

Высокий приоритет (Завершено! ✅):

• ✅ Полная интеграция SDK: ЗАВЕРШЕНО! Реализовано полное создание программ и задач

• ✅ Импорт/экспорт подпрограмм: ЗАВЕРШЕНО! Используется функция частичного импорта SDK

• ✅ Создание структуры программы: ЗАВЕРШЕНО! Автоматически создаются MainProgram и MainTask

• Управление тегами: Реализовать операции создания и управления тегами через SDK (TODO)

• Расширенные операции с проектами: Автоматизация сборки, обновления и развёртывания (TODO)

Средний приоритет (расширение функциональности):

• Поддержка дополнительных языков: Генерация структурированного текста (ST) и функциональных блок-схем (FBD)

• Расширенное распознавание шаблонов: Более сложные шаблоны промышленной автоматизации

• ✅ Улучшение документации SDK: ЗАВЕРШЕНО! Парсер теперь находит 63 метода LogixProject + 39 примеров = 102+ операции (было 22)

• Расширенная валидация: Статический анализ и проверка лучших практик

Низкий приоритет (расширенная интеграция):

• Несколько версий Studio 5000: Динамическое определение версии и совместимость

• Расширения интеграции: Поддержка FactoryTalk View, RSLinx и других инструментов Rockwell

• Облачное развёртывание: Веб-интерфейс для совместной работы команды

• Система кэширования: Улучшенная производительность для больших наборов документации

🎯 Честная ценность: рабочий процесс разработки с помощью ИИ

Система обеспечивает ценную помощь ИИ для разработки ПЛК:

• ✅ Генерация логики с помощью ИИ: Преобразование естественного языка в текст релейно-контактной логики (РАБОТАЕТ ХОРОШО)

• ✅ Пустые ACD-шаблоны: Чистые файлы проектов, готовые для ручной разработки (НАДЁЖНО)

• ⚠️ Создание структуры L5X: Создаёт шаблоны проектов, которые могут потребовать исправления форматирования (ЧАСТИЧНО)

• ✅ Быстрая валидация: Мгновенная проверка синтаксиса и инструкций (ГОТОВО К ПРОДАКШЕНУ)

• ✅ Векторный поиск: Семантический анализ существующих проектов (ГОТОВО К ПРОДАКШЕНУ)

Вы можете спросить: «Сгенерируй логику управления конвейером с обнаружением застревания» и получить качественный код релейно-контактной логики, который можно использовать как основу для ручной разработки. ИИ помогает, но инженеры-люди по-прежнему должны реализовывать и проверять конечное решение.

Настройка среды разработки

1. Сделайте форк репозитория

2. Установите Python 3.12 и зависимости

3. Настройте переменные окружения для вашей установки Studio 5000

4. Запустите тесты для проверки функциональности

5. Отправляйте pull request с понятной документацией

Лицензия и правовая информация

Важная правовая информация:

• Этот проект предоставляется как есть для образовательных целей и целей разработки

• Studio 5000, Logix Designer, ControlLogix и Allen-Bradley являются товарными знаками Rockwell Automation, Inc.

• Это программное обеспечение не связано с Rockwell Automation, не одобрено и не поддерживается ею

• Пользователи должны иметь действующие лицензии Studio 5000 для использования функций SDK

• Сгенерированный код и проекты должны быть проверены квалифицированным персоналом перед использованием в производственных средах

Отказ от ответственности: Этот инструмент помогает в программировании ПЛК, но не заменяет надлежащую инженерную практику, анализ безопасности или проверку соответствия требованиям, необходимые для систем промышленной автоматизации.