Руководство пользователя Myna Recorder
Всё, что умеет Recorder. Точный синтаксис каждой команды есть в самой программе, рядом с редактором.
Обновлено 15 сентября 2026 г.
Начало работы
Myna Recorder — в этом руководстве “Recorder”, на диске Recorder.exe — это программа для записи макросов в Windows 10 и 11 (64-разрядных). Она записывает действия клавиатуры и мыши, позволяет редактировать результат как понятный скрипт и воспроизводит его в любом приложении. Скачать её можно здесь.
Активация
- Создайте учётную запись и подтвердите свою почту.
- В Recorder войдите в учётную запись справа вверху, указав почту и пароль. После этого на панели видны ваш тариф и остаток кредитов ИИ.
Recorder сохраняет вход в учётную запись и продолжает работать при обрыве связи. Выйти освобождает место, занятое этим компьютером, для другой машины.
Ваш первый макрос
Нажмите Начать запись (F2), выполните задачу вручную, нажмите Остановить запись (F3), затем Запустить воспроизведение (F4), чтобы воспроизвести её, и Остановить воспроизведение (F6), чтобы прервать запуск досрочно. Полная таблица клавиш — в разделе Воспроизведение.
Если в этом руководстве названа клавиша, имеется в виду клавиша по умолчанию. Клавиши меняются в разделе Параметры → Горячие клавиши.
Макрос отправляет настоящий ввод в то окно, которое находится перед ним. Запомните клавишу Остановить воспроизведение до запуска: она работает, даже когда Recorder не является активным окном.
Окно программы
Шесть вкладок. Четыре из них работают с одним проектом; Агент выполняет задачу за вас, а Кликер щёлкает за вас.
| Вкладка | Для чего она нужна |
|---|---|
| Recorder | Список шагов: по строке на каждое действие, с метками, разделами и сгруппированными сериями движений мыши. Лучше всего подходит для перестановки, удаления и изменения времени. |
| Скрипт | Тот же макрос в виде текста. Лучше всего подходит для циклов, условий и точных правок. Дважды щёлкните по команде, чтобы открыть форму её параметров. Под редактором: Пояснить добавляет рядом с кодом столбец с объяснением простыми словами, Автодополнение подсказывает имена по мере набора, а Проверить синтаксис перечисляет проблемы по мере набора. |
| Кликер | Автокликер: один щелчок, одна клавиша или последовательность точек, снова и снова, с заданной вами частотой — см. Автокликер. |
| Агент | Скажите, что нужно сделать, и ИИ выполнит это настоящими мышью и клавиатурой, шаг за шагом — см. Агент. |
| Наблюдение | Строки наблюдения, которые работают вместе с воспроизведением или сами по себе — см. Наблюдение. |
| Изображения | Именованные фрагменты экрана, которые использует этот макрос. Здесь их можно захватить, захватить заново и переименовать. Фрагменты общие для всех макросов на этом компьютере. |
Рядом показывает список шагов и скрипт одновременно. Кнопка Переменные открывает панель, где во время запуска в реальном времени видны все переменные.
Файлы
.recproj— проект: макрос, его фрагменты и его параметры в одном файле. Обычно сохраняют именно его..recscript— отдельный скрипт в виде текста.
Рабочий макрос сохраняется автоматически, включая неприменённый текст на вкладке «Скрипт».
Запись
Начать запись начинает её, а Остановить запись завершает (по умолчанию F2 и F3). Запись глобальная: она захватывает ваши действия в любом приложении, с исходными интервалами.
Параметры → Запись определяет, что записывается: клавиатура, щелчки мыши, движение мыши, колесо мыши. Без движения мыши макрос получается гораздо короче и щёлкает сразу по каждой цели; записывайте движение только для рисования или наведения.
Записанные координаты — это абсолютные пиксели экрана. Сдвиньте окно, смените разрешение или запустите макрос на другой машине — и записанный щелчок попадёт не туда. Решение — привязка к изображениям.
Использовать все мониторы распространяет захват на все экраны. На одном экране оставьте этот параметр выключенным.
Воспроизведение
| Действие | Клавиша по умолчанию |
|---|---|
| Начните запись | F2 |
| Остановить запись | F3 |
| Запустить воспроизведение | F4 |
| Пауза / продолжить воспроизведение | F5 |
| Остановить воспроизведение | F6 |
| Запустить автокликер | F7 |
| Остановить автокликер | F8 |
Все семь клавиш глобальные, и клавиша, занятая Recorder, поглощается: другие приложения её не получают. Изменить или отключить их можно в разделе Параметры → Горячие клавиши.
Остановить воспроизведение — единственный глобальный способ прервать работающий макрос. Не оставляйте её без назначения: без неё не запустятся ни скрытие окна во время работы, ни Агент.
Скорость и повтор
Воспроизведение идёт со скоростью от 0,25× до 10×. Скорость масштабирует записанные паузы, но не написанные вами вызовы sleep(), и не может заставить приложение отвечать быстрее. Если макрос ломается на 4×, но работает на 1×, замените выдержки времени на wait_for().
Повтор запускает макрос заданное число раз; 0 означает “до остановки”. Чтобы повторять что-то внутри одного запуска, используйте блоки циклов.
Проверочные запуски
Проверить на вкладке «Запись» воспроизводит только выделенные строки. Проверить выделенное на вкладке «Скрипт» компилирует и воспроизводит выделенный текст, включая неприменённые правки. Сам макрос при этом не меняется.
- Проверка выполняется один раз и со скоростью 1×, что бы ни было указано в «Повторе» и «Скорости».
- Наполовину выделенный цикл расширяется до всего блока; выделенный заголовок раздела означает всё, что находится внутри него.
- Сначала идёт обратный отсчёт (Параметры → Запись → Пауза перед проверкой, 0–30 секунд, по умолчанию 3). «Стоп» его отменяет.
Скрытие окна во время работы
Параметры → Окно → Скрывать это окно во время записи или воспроизведения скрывает Recorder на время запуска, включая проверки. Для этого должна быть назначена клавиша Остановить воспроизведение.
Редактирование макроса
Разделы
Раздел — это заголовок главы в списке шагов. Заводите по одному на каждый реальный этап задачи.
with section("Log in"):
click_crop("Username")
type_text("user")
with section("Export"):
click_crop("Export")
Разделы никогда не вкладываются друг в друга и начинаются от левого края. Циклы и условия могут находиться внутри раздела, с отступом в четыре пробела на уровень.
Метки и переходы
label="name" у любой команды делает её целью перехода; label("name") в отдельной строке — это шаг, который ничего не делает и нужен только как цель перехода; goto("name") выполняет переход к ней.
with section("Retry"):
click_crop("Refresh", label="again")
wait_for("Done", timeout_ms=20000, on_fail="again")
label("done")
Каждому goto("x"), on_no="x", on_fail="x" и каждой стрелке в wait_any вида -> "x" нужен шаг с label="x", иначе воспроизведение остановится с ошибкой. Метки должны быть уникальными.
Функции: см. справочник по скрипту.
Изображения и фрагменты
Фрагмент — это именованное изображение чего-либо на экране: кнопки, значка, заголовка. Recorder находит его во время воспроизведения и действует там, где он находится сейчас, поэтому макрос переживает сдвинутое окно, другое разрешение или другую машину.
Захватите фрагмент на вкладке Изображения, дайте ему имя и используйте это имя:
wait_for("Save dialog", timeout_ms=10000, abort=True)
click_crop("Save button")
| Аргумент | Что он делает |
|---|---|
"crop" | Имя в кавычках или условие из имён: "A" or "B", "A" and "B", скобки для группировки. Работает в wait_for, click_crop и в четырёх блоках if_image/while_image; click_crop щёлкает по первому написанному имени. См. условия. |
confidence | Насколько точным должно быть совпадение, 0–1. По умолчанию 0.8. Снизьте значение для кнопки, которая меняет оттенок при наведении; повысьте, если совпадает не то. |
timeout_ms | Сколько времени продолжать поиск. По умолчанию 5000. |
abort | По умолчанию False: отсутствующее изображение — это промах, а не ошибка, и запуск продолжается. abort=True вместо этого останавливает его. |
on_fail | Метка, к которой перейти, если изображение так и не появилось. |
region | (x, y, w, h): искать только в этом прямоугольнике. Используйте, когда один и тот же элемент встречается дважды. Каждое число может быть переменной или суммой. |
match | "color" (по умолчанию, строже) или "shape" — только по контуру, что переживает смену темы. Старое написание grayscale=True по-прежнему означает match="shape". |
x_offset / y_offset | В click_crop: сместить щелчок относительно центра совпадения. |
pre_click_ms | В click_crop: сколько курсор задерживается на совпадении перед нажатием. По умолчанию 200. См. Мышь. |
into | Сохранить совпадение в переменную; то же самое делает запись r = wait_for("crop"). См. результат совпадения. |
Вырезайте плотно. Фрагмент должен содержать характерную часть и ничего больше; фон внутри него сломает совпадение, когда фон изменится.
Чтение текста с экрана
read_text считывает область экрана в переменную. Очистите результат методами и используйте его в условиях, в арифметике или как ${name} внутри любого текстового аргумента.
total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")
Всегда указывайте region. При чтении всего рабочего стола изображение уменьшается настолько, что обычный текст интерфейса становится нечитаемым.
Три модуля чтения
engine= | Что это |
|---|---|
"builtin" | По умолчанию. Работает на вашем компьютере, бесплатно, и переносится внутрь экспортированной программы. |
"tesseract" | Тоже локальный и бесплатный. Одни экраны читает лучше встроенного модуля, другие хуже. Только он принимает page_mode=, который определяет, как изображение разбивается на строки. Попробуйте его, когда прочитанное близко к нужному, но всё же неверно. |
"ai" | Модель транскрибации на сервере. Тратит кредиты и блокирует экспорт; см. Кредиты. Используйте её, когда оба локальных модуля неверно читают что-то важное. |
Модуль выбирается для каждого шага отдельно. engine="ai" транскрибирует; чтобы рассуждать о том, что на экране, используйте ask_ai.
Очистка полученного текста
total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
notify("Total looks low: ${total}")
Методы перечислены в разделе Очистка прочитанного. Пустая область сохраняет "", и запуск продолжается. single_line=True объединяет результат в одну строку.
Вопросы к ИИ
ask_ai задаёт визуальной модели вопрос о части экрана и сохраняет ответ: “сколько строк красных?”, “есть ли окно с ошибкой?”.
n = ask_ai("how many error icons are visible", role="count", region=(0, 0, 800, 600))
if n:
click(n.1.x, n.1.y)
Каждый вызов тратит кредиты и делает экспорт невозможным; см. Кредиты. За один запуск допускается не более 60 вызовов ИИ.
Три роли
role= | Ответ |
|---|---|
"count" | По умолчанию. Число, а также место каждого найденного объекта: n — количество, n.1.x / n.1.y — первая позиция, n.2.x — вторая. Индексом может быть переменная: click(n.${i}.x, n.${i}.y). Роли «да/нет» нет: if n: означает “это есть”, if not n: — “этого нет”. |
"explain" | Предложение — для log() или notify(). |
"read" | Распознанный текст, полученный выбранной вами моделью, — в отличие от read_text(engine="ai"), где модель распознавания фиксирована. |
Выбор модели
model= принимает короткое имя. Актуальный список с ценами для той области, которую читает ваш шаг, находится в окне параметров команды (дважды щёлкните вызов ask_ai на вкладке «Скрипт»). Рекомендуется оставить модель по умолчанию с её уровнем рассуждения по умолчанию: не указывайте model= и reasoning= в вызове — сервер выберет их сам, сейчас это glm. Таблица нужна на случай, когда у вас есть причина поступить иначе: самая дорогая модель не самая точная для любого вопроса, а gemma, самая дешёвая, оказалась самой точной на небольшом фрагменте.
| Имя | Модель | Уровни reasoning= | temperature= |
|---|---|---|---|
gemma | Google Gemma 3 12B | — | 0–2 |
glm | GLM 5.3 Flash (по умолчанию) | — | 0–2 |
qwen-vl | Qwen3-VL 30B | — | 0–2 |
gemini-lite | Gemini 3.1 Flash Lite | — | 0–2 |
gemini | Gemini 3.7 Flash | low, medium, high | — |
haiku | Claude Haiku 4.5 | — | 0–1 |
sonnet | Claude Sonnet 5 | low, medium, high, xhigh, max (по умолчанию high) | — |
gemini-pro | Gemini 3.1 Pro | low, medium, high | 0–2 |
kimi | Kimi K3 | low, high, max (всегда рассуждает; по умолчанию max) | — |
opus | Claude Opus 5 | low, medium, high, xhigh, max (по умолчанию high) | — |
Всегда указывайте region=. Модель может сосчитать объекты на всём рабочем столе, но затем не сумеет сказать, где они; макросу, который собирается щёлкнуть, нужна небольшая картинка. То же относится к read_text и к строкам наблюдения с ИИ.
Справочник по скриптам
Скрипт похож на Python и использует лишь малую его часть: переменные, арифметику, if/else, циклы while и repeat, вызовы команд и функции def, отступ в четыре пробела, комментарии #. Блоки вкладываются друг в друга; только разделы обязаны оставаться у левого края. Списков, склейки строк через + и импортов нет.
Полный справочник — каждая команда, каждый её аргумент, названия клавиш и разобранный пример к каждой — находится в самой программе, рядом с редактором, в котором вы пишете скрипты. На вкладке «Скрипт» откройте список команд и щёлкните правой кнопкой по любой команде, чтобы открыть её страницу справки; выберите команду и нажмите «Вставить», чтобы поставить готовый вызов в позицию курсора. Двойной щелчок по вызову открывает окно его параметров, где перечислены все параметры, которые принимает эта команда.
Именованные аргументы можно передавать по порядку, без имён: press("a", 0.5) — это то же самое, что press("a", hold=0.5). Каждая команда также принимает label="name".
Наблюдение
Наблюдатель — это сторож. Он следит за экраном, пока выполняется макрос, или сам по себе после нажатия Начать наблюдение, — за тем, что может произойти: окном сбоя, баннером об истёкшем сеансе, предупреждением о том, что товара нет в наличии. wait_for смотрит только там, где вы его поставили; наблюдатель смотрит всё время.
За чем следит строка
Переключатель Способ выбирает одно из двух: изображение, которое нужно найти, или вопрос, который нужно задать.
| Тип | Что он делает |
|---|---|
| Изображение | Именованный фрагмент, сопоставляемый так же, как в wait_for. Бесплатно и сколько угодно часто. |
| Спросить ИИ | Вопрос к визуальной модели: “есть ли окно с ошибкой?” Ответ — количество; 0 означает, что ничего не найдено. Тратит кредиты; см. Кредиты. |
Когда срабатывает
| Параметр | Значение |
|---|---|
| Появляется | Изображение появилось или количество изменилось с 0 на любое другое число. |
| Исчезает | Оно было, а теперь его нет. Строка должна сначала увидеть его, поэтому она никогда не срабатывает на том, что вы ещё не открыли. |
| Анализ | Только для строк с ИИ. Переходов нет: модель описывает то, что видит, и строка отправляет это описание при каждой проверке. |
Остальная часть строки
| Столбец | Что он делает |
|---|---|
| Где искать | В какой части экрана искать или о какой спрашивать. Пусто — значит везде. Строке с ИИ задавайте небольшую область; см. Вопросы к ИИ. |
| Совпадение | Строки с изображением: Цвет строже, Форма сопоставляет только контур и переживает смену темы. Шестерёнка рядом хранит период тишины. Строки с ИИ используют эту ячейку для модели, рассуждения, температуры, области и периода тишины. |
| Интервал проверки | Как часто эта строка проверяет экран, в секундах. Для строки с ИИ нельзя задать меньше одной секунды, а по умолчанию — шестьдесят. |
| Начать через | Задержка между нажатием Начать наблюдение и началом работы этой строки, чтобы программа успела загрузиться. Отсчитывается заново при каждом запуске наблюдения. |
| Сообщение | Текст оповещения. ${name} подставляется. Если оставить пусто, строка в режиме «Анализ» отправит предложение, полученное от самой модели. |
Что происходит при срабатывании
Окно на экране, Telegram, Discord и приложенный снимок экрана. Кнопки на строке выбирают способы доставки, а учётные данные берутся из «Параметров». Остановка останавливает макрос и прекращает наблюдение. Строка в режиме Анализ срабатывает при каждой проверке, поэтому останавливать макрос она не может.
В параметрах строки есть ещё период тишины между сообщениями — отдельно от того, как часто она проверяет экран. Параметры → Уведомления умеют, кроме того, отправлять снимок экрана по таймеру, пока включено наблюдение.
Экспорт
Кнопка Экспорт переносит каждую включённую строку наблюдения, у которой есть изображение, вместе с её фрагментом и её параметрами. Экспортированная программа запускает их с каждым запуском и останавливает по его завершении — ровно так же, как здесь это делает Запустить. Строки, которые спрашивают ИИ, при экспорте отклоняются с указанием их названий; сначала выключите их. Дойдут ли до вас их оповещения в Telegram или Discord, зависит от ответа на вопрос об учётных данных при экспорте.
Автокликер
Вкладка Кликер щёлкает или нажимает клавишу снова и снова, пока вы её не остановите: в позиции курсора, в заданной точке или по последовательности точек, которую вы записываете, щёлкая по ним. Это не макрос — в проект ничего не попадает — но всё, что задано на вкладке, запоминается до следующего раза.
Три режима
| Режим | Что он делает |
|---|---|
| Щелчок | Один щелчок, повторяемый снова и снова. Левой, правой или средней кнопкой; одиночный, двойной или тройной. В позиции курсора, где он следует за мышью; в заданной точке, которую вы выбираете на замороженном экране; или блуждая внутри рамки. |
| Нажатие клавиши | Одна клавиша, нажимаемая снова и снова. |
| Последовательность точек | Несколько мест, по которым щёлкают по порядку, круг за кругом; у каждого своя пауза, кнопка и тип щелчка. |
Параметры
| Параметр | Значение |
|---|---|
| Пауза между | Время между щелчками в миллисекундах плюс необязательный разброс: сверх этого добавляется случайная величина, не больше заданной, — своя для каждого щелчка, поэтому ритм никогда не бывает точным. Зелёная плашка рядом показывает, сколько это даёт щелчков в секунду с учётом удержания и разброса. |
| Удерживать | Сколько времени кнопка или клавиша остаётся нажатой при каждом щелчке; у этого значения есть свой разброс. |
| Остановить после | До остановки, заданное число щелчков (для последовательности — проходов) или заданное время. |
| Разброс | Насколько далеко от своей точки может попасть каждый щелчок, в любую сторону, чтобы долгий запуск не бил в один и тот же пиксель. 0 — точно в точку. Задавайте его меньше размера цели. |
| Блуждание в рамке | Выберите рамку, а затем точку внутри неё, с которой начать; каждый щелчок отходит от предыдущего не дальше заданного и никогда не выходит за рамку. |
| Горячая клавиша | F7 запускает, F8 останавливает — из любой программы. Изменить их можно в разделе Параметры → Горячие клавиши. |
Запись последовательности
В режиме Последовательность точек нажмите Записать точки и щёлкните левой кнопкой по очереди в каждом месте — в самой программе. Каждый щелчок добавляет строку прямо у вас на глазах. Щелчок, которым вы нажимаете «Стоп», — как и любой другой щелчок по окну Recorder — не считается. Дальше у каждой строки своя пауза, кнопка и тип щелчка, а Выбрать переносит одну точку на замороженном экране.
Как его остановить
- Кнопка Стоп, клавиша «Остановить кликер», клавиша остановки воспроизведения или Esc, когда окно Recorder на переднем плане.
- Режим удержания: щелчки идут, только пока удерживается клавиша запуска, и сама клавиша по-прежнему доходит до программы под указателем.
- Остановить, когда курсор касается верхнего края экрана: доведите мышь до верхнего края, и щелчки прекратятся, в любом режиме — выход, для которого не нужна клавиатура.
- Остановить, если мышь сдвинули рукой: в тот момент, когда указатель окажется там, куда кликер его не ставил.
Кнопка Старт сначала немного ждёт, чтобы мышь успела уйти с окна; горячая клавиша запускает сразу.
Что входит в каждый тариф
Сам кликер есть во всех тарифах: один щелчок или одна клавиша с точной частотой, в позиции курсора или в заданной точке, с числом повторов, ограничением по времени и всеми способами остановки. Basic и Pro добавляют режим Как человек (курсор подводится к каждому щелчку, а удержание варьируется), оба разброса по времени, разброс по месту, последовательности точек и блуждание в рамке. В тарифе Free эти элементы управления показаны серыми, с замком рядом, а то, что вы задали при платном тарифе, сохраняется и ждёт, когда тариф снова будет его покрывать.
Человекоподобное движение нужно для того, чтобы запуск вёл себя как рука на мыши в обычных программах. Recorder никак не скрывает себя ни от одной программы.
Экспорт в программу
Файл → Экспорт в программу… создаёт один файл .exe, в котором есть макрос, его фрагменты и тот модуль чтения текста, с которым он настраивался. Ему не нужны ни установщик, ни среда выполнения, ни копия Recorder.
- Диалог экспорта предлагает окно управления: «Запустить», «Пауза» и «Стоп» с их клавишами, «Повтор» и «Скорость», а также строку состояния. Без него программа запускается сразу при открытии, ничего не показывает и закрывается, когда макрос заканчивается — это правильно для того, что запускает планировщик, и неправильно для первой пробы. Включайте окно для всего, что будете запускать вручную: тогда о проблеме сообщит сообщение на экране, а не пройдёт незаметно.
- Ваши клавиши «Запустить», «Пауза» и «Стоп» переносятся в том виде, в каком они назначены в Параметры → Горячие клавиши на момент экспорта; так же переносятся включённые строки наблюдения и параметр повтора клавиш.
- Макросы, которые используют ИИ (
ask_aiилиread_textсengine="ai"), к экспорту не принимаются — программа называет эти шаги. Оба локальных модуля чтения текста переносятся внутри файла. - Если макрос или строка наблюдения отправляет сообщения в Telegram или Discord и один из них настроен, Recorder спросит, включать ли эти учётные данные; любой, у кого есть файл, сможет их прочитать. Без них шаги уведомлений и оповещения ничего не отправят. Для Telegram и Discord нужен тариф Basic или Pro: на тарифе Free вопрос не задаётся и данные не переносятся.
Как остановить экспортированную программу
Вашей клавишей остановки воспроизведения в том виде, в каком она была назначена на момент экспорта, — F6, если вы её не меняли. Отключённая клавиша остановки заменяется на F6, потому что макрос, который нельзя остановить, не будет запущен.
Если эту клавишу занимает другое приложение, программа пробует её с Ctrl+Shift, затем с Ctrl+Alt и перед первым шагом сообщает, какое сочетание сработало. Если зарегистрировать не удалось ни одно, макрос вообще не запускается и сообщает причину.
Экспортированная программа содержит всё, что есть в макросе, включая любой введённый вами текст. Проверьте её на пароли и токены, прежде чем кому-либо отправлять. У файла нет цифровой подписи, поэтому при первом запуске SmartScreen может показать предупреждение.
ИИ-ассистент
Опишите нужный вам макрос, и ассистент напишет скрипт. Ничего не попадает в ваш редактор, пока вы это не одобрите: прочитайте ответ, затем нажмите «Использовать» или «Заменить». Каждый ответ проверяется компилятором; если он не компилируется, ассистент делает одну автоматическую попытку исправления, которая тратит кредит.
Два режима. «Сборка» пишет макрос. «План» расспрашивает о задаче и ничего не пишет, пока вы не нажмёте «Написать макрос»; начинайте с него для всего, что длиннее нескольких шагов. Ctrl+Enter отправляет сообщение; «Новый» начинает новый разговор и удаляет сохранённую переписку.
«Модель» и «Рассуждение»: оставьте у обоих значение «По умолчанию». «Средний» и «Высший» — это другие модели, а не более качественные, и более высокий уровень рассуждения стоит дороже за каждый ход и редко меняет скрипт. «Восстановление» заставляет макрос самостоятельно находить путь обратно после неудачного щелчка вместо остановки; «Паузы после щелчков» делает короткую паузу после каждого щелчка, чтобы следующий шаг не опережал экран. Обычно оба оставляют включёнными.
Как получить хороший ответ
- Сначала вырежьте фрагменты. Ассистенту сообщают, какие имена фрагментов существуют. Без них он может писать только координаты.
- Опишите, как выглядит экран, а не только цель. «Щёлкни „Обновить всё“ и дождись, пока в строке состояния появится „Готово“» лучше, чем «обнови таблицу».
- Уточняйте в разговоре. «Вместо паузы дождись диалога сохранения» — обычное продолжение.
Кредиты
Кредиты тратит всё, что обращается к серверу: ходы ассистента (включая попытку исправления), шаги ask_ai, строки наблюдения с ИИ, read_text с engine="ai" и каждый шаг запуска агента. Запись, воспроизведение, привязка к изображениям, оба локальных модуля чтения текста и экспорт не стоят ничего. Баланс показан рядом с состоянием входа, на панели ассистента и на странице вашей учётной записи; каждый шаг с ИИ записывает свою стоимость в журнал запуска. Тарифы и пакеты кредитов — на странице цен.
Любой шаг с ИИ в макросе (ask_ai, read_text с engine="ai", строка наблюдения с ИИ) тратит кредиты, требует выполненного входа в учётную запись и блокирует экспорт. У экспортированной программы нет учётной записи, с которой можно списать плату.
Агент
Вкладка «Агент» — третий режим работы. Напишите цель, и ИИ выполнит её на вашем рабочем столе, шаг за шагом, проверяя экран после каждого шага. Это computer use на вашем собственном рабочем столе, с настоящей мышью и клавиатурой. Лучше всего он справляется с короткими наглядными задачами на одном экране — открыть страницу, заполнить форму, пройти несколько экранов; длинную или необычную работу лучше записать как макрос. Первые несколько раз понаблюдайте за ним.
Каждый шаг — это один запрос к ИИ, оплачиваемый теми же кредитами, что и ask_ai — включая шаги запуска, который так и не дошёл до цели. Агент видит только экран; текст на этом экране никогда не является для него инструкцией.
Это не ассистент. Ассистент пишет макрос, который вы сохраняете и воспроизводите; агент выполняет работу сейчас и ничего после себя не оставляет.
Выполнение задачи
- Напишите цель: открой папку загрузок и отсортируй её по дате. Кнопка «Сохранить» добавляет цель в список «Сохранённые»; «Удалить» убирает её оттуда.
- Нажмите «Старт» или Ctrl+Enter. Recorder один раз за запуск спрашивает «Передать управление агенту?», повторяя цель и то, что агенту разрешено. Без сочетания клавиш остановки воспроизведения он не запустится; см. «Воспроизведение».
- Следите за лентой шагов. Каждый шаг показывает, что агент увидел, его вердикт о предыдущем шаге (да, нет или неясно), что он делает сейчас и сколько это стоило. В нижней строке остаются общий итог запуска и остаток ваших кредитов.
- В любой момент нажмите «Стоп» или своё сочетание клавиш остановки.
Запуск завершается состоянием «Готово», «Застрял» или «Остановлено» — с потраченными кредитами, числом шагов и причиной: шаг, который не удался три раза, сорок шагов без завершения, предел кредитов или ваша клавиша остановки.
Когда задача — это вопрос (скажи, на каком тарифе эта учётная запись), ответ возвращается в виде отчёта: окно с сообщением или тот из каналов — уведомление на рабочем столе, Telegram или Discord, — который включён в разделе Параметры → Уведомления.
Параметры
| Модель | «По умолчанию», «Средний» или «Высший». «Высший» — рекомендуемая настройка; новый профиль начинается именно с неё. |
| Оптимизатор кредитов | Отправляет на каждом шаге уменьшенный снимок экрана, примерно на пятую часть дешевле за запуск. Отключите его, если агент не замечает мелкий текст. |
| Выучить как макрос | В этой сборке недоступно; флажок неактивен. Агент не оставляет после себя макрос. |
Что ему разрешено
Строка под флажками говорит, что агенту разрешено использовать: по умолчанию это мышь, клавиатура, время, запуск программ и сообщения. «Разрешения» открывает Параметры → Агент, где каждый пункт — это флажок в группе «Ему разрешено»:
| Разрешение | По умолчанию |
|---|---|
| Перемещать мышь и щёлкать | вкл. |
| Печатать на клавиатуре | вкл. |
| Ждать | вкл. |
| Открывать файлы, папки и веб-страницы | вкл. |
| Сообщать о найденном | вкл. |
| Выполнять команды | выкл. — оставьте выключенным. Эта возможность ещё недостаточно проверена. |
| Перезагружать или выключать компьютер | выкл. |
Оставьте последние два выключенными. Командная строка с вашими правами может сделать всё, что можете вы, а агент не отличает безопасную команду от разрушительной.
«Он останавливается, когда» задаёт пределы: число шагов в запуске, число неудач одного шага и кредиты на запуск (0 — без предела). «Темп» задаёт, сколько агент ждёт, пока экран успокоится, сколько ждёт между шагами и сколько между действиями внутри одного шага. Увеличьте последнее значение для приложения, которое не успевает за связкой «щёлкнуть и сразу печатать».
Параметры
Нажмите «Параметры» в строке меню. Семь вкладок: «Горячие клавиши», «Запись», «Клавиатура», «Окно», «Уведомления», «Журнал» и «Агент». «ОК» применяет изменения, «Отмена» отменяет их, а «Восстановить по умолчанию» сбрасывает всё, кроме ваших учётных данных Telegram и Discord.
Горячие клавиши
Семь глобальных горячих клавиш — это значения по умолчанию, а не жёстко заданные. Любую из них можно переназначить или отключить здесь, и эта вкладка — единственное место, где видны текущие настройки. Щёлкните поле и нажмите сочетание; Esc очищает его. Два действия не могут использовать одну и ту же клавишу, и Recorder предупредит, если клавишу уже заняло другое приложение. Значения по умолчанию — в разделе «Воспроизведение».
«Запись» и «Клавиатура»
На вкладке «Запись» собраны переключатели захвата и обратный отсчёт перед проверкой. Вкладка «Клавиатура» определяет, повторяется ли удерживаемая клавиша как на настоящей клавиатуре: по умолчанию выключено, с задержкой, частотой, необязательным разбросом интервала и кнопкой «Как на этом ПК», которая копирует ваши настройки Windows. Этот параметр переносится вместе с экспортированной программой.
Окно
Скрытие окна во время работы, «Использовать все мониторы», тёмная тема и «Размер текста» от 85% до 140%. Последние два применяются сразу.
Уведомления
По умолчанию выключено. После включения Recorder может сообщать вам, когда заканчивается запись, когда заканчивается воспроизведение и когда воспроизведение прервано, — уведомлением на рабочем столе, в Discord, в Telegram или любым сочетанием этих способов. Уведомления на рабочем столе доступны на любом тарифе; для Telegram и Discord нужен тариф Basic или Pro. На тарифе Free оба флажка неактивны, а причина указана под ними; введённый вами токен или вебхук сохраняется до тех пор, пока ваш тариф его не покроет. «Наблюдение» использует те же каналы, с переключателями для каждой строки. «Качество изображения» задаёт размер прикреплённых снимков экрана — от «Очень низкий» до «Без потерь».
Discord
Одно поле: URL вебхука.
- Создайте вебхук в Discord. Откройте Настройки сервера → Интеграции → Вебхуки, выберите «Новый вебхук», укажите канал, дайте ему имя и нажмите «Скопировать URL вебхука». Для этого нужно право «Управление вебхуками».
- Вставьте его в Recorder. Параметры → Уведомления, отметьте Discord, вставьте URL.
- Отправьте проверочное сообщение. Оно должно появиться в канале за несколько секунд.
URL вебхука — это пароль. Любой, у кого он есть, может писать в этот канал. Если он утёк, удалите вебхук в Discord и создайте новый; при экспорте программы, которая его использует, сначала будет задан вопрос.
Telegram
Нужны токен бота от BotFather и числовой ID чата этого разговора. Оба вводятся в разделе Параметры → Уведомления.
Снимок экрана по таймеру
«Отправлять снимок экрана во время наблюдения» публикует снимок экрана в Telegram и Discord каждые N секунд — выбранной вами области или всего экрана. Это работает, только пока включено «Начать наблюдение», и никогда не использует всплывающее уведомление на рабочем столе.
Что отправляется
| Всегда | Строка текста о том, что завершилось, или сообщение, заданное вами в строке наблюдения. |
| По желанию | Снимок экрана, если вы включили его для строки наблюдения или включили снимок по таймеру. На нём видно всё, что было на экране в выбранной области в тот момент. |
| Никогда | Ваш макрос, ваши скрипты, ваши фрагменты и что-либо о вашей учётной записи. |
Сообщения идут напрямую с вашего компьютера в Discord или Telegram, минуя наши серверы.
Диагностический журнал
Вид → Журнал показывает, что происходит во время запуска, а Параметры → Журнал выбирает, что в него записывается. Если макрос ведёт себя не так, первым делом включите «Каждый шаг». «Содержимое текста» записывает символы, считанные с вашего экрана, в открытом виде; выключите этот пункт, как только найдёте проблему.
Ваша лицензия
Один компьютер одновременно
Чтобы перейти на другой компьютер, выйдите из учётной записи на старом, затем войдите на новом. Если старого компьютера больше нет, всё равно войдите на новом: когда старый не выходит на связь 30 дней, его место переходит к новому.
Автономная работа
Обрыв соединения не останавливает запуск: в строке состояния появляется “Вход выполнен (автономная работа)”, и Recorder продолжает работать. Он останавливается, только если долго остаётся без сети.
Возможности, не входящие в ваш тариф
Тарифом определяются шесть вещей: функции ИИ, чтение текста с экрана, наблюдение за экраном, экспорт в программу, оповещения в Telegram и Discord и дополнительные возможности автокликера (человекоподобные щелчки, разброс по времени, разброс по месту, последовательности точек и блуждание в рамке). Элемент управления, который не входит в ваш тариф, становится красным, и щелчок по нему объясняет причину; два флажка уведомлений и дополнительные элементы кликера становятся неактивными, с замком и причиной рядом.
Изменения вступают в силу примерно в течение получаса. Диалог «Учётная запись» показывает ваш тариф и баланс кредитов.
Устранение неполадок
| Признак | Обычная причина и решение |
|---|---|
| Щелчки попадают не туда | Записанные координаты абсолютны (см. «Запись»), а окно сместилось или изменилось разрешение экрана. Замените click(x, y) на click_crop("name"). |
| Работает при пошаговом прогоне и не работает на полной скорости | Приложению нужно время. Щелчки уже задерживаются на цели на pre_click_ms=200; попробуйте 400–600 для неудачного щелчка или, что лучше, дождитесь нужного элемента через wait_for. |
wait_for истекает по тайм-ауту, хотя изображение видно |
Во фрагмент попал фон, который изменился, или у элемента другая тема оформления. Вырежьте фрагмент плотнее, уменьшите confidence или попробуйте match="shape". Тема журнала «Поиск изображений» показывает оценки совпадения. |
read_text возвращает бессмыслицу |
Не указана region или она слишком велика. Сузьте её до самого текста и попробуйте engine="tesseract", если встроенный модуль чтения всё равно не справляется. |
Шаг ask_ai или строка наблюдения с ИИ ничего не отвечает |
Нужны выполненный вход в учётную запись с кредитами и достаточно маленькая region=, чтобы нужное было читаемо. |
| Агент не запускается | Не назначено сочетание клавиш остановки воспроизведения (диалог сообщает: «Агенту нужна клавиша остановки»). Назначьте его в разделе Параметры → Горячие клавиши. Также нужен выполненный вход в учётную запись с кредитами. |
| Агент завершается со статусом «Остановлено» или «Застрял» | Достигнут один из пределов (один шаг не удался три раза, сорок шагов или предел кредитов) либо модель сдалась; последняя строка говорит, что именно. Разбейте цель на задачи поменьше, отключите оптимизатор кредитов или поднимите пределы в разделе Параметры → Агент. |
| После запуска клавиатура залипла | key_down без парного key_up. Нажмите и отпустите модификатор вручную, затем исправьте макрос. |
| Воспроизведение останавливается с ошибкой о неизвестной метке | Стрелка goto, on_no, on_fail или wait_any указывает на имя, которого нет ни в метках шагов, ни в названиях разделов. Проверьте написание: метки и названия разделов чувствительны к регистру. |
| Горячая клавиша ничего не делает | Она переназначена, отключена или её первым зарегистрировало другое приложение; Windows не даёт двум программам делить глобальную клавишу. Проверьте Параметры → Горячие клавиши. |
| Экспортированная программа не останавливается по F6 | Вашу клавишу остановки занимает что-то другое, поэтому программа назначила её с Ctrl+Shift или Ctrl+Alt и сообщила об этом перед запуском. Клавиши переносятся в том виде, в каком они назначены в Параметры → Горячие клавиши на момент экспорта; переназначив их, экспортируйте программу заново. |
| При запуске воспроизведения ничего не происходит | Целевое приложение запущено от имени администратора, а Recorder — нет. Запустите Recorder тоже от имени администратора. |
| Кнопка красная | Ваш тариф не включает эту функцию. Щёлкните кнопку — сообщение скажет, какую именно. См. «Ваша лицензия». |
| Экспортированная программа не делает ничего заметного | Она экспортирована без окна управления, поэтому запускается сразу при открытии и закрывается, когда макрос заканчивается. Экспортируйте её заново с отмеченным пунктом «Показывать окно управления»: тогда «Запустить», «Пауза» и «Стоп» будут на экране, а о любой неполадке сообщит сообщение. |
Всё ещё не получается?
Напишите на support@mynarecorder.com. Если вы опишете, чего ожидали и что произошло вместо этого, и приложите журнал, когда он есть, то получите содержательный ответ с первого письма.