Начало работы с Screph Getting Started with Screph

Этот раздел помогает установить и запустить Screph, выбрать подходящий режим и создать первую задачу для AI на собственном изображении, видео или записи экрана. This section helps you install and launch Screph, choose an appropriate mode, and create the first task for AI on your own image, video or screen recording.

Установка Installation

Скачайте установщик для целевой платформы Windows 10/11 x64 на странице Скачать, проверьте системные требования и следуйте инструкциям мастера. Download the installer for the Windows 10/11 x64 target from the Download page, review the system requirements, and follow the installation wizard.

Альтернативно, можно использовать исходный код из GitHub и установить вручную по инструкции в README. Alternatively, you can use the source code from GitHub and install manually following the README instructions.

Первый запуск First Launch

Запустите Screph из ярлыка после установки или из меню Пуск. В программе можно открыть или захватить визуальный источник, выделить элементы, связать их, добавить текстовые или голосовые описания и сохранить структурированную задачу. Методы компьютерного зрения используются при необходимости; с сохранённым контекстом можно продолжить работу в агентной IDE. Launch Screph from the shortcut after installation or from the Start menu. In the program you can open or capture a visual source, mark and connect elements, add text or voice descriptions, and save a structured task. Computer-vision methods are optional; the saved context can be continued in the agentic IDE.

Для голосовых аннотаций (speech‑to‑text) можно выбрать внешний провайдер или использовать офлайн‑режим с локальными моделями Vosk. Перед первым рабочим проектом откройте вкладку зависимостей и подготовьте только нужные вашей задаче runtime-компоненты. For voice annotations (speech‑to‑text) you can choose an external provider or use offline mode with local Vosk models. Before the first working project, open the dependencies guide and prepare only the runtime components your task needs.

Выбор режима программы Choose a Program Mode

Откройте Общие настройки → Платформа разработки или список Режим программы в шапке Selector. Выберите один из доступных режимов: Общий, Автоматизация GUI, Промышленное зрение или Автономные беспилотники. Переключение согласованно меняет CV workspace и возможности Selector; проект лучше сохранить до перехода между предметными сценариями. Open General Settings → Development Platform or the Program mode list in the Selector header. Choose one of the available modes: General, GUI Automation, Industrial Vision, or Autonomous Unmanned Vehicles. Switching updates the CV workspace and Selector capabilities together; save the project before moving between domain workflows.

По умолчанию мастер предлагает %LOCALAPPDATA%\Screph, создаёт ярлык в меню Пуск и сохраняет пользовательские данные при переустановке/удалении, пока вы явно не выберете их удаление. Драйвер Virtual HID и прошивка Arduino — отдельные действия после установки; подробности см. в разделе «Windows и права». By default, the wizard proposes %LOCALAPPDATA%\Screph, creates a Start menu shortcut and preserves user data during reinstall or uninstall unless you explicitly select removal. The Virtual HID driver and Arduino flashing are separate post-install actions; see Windows and permissions.

Для свободной разметки начните с общего режима, для экранов приложений — с автоматизации GUI. «Промышленное зрение» и «Автономные беспилотники» уже предоставляют предметные workspace, preview, работу с кандидатами и подтверждаемое применение разметки, но пока не являются производственным управлением или готовым экспортным контуром. Подробности: Режимы программы. Start with General for free-form markup and GUI Automation for application screens. Industrial Vision and Autonomous Unmanned Vehicles already provide domain workspaces, preview, candidate review, and confirmed markup application, but they are not production-control or complete export systems. See Program Modes for details.

Обзор интерфейса Interface Overview

Основное окно приложения Screph состоит из нескольких ключевых областей: The main Screph application window consists of several key areas:

• Холст (Canvas)Canvas: Центральная область, где отображается текущий снимок экрана или изображение. Здесь вы будете выделять элементы и работать с ними. The central area where the current screenshot or image is displayed. This is where you will select elements and work with them.
• Панель ИнструментовTools Panel: Содержит кнопки для выбора режимов работы (Выделение, Создание, Перемещение, Изменение размера, Иерархия) и других действий. Contains buttons for selecting work modes (Select, Create, Move, Resize, Hierarchy) and other actions.
• Информационная ПанельInfo Panel: Отображает свойства выбранного элемента, иерархию элементов и другую полезную информацию. Displays properties of the selected element, element hierarchy and other useful information.
• Главное МенюMain Menu: Расположено в верхней части окна. Предоставляет доступ к функциям сохранения/загрузки проектов, настройкам и справке. Located at the top of the window. Provides access to save/load projects, settings and help.
• Виджет Голосовой АннотацииVoice Annotation Widget: Появляется при активации функции голосовой аннотации. Позволяет записывать, останавливать и просматривать распознанный текст. Appears when the voice annotation feature is activated. Allows recording, stopping and viewing recognized text.

Основные шаги Main Steps

1. Исходные данные: вкладка Захват или открытие изображения1. Source Data: Capture Tab or Open Image

Начните с визуального источника. Вкладка Захват умеет записывать область, монитор или окно, работать с камерой и URL-потоком, а через Файлы / папки — собрать несколько изображений, видео и каталогов в общий timeline. Один статичный снимок можно загрузить через меню. Start with a visual source. The Capture tab can record a region, monitor or window, use a camera or URL stream, and combine multiple images, videos and directories into one timeline through Files / folders. A single still image can be loaded from the menu.

Быстрый переход: руководство по вкладке Захват. Quick link: the Capture tab guide.

2. Выбор инструмента холста2. Select a Canvas Tool

Используйте Панель Инструментов для выбора инструмента. Это локальные операции холста, а не режим всей программы из раздела «Платформа разработки»: Use the Tools Panel to select a tool. These are local canvas operations, not the whole-program mode selected under Development Platform:

• ВыделениеSelect Mode: Для выбора существующих элементов.For selecting existing elements.
• СозданиеCreate Mode: Для рисования новых элементов на холсте.For drawing new elements on the canvas.
• ПеремещениеMove Mode: Для перемещения элементов.For moving elements.
• Изменение размераResize Mode: Для изменения размеров элементов.For resizing elements.
• ИерархияHierarchy Mode: Для создания связей родитель-потомок.For creating parent-child relationships.

3. Работа с элементами3. Working with Elements

В зависимости от выбранного режима, кликайте или перетаскивайте мышь на холсте. Подробности - в разделе "Выделение элементов" Руководства пользователя. Depending on the selected mode, click or drag on the canvas. Details in the "Element Selection" section of the User Manual.

4. Аннотации4. Annotations

Добавляйте текстовые и голосовые аннотации к элементам. Если задаче нужны маски, контуры, OCR, сопоставление или другие производные данные, примените методы компьютерного зрения; предлагаемое изменение разметки подтверждается отдельно. Подробности - в разделе "Аннотации" Руководства пользователя. Add text and voice annotations to elements. If the task needs masks, contours, OCR, matching or other derived data, apply computer-vision methods; a proposed markup change is confirmed separately. Details in the "Annotations" section of the User Manual.

5. Сохранение задачи и продолжение работы5. Save the Task and Continue

Используйте Файл → Сохранить проект (Ctrl+S). Команда Файл → Настройки сохранения... (Ctrl+Shift+S) выбирает environment, scope и post-save actions; загрузка через Ctrl+O открывает Менеджер проектов. Сохранение создаёт основной проект и контекст for_ai_agent: продолжите задачу в агентной IDE Screph Code или поддерживаемом внешнем инструменте, а для GUI-автоматизации отдельно используйте Automation Runtime. Подробности — в разделе "Сохранение и загрузка". Use File → Save Project (Ctrl+S). File → Save Settings... (Ctrl+Shift+S) selects the environment, scope and post-save actions; Ctrl+O opens Project Manager. Saving creates a main project and a for_ai_agent context: continue the task in the Screph Code agentic IDE or a supported external tool, and use Automation Runtime separately for GUI automation. See Saving and Loading.

Настройки и горячие клавиши Settings and Hotkeys

Настройки включают выделение, интерфейс, голосовые аннотации и другие параметры. Для ускорения работы доступны горячие клавиши - их список находится в разделе настроек. Используйте карту настроек; отдельные страницы описывают LLM/голосовые подключения и Automation Runtime. Settings include selection options, interface, voice annotations and other parameters. Hotkeys are available for faster work - find the list in the settings section. Use the settings map; dedicated pages cover LLM/voice connections and Automation Runtime.

С этим базовым пониманием вы готовы начать работу. Для подробной информации обратитесь к Руководству пользователя. With this basic understanding you're ready to start. For detailed information, refer to the User Manual.