Зависимости и обновления
Состав установки, дополнительные среды, модели и внешние программы для разных задач 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-установщик может получать компоненты по сети. Для автономной установки нужен полный комплект с каталогом пакетов рядом с установщиком. Если задача использует 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. Завершите установку в средстве обслуживания, затем перезапустите Screph и проверьте версию и состояние компонентов.
Автоматическую проверку обновлений можно включить или выключить в основных настройках. Проверка получает сведения о доступных версиях; проект, изображения и разметка не отправляются.
Перед обновлением сохраните проекты и настройки. После обновления повторно проверьте компоненты, модели и способы ввода, которые нужны рабочему процессу.
Обновление приложения, подготовка ML-пакета, загрузка весов модели и обновление внешней среды ROS или редактора выполняются отдельно. Существующую внешнюю Python-среду обслуживает её владелец; проверка Screph не обновляет её пакеты.
Если средство обслуживания отсутствует, сведения о доступных версиях ещё могут быть доступны, но запуск установки обновления из Screph недоступен. Для Linux применяется способ обновления, указанный для конкретного пакета на странице загрузки; Windows-средство обслуживания и Windows-пакеты среды для этого не подходят.
Платформа и системные условия
Описанная управляемая установка локальных сред предназначена для Windows. В других вариантах поставки выбирайте источники и пакеты, которые установленная программа предлагает для вашей платформы. Архивы для Windows не подходят для Linux.
Камерам, захвату экрана, микрофону и выбранному способу ввода могут требоваться права операционной системы и драйверы устройства. Эти условия проверяются отдельно от Python-библиотек. Аппаратный ввод через Arduino требует подходящей прошивки и выбранного устройства; установка FakerInput выполняется отдельно от установки ML.
Кнопка «Длинные пути Windows» показывает системное состояние и позволяет отдельно запросить его изменение. При подтверждении Windows может запросить UAC; после успешного включения требуется перезапуск Screph. Просмотр компонентов сам по себе системную настройку не меняет.
Если проверка не проходит
После исправления пути, подключения или установки компонента повторите проверку. Не удаляйте весь каталог данных ради одной ошибки: сначала сохраните проект и найдите конкретный отсутствующий или повреждённый компонент.
| Результат | Проверка и следующее действие |
|---|---|
| Готов | Выбранный компонент прошёл проверку. Отдельно проверяются файл модели, вычислительное устройство, данные задачи и подключение. |
| Отсутствует или путь неверен | Проверьте выбранный исполняемый файл. Укажите подходящий существующий компонент либо установите локальный. |
| Ошибка библиотеки или несовместимая среда | Прочитайте список отсутствующих или неработающих библиотек. Выберите среду с полным набором требуемых компонентов; для локальной среды используйте восстановление из совместимого пакета. |
| Отключён, пропущен или недоступен на платформе | Проверьте включение и источник. Для неподдерживаемого варианта используйте доступный маршрут поставки; повторная установка Windows-пакета не меняет платформу. |
| Проверка ещё не выполнена | Повторите проверку после изменения источника или пути. Старый результат не подтверждает новое выбранное окружение. |
| Ошибка загрузки, подписи или контрольной суммы | Проверьте источник, доступ к сети и соответствие пакета платформе и версии. Неполный или повреждённый архив следует получить заново; ошибку доверия нельзя считать успешной установкой. |
| Архив скачан, функция недоступна | Проверьте, выбран ли архив и завершена ли установка среды. Затем проверьте модели и настройки функции. |
- Откройте подробности компонента и прочитайте показанную причину.
- Проверьте путь, права, свободное место и сетевой доступ.
- Повторите подготовку или выберите корректный локальный пакет.
- После установки снова запустите проверку из Screph.
В расширенном режиме «Диагностика» показывает локальные параметры и последний результат проверки. Эти сведения помогают сопоставить источник, путь и ошибку. Перед передачей диагностических материалов следует проверить содержимое и скрыть личные пути и данные подключений.