Зависимости и обновления
Состав установки, дополнительные среды, модели и внешние программы для разных сценариев Screph. Подготовка компонента и готовность конкретной функции проверяются отдельно.
Что устанавливается вместе с программой
Для работы интерфейса, открытия изображений, разметки и сохранения проектов нужны основные файлы Screph, библиотеки интерфейса Qt/PySide6 и основные библиотеки обработки данных. В текущем Windows-маршруте установки эти части связаны между собой и устанавливаются как основа программы. Отдельно устанавливать Python для самого интерфейса не требуется.
| Часть установки | Назначение и выбор |
|---|---|
| Основные файлы, интерфейс и основные библиотеки | Программа, ресурсы, Qt/PySide6, обработка изображений и данных, включая OpenCV, NumPy и Pillow, а также библиотеки используемых подключений. Обязательная основа установки. |
| Компоненты и зависимости Screph | Средства проверки и подготовки дополнительных сред. Текущий Windows-маршрут включает материалы для локального Python, сред автоматизации и работы с кодом, OCR, видео и локальной речи; установка нужной среды определяется выбранными параметрами. |
| Компьютерное зрение и ML | Дополнительные библиотеки машинного обучения. Отдельный устанавливаемый ML-пакет среды нужен сценариям, использующим выбранную внешнюю ML-среду. Файлы весов моделей проверяются отдельно. |
| Учебные демонстрации | Примеры проектов и подготовленные озвученные демонстрации. Отдельный компонент, предлагаемый по умолчанию. Выбор персонажа в настройках не устанавливает его файлы. |
| Screph Pro Agent | Дополнительный компонент встроенной агентной IDE Screph Code. Может обновляться отдельно от основного приложения; для выбранного агента также нужны соответствующая среда и подключение. |
Таблица описывает текущий маршрут установки. Фактический состав конкретного скачанного установщика и установленной версии зависит от её поставки и выбранных компонентов. Его можно проверить в средстве обслуживания и на вкладке «Компоненты и среды». Состав опубликованной сборки, для которой нет подтверждённых сведений о компонентах, остаётся неизвестным.
Небольшой Windows-установщик может получать компоненты по сети. Для автономной установки нужен полный комплект с каталогом пакетов рядом с установщиком; один файл EXE не означает, что все компоненты доступны без интернета. ML-пакет и модели также должны быть подготовлены, если выбранный сценарий их использует.
Страница зависимостей
Установка программы, подготовка среды выполнения и загрузка весов модели — отдельные действия. Компонент может быть установлен, но функция ещё недоступна из-за отсутствующего файла модели, неподходящего устройства или ненастроенного подключения. Читайте причину в состоянии выбранной функции.
В главном окне вкладка «Компоненты и среды» показывает сводку и таблицу: включение компонента, выбранный источник, статус, выбранный и найденный пути, размер и возможную экономию места. Из неё доступны повторная проверка, установка или восстановление локальной среды и удаление её локальных файлов. Установка начинается после отдельного действия.
- Найдите компонент для нужного сценария в таблице и проверьте, включён ли он.
- Выберите локальную установку либо совместимый уже установленный компонент. Для Python выбирается конкретная среда с нужными библиотеками.
- Нажмите «Проверить заново». Оцените статус выбранного источника и показанную причину ошибки; обнаруженный на компьютере файл ещё не подтверждает его пригодность.
- Если требуется, выполните «Установить/починить локально» и дождитесь результата. Затем проверьте модель, устройство или подключение в настройках самой функции.
Проверка среды может занять время при первом импорте больших библиотек. Она проверяет выбранный исполняемый файл и требуемые библиотеки, но не скачивает модели и не запускает обучение. Проверка существующей Python-среды не устанавливает и не обновляет её пакеты.
Локальная установка и существующая среда
- Локально: Screph подготавливает собственный компонент в каталоге данных ScrephData. Это основной вариант Windows-маршрута; файлы не подменяют системную Python-среду.
- Найдено глобально: используется уже установленная совместимая программа или среда. Кнопка «Использовать найденные глобально» выбирает только прошедшие проверку компоненты.
- Свой путь: указывается точный исполняемый файл. Для Python диалог существующих сред показывает путь, версию и причины несовместимости. В расширенном режиме доступны дополнительные параметры выбора пути.
- Пропустить: компонент не используется. Зависящий от него сценарий остаётся недоступным, пока не выбран подходящий источник.
Глобальная установка доступна только для допускающих её компонентов в расширенном режиме. Она отличается от использования уже установленного компонента. Если выбранный источник повреждён или несовместим, Screph показывает ошибку; другой источник требуется выбрать явно.
Размер и экономия в таблице помогают планировать место, но не заменяют проверку свободного пространства. Среды автоматизации, OpenCV и локальной речи могут использовать общие локальные файлы. Перед удалением следует остановить работающие задачи и проверить, какие функции используют ту же среду.
Какие функции требуют дополнений
| Функция | Что требуется |
|---|---|
| Запуск Python-программ и автоматизации | Python и среда автоматизации с NumPy, Pillow, OpenCV и PyAutoGUI. Это отдельная среда для запуска программ; наличие работающего интерфейса Screph не подтверждает её готовность. |
| Классическое компьютерное зрение | Библиотеки OpenCV и обработки изображений. Основная установка содержит библиотеки для самого приложения; внешняя среда OpenCV/CV проверяется отдельно для использующих её запусков. |
| OCR / Tesseract | Исполняемый файл Tesseract и данные выбранного языка. В текущих материалах локальной установки предусмотрены английские и русские данные. Для другого языка нужен соответствующий файл; проверка программы Tesseract сама по себе не подтверждает наличие всех языков. |
| Операции с видео | FFmpeg для использующих его операций, включая точную нарезку. Проверяются конкретный путь и возможность запуска FFmpeg; доступность одного видеодекодера не подтверждает готовность всех операций. |
| YOLO, FastSAM, SAM, OmniParser | Совместимая ML-среда с библиотеками выбранного метода, файлы моделей и подходящее вычислительное устройство. |
| Обучение и модели последовательностей | ML-среда с компонентами Screph для обучения и обработки последовательностей, зависимости выбранной модели и данные эксперимента. Для трекеров YOLO предусмотрен LAP; SAM 2 включается отдельно. Наличие только PyTorch не подтверждает готовность среды. |
| Локальное распознавание речи | Vosk, PyAudio, модель языка и доступный микрофон. В текущих материалах локальной установки предусмотрена малая русская модель Vosk. Другой язык выбирается вместе с подходящей моделью. |
| Screph Code / OpenHands | Компонент Screph Pro Agent, среда работы с кодом и настроенное подключение выбранного агента или LLM. Для внешнего редактора также нужна установленная программа этого редактора. |
| Codex / OpenCodex | Codex CLI является отдельным опциональным компонентом. OpenCodex устанавливается и запускается отдельным действием в настройках подключения. Codex Desktop устанавливается независимо; наличие CLI не устанавливает графическое приложение. |
| ROS 2 | Для экспорта программы ROS установка ROS не требуется. Для обмена через топики, непрерывного потока и исполнения экспортированного узла нужна отдельная среда ROS 2. Дистрибутив ROS не входит в компоненты Screph. |
| Внешние подключения и устройства | Сетевой доступ и настройки выбранного сервиса; для камер и микрофонов — доступные устройства и права. Arduino требует устройство и подходящую прошивку; FakerInput на Windows — отдельную установку драйвера с подтверждением UAC. |
Готовая среда машинного обучения не означает, что нужная модель уже загружена. Модели проверяются отдельно; см. «Модели компьютерного зрения».
ML-пакет, библиотеки и модели
Блок «Пакеты зависимостей ML» задаёт библиотеки выбранной ML-среды. PyTorch выполняет нейросетевые вычисления, TorchVision предоставляет операции для изображений, Ultralytics используется YOLO/FastSAM, LAP — трекерами YOLO. Дополнительно предусмотрены timm, Transformers, einops и Hugging Face Hub для поддерживаемых моделей и их загрузки. Meta SAM 2 является отдельным выбором и по умолчанию выключен.
Библиотеки связаны зависимостями: отключение пакета может сделать выбранный метод недоступным. Вместе со средой нужны компоненты Screph для её задач. При выборе существующей Python-среды проверяются все необходимые импорты в одном и том же интерпретаторе.
Локальную ML-среду можно подготовить из подходящего ZIP-пакета либо его распакованного каталога. При доступном канале подписанного пакета сначала проверяются сведения о версии, целевой платформе, размере, подписи и составе. Загрузка архива, выбор его для установки и подготовка среды — отдельные этапы. Скачанный, но ещё не выбранный архив не становится активной средой.
Для сетевой поставки проверяются контрольные суммы, подпись и политика доверия; для установки — комплектность пакета и запуск среды. Ошибки подписи или несовместимой платформы следует исправлять выбором корректного пакета. Локальный архив с совпавшей контрольной суммой сам по себе не подтверждает доверенного издателя.
Для CPU и GPU выбирается доступное устройство конкретного метода. Использование NVIDIA GPU требует совместимой сборки PyTorch и системного драйвера; установка ML-пакета не устанавливает драйвер видеокарты. Перед запуском следует проверить выбранное устройство и память. Для обучения также нужны подготовленные данные, параметры эксперимента и место для результатов.
Локальное обучение не требует Ray. В настройках обучения отдельно предусмотрен экспериментальный Ray-исполнитель для классификации: на кластере заранее нужны Ray Train, совместимые PyTorch/TorchVision и компоненты Screph для обучения, доступная общая папка и хранилище результатов. Проверка Ray выполняется отдельной кнопкой; локальная ML-среда не подтверждает готовность кластера. Обучение detection и segmentation через этот исполнитель пока недоступно.
Отдельная среда ROS 2
ROS 2 используется по выбору для разработки программы обработки изображений. В Screph открывается «Настройки и инструменты → Автоматизация → ROS 2». Открытие страницы и выбор уровня не запускают ROS.
- Генерация кода: экспорт поддерживаемой сохранённой обработки CPU/CV в Python-пакет ROS и работа с этим результатом в Screph Code. Экспорт не требует установленного ROS или запроса модели.
- Обмен: файловый импорт и экспорт кадра доступны без ROS; список топиков, получение снимка из топика и публикация требуют подключённой среды ROS.
- Непрерывная обработка: получение потока требует подключения и явного запуска. Обработка сохранённой схемой и публикация результатов включаются отдельно.
Для подключения указывается абсолютный путь к Python установленной среды ROS 2 с rclpy, sensor_msgs и std_msgs. В этой среде должны быть доступны системные библиотеки ROS и выбранное DDS-подключение. Общая среда автоматизации или ML не заменяет её. Screph не устанавливает ROS автоматически и не добавляет его библиотеки в свою обычную Python-среду.
После выбора среды действие «Применить и подключить» проверяется по результату подключения и списку топиков. Отсутствие кадра может означать, что издатель ещё не запущен, выбран другой домен, топик или несовместимый QoS. Изменённые настройки требуют применения и переподключения. Локальный запуск среды через WSL, SSH или удалённый интерпретатор этим подключением не поддерживается.
Экспортированный ROS-пакет содержит прикладную программу и сохранённую обработку, а не дистрибутив ROS. Для его установки и запуска на целевой машине используются инструменты ROS и инструкции пакета. Среда ROS, пакеты узла, камера или источник изображений проверяются на этой машине отдельно. Проверки ROS 2 Jazzy в среде разработки не подтверждают готовность любой установленной сборки Screph.
Перед установкой компонента
Подготовка может включать загрузку и распаковку больших файлов. Дождитесь итогового состояния, а не только завершения загрузки. Если отмена ещё завершает фоновую работу, не запускайте повторную установку и не удаляйте её файлы одновременно.
- Проверьте свободное место и источник загрузки.
- Для большой среды машинного обучения оставьте запас места для архива, распаковки и моделей.
- Если используется локальный пакет, убедитесь, что он предназначен для вашей версии Screph и Windows x64.
- Не удаляйте общий компонент, пока его могут использовать другие функции.
Обновления программы
Ручная проверка, текущая версия, канал и автоматическая проверка доступны в «Личный кабинет → Обновления» и «Общие настройки → Обновления». Вход в аккаунт для проверки и обновления не требуется.
В Windows проверка получает сведения о версиях установленных компонентов, а установка выполняется отдельным средством обслуживания. Обновиться может отдельный компонент, например Screph Pro Agent. Открытие средства обслуживания ещё не означает, что обновление установлено. Завершите его действия и после следующего запуска проверьте версию и результат проверки компонентов.
Автоматическую проверку обновлений можно включить или выключить в основных настройках. Проверка получает сведения о доступных версиях; проект, изображения и разметка не отправляются.
Перед обновлением сохраните проекты и настройки. После обновления повторно проверьте компоненты, модели и способы ввода, которые нужны рабочему процессу.
Обновление приложения, подготовка ML-пакета, загрузка весов модели и обновление внешней среды ROS или редактора — разные действия. Существующую внешнюю Python-среду обслуживает её владелец; проверка Screph не обновляет её пакеты.
Если средство обслуживания отсутствует, сведения о доступных версиях ещё могут быть доступны, но запуск установки обновления из Screph недоступен. Для Linux применяется способ обновления, указанный для конкретного пакета на странице загрузки; Windows-средство обслуживания и Windows-пакеты среды для этого не подходят.
Платформа и системные условия
Локальная управляемая установка описанных сред ориентирована на Windows. В другом варианте поставки следует выбирать только источники и пакеты, которые предлагает установленная программа для своей платформы. Совпадение названия компонента не означает совместимость Windows-архива с Linux.
Камерам, захвату экрана, микрофону и выбранному способу ввода могут требоваться права операционной системы и драйверы устройства. Эти условия проверяются отдельно от Python-библиотек. Аппаратный ввод через Arduino требует подходящей прошивки и выбранного устройства; установка FakerInput выполняется отдельно от установки ML.
Кнопка «Длинные пути Windows» показывает системное состояние и позволяет отдельно запросить его изменение. При подтверждении Windows может запросить UAC; после успешного включения требуется перезапуск Screph. Просмотр компонентов сам по себе системную настройку не меняет.
Если проверка не проходит
После исправления пути, подключения или установки компонента повторите проверку. Не удаляйте весь каталог данных ради одной ошибки: сначала сохраните проект и найдите конкретный отсутствующий или повреждённый компонент.
| Результат | Проверка и следующее действие |
|---|---|
| Готов | Выбранный компонент прошёл проверку. Отдельно проверяются файл модели, вычислительное устройство, данные задачи и подключение. |
| Отсутствует или путь неверен | Проверьте выбранный исполняемый файл. Укажите подходящий существующий компонент либо установите локальный. |
| Ошибка библиотеки или несовместимая среда | Прочитайте список отсутствующих или неработающих библиотек. Выберите среду с полным набором требуемых компонентов; для локальной среды используйте восстановление из совместимого пакета. |
| Отключён, пропущен или недоступен на платформе | Проверьте включение и источник. Для неподдерживаемого варианта используйте доступный маршрут поставки; повторная установка Windows-пакета не меняет платформу. |
| Проверка ещё не выполнена | Повторите проверку после изменения источника или пути. Старый результат не подтверждает новое выбранное окружение. |
| Ошибка загрузки, подписи или контрольной суммы | Проверьте источник, доступ к сети и соответствие пакета платформе и версии. Неполный или повреждённый архив следует получить заново; ошибку доверия нельзя считать успешной установкой. |
| Архив скачан, функция недоступна | Проверьте, выбран ли архив и завершена ли установка среды. Затем проверьте модели и настройки функции. |
- Откройте подробности компонента и прочитайте показанную причину.
- Проверьте путь, права, свободное место и сетевой доступ.
- Повторите подготовку или выберите корректный локальный пакет.
- После установки снова запустите проверку из Screph.
В расширенном режиме «Диагностика» показывает локальные параметры и последний результат проверки. Эти сведения помогают сопоставить источник, путь и ошибку. Перед передачей диагностических материалов следует проверить содержимое и скрыть личные пути и данные подключений.