Документация → Руководство пользователя

Руководство пользователя

OwenStEditor — редактор ST-кода для контроллеров ОВЕН ПР200, работающий на реальном парсере OWEN Logic. Редактор проверяет синтаксис теми же средствами, что и среда разработки, помогает писать и исправлять код с помощью нейросети и хранит рабочую сессию между запусками.

Требования

• Windows (x64).
• Установленная среда OWEN Logic — из неё редактор берёт библиотеки StParser.dll, STLanguage.dll, STEditor.dll и другие. Сами библиотеки в архив редактора не входят и не распространяются.
• .NET 8 Desktop Runtime x64.

CLI-валидатор stval не требует .NET Runtime (собран как self-contained), но для разбора кода ему тоже нужен установленный OWEN Logic — подробности в руководстве по CLI.

Установка и первый запуск

1. На странице «Скачать» выберите установщик (EXE) или портативный архив (ZIP).
2. Установщик распакует программу в выбранную папку и при желании создаст ярлык на рабочем столе. Архив достаточно распаковать в любую папку.
3. При первом запуске редактор ищет библиотеки OWEN Logic в стандартных каталогах. Если они не найдены, появится окно выбора каталога установки OWEN Logic — укажите его (проверяется наличие ST\StParser.dll и CommandProcessor.dll). Путь запоминается.
4. Если лицензия ещё не активирована, откроется окно активации (см. «Демо-режим и активация»). Его можно пропустить и работать в демо-режиме.

Интерфейс

• Меню — «Файл», «Редактор», «Настройки», «Справка».
• Поле технического задания — текстовое поле сверху. В него описывают задачу для нейросети; кнопка рядом — «Вызов ИИ» (Ctrl+Enter).
• Вкладки файлов — по одной на открытый файл.
• Панель ошибок — список найденных проблем с указанием строки, колонки и типа. Может скрываться автоматически, когда ошибок нет.
• Журнал (логи) — история действий и запросов к модели; включается в настройках.
• Строка состояния — текущий статус и прогресс вызова ИИ.

Работа с файлами

• Создать файл — Ctrl+N, открыть файлы — Ctrl+O, открыть папку целиком — пункт меню «Открыть папку…».
• Сохранить — Ctrl+S, сохранить как — Ctrl+Shift+S.
• Открытые файлы, позиции курсора, текст задания и переписка с нейросетью сохраняются, если включена опция «Сохранять рабочую сессию» — после перезапуска всё восстанавливается.
• Автосохранение изменённых файлов включается отдельно, с настраиваемым интервалом.

Проверка кода

Код разбирается реальным парсером OWEN Logic — теми же проверками, что в конвейере сборки прошивок ПР200. Найденные проблемы показываются с координатами:

строка 12, колонка 5, тип: ... : описание ошибки

Проверяются синтаксис и существование типов в объявлениях переменных. Точный перечень проверок определяет сам парсер OWEN Logic.

Поиск и подсветка

• Найти — Ctrl+F, найти и заменить — Ctrl+H.
• Подсветка синтаксиса ST-кода.
• Подсветка одинаковых литералов: выделите фрагмент (от двух символов) — все его вхождения в файле подсветятся. Удобно проверять имена переменных и повторяющиеся константы. Сворачивание блоков кода — в планах.

Работа с ИИ

1. Убедитесь, что открыт файл и выбрана модель в разделе «Настройки → Нейросеть…».
2. Опишите задачу в поле технического задания. Если в коде есть ошибки проверки, они добавляются в запрос автоматически — можно вообще не писать текст, а только исправить ошибки.
3. Нажмите «Вызов ИИ» или Ctrl+Enter.
4. Перед первым обращением к модели выполняется проверка доступности. Во время запроса прогресс и время видны в строке состояния, кнопка превращается в «Отменить».
5. Ответ модели содержит строку «Суть запроса: …» и блок кода ```st … ```. Извлечённый код подставляется в редактор, а запрос и ответ попадают в журнал.

В запрос уходят: техническое задание, имя файла, текущие ошибки проверки и текст кода. Размер запроса ограничен параметром «Контекст (max tokens)» — если текст не помещается, вызов не отправляется, о чём сообщается в журнале.

Демо-версия позволяет выполнить 5 вызовов ИИ. После этого приложение попросит лицензию.

Встроенные системные блоки SYS

В редактор встроена библиотека готовых блоков и функций (44 штуки). Их можно вызывать прямо в коде — например, SYS.TON или SYS.LIMIT. Состав описан в справочнике ST-кода.

Настройки

Меню «Настройки → Нейросеть…»:

• список моделей: добавить, удалить, назначить по умолчанию;
• поля модели — «Название», «URL API», «Модель (id)», «API-ключ» и кнопка «Проверить», которая отправляет короткий тестовый запрос и подтверждает, что модель отвечает;
• «Таймаут, с» — предельное время ожидания ответа;
• «Контекст (max tokens)» — ограничение размера запроса;
• статистика по выбранной модели: число запросов и объём трафика, кнопка «Сбросить статистику».

Меню «Настройки → Основные…»:

• автосохранение и интервал (мс);
• размер шрифта редактора и текста запроса ИИ;
• тема: «Как в Windows», «Светлая», «One Monokai»;
• показывать журнал (логи), автоскрытие панели ошибок, сохранять рабочую сессию.

Настройки шифруются средствами Windows и хранятся в профиле пользователя. Изменения применяются после кнопки «Сохранить».

Горячие клавиши

Демо-режим и активация

• Без лицензии доступны 5 вызовов ИИ и обычное редактирование с проверкой кода.
• В окне активации показан отпечаток компьютера — его нужно передать разработчику. Кнопка «Копировать отпечаток» кладёт его в буфер обмена.
• Кнопка «Отправить запрос» открывает сайт с формой заявки, куда отпечаток подставляется автоматически. Также заявку можно заполнить на этом сайте вручную.
• Готовую лицензию можно вставить как код (base64) или перетащить файл license.dat прямо в окно активации, затем нажать «Активировать».
• Сбросить активацию можно в окне «Справка → О программе» кнопкой «Сбросить регистрацию».

Подробнее о тарифах и сроках — в разделе «Лицензирование».

Где хранятся данные

• Настройки: %LOCALAPPDATA%\OwenStEditor\settings.dat (зашифрованы Windows).
• Счётчик демо-вызовов: %LOCALAPPDATA%\OwenStEditor\demo-calls.txt.
• Сохранённая лицензия: %LOCALAPPDATA%\OwenStEditor\license.dat. Дополнительно лицензия может лежать рядом с программой; после активации этот файл удаляется, чтобы дальнейшая работа не зависела от него.
• Пользовательские файлы и сессия — по путям, которые вы выбираете сами.