Версия Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Практическое руководство по Rive CLI и программированию с ИИ-агентами

> Практическое руководство по работе с Rive CLI и RML вместе с программирующим ИИ-агентом: создание, проверка и тестирование интерактивной графики с учётом ограничений учётной записи, подписи и экспорта.

By BIG CHANGE Editorial

Published: 2026-09-27T00:12:27.556Z
Updated: 2026-09-27T00:17:31.324Z
Canonical: https://bigchange.ai/blog/rive-cli-rml-coding-agents-guide

![A designer holds a controller while viewing an orange jointed animation shape on a wall-mounted display, with a smaller screen of indented lines nearby.](https://bigchange.ai/api/media/file/rive-cli-animation-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Новый интерфейс командной строки Rive позволяет программирующему агенту работать с интерактивной графикой как с файлами проекта. Агент может создавать разметку Rive (RML), скрипты Luau и шейдеры, а затем просить CLI скомпилировать проект, проверить его структуру, провести тесты и отобразить результат. Человек может следить за локальным предпросмотром и вносить правки в дизайн. Сотрудники Rive представили CLI как **техническую предварительную версию 11 сентября**; на [странице загрузок Rive](https://rive.app/downloads), проверенной 27 сентября, программа указана в разделе **раннего доступа**.

Этот список действий основан на [документации Rive](https://rive.app/docs/cli/overview). BIG CHANGE изучил только документацию: мы не устанавливали CLI, не создавали файл и не проверяли графику, подготовленную агентом. В [видеоруководстве](https://youtu.be/Y3E33otHeLE) показан предполагаемый процесс совместной работы человека и агента.

## Главное изменение

- **Что изменилось:** у сцен Rive появился текстовый способ работы для программирующих агентов. Агент может редактировать RML в папке проекта, а CLI компилирует `.riv` для сред выполнения или `.rev` для дальнейшей работы в редакторе.
- **Почему это важно:** Дизайнеры, разработчики интерфейсов и игр могут просматривать изменения исходных файлов вместе с остальными файлами проекта и пользоваться проверками CLI в ходе итераций. Перед использованием ресурса в продукте всё равно нужно оценить готовый дизайн и взаимодействия.
- **За чем следить:** Перенос локального прототипа в веб — отдельное решение. Файлы со скриптами требуют подписанной `--publish` сборки; для чистого `.riv` также необходимо связать проект с файлом учётной записи и использовать рабочее пространство уровня Cadet или выше. Перед развёртыванием проверьте эти условия и итоговую графику.

## План действий по документации

1. **Проверьте доступ и установите CLI.** Rive указывает поддержку macOS на Apple Silicon, Linux x86\_64 и Windows. В [руководстве «Начало работы»](https://rive.app/docs/cli/getting-started) приведены отдельные инструкции по установке для Windows и macOS/Linux; для Windows следуйте актуальной инструкции на этой странице. Затем выполните `rive doctor` после установки. В справочнике команд также описана команда `rive --version`; запишите фактически установленную версию, поскольку это предварительная версия программы. В объявлении от 11 сентября Rive сообщала, что во время предварительного периода CLI бесплатен без ограничений, *пока длится предварительный доступ*. Это датированное заявление не определяет постоянную цену CLI. [Актуальная таблица тарифов](https://rive.app/pricing) относится к учётным записям Rive и встроенному агенту редактора; перед публикацией проверьте действующие условия.
2. **Создайте текстовый проект и откройте предпросмотр.** `rive create myproject` создаёт `scene.rml`, `rive.yaml`, инструкции для агента в `AGENTS.md` и `CLAUDE.md`, а также файл `.gitignore`. Выполните `rive myproject` в одном терминале. По документации Rive, программа следит за папкой, заново собирает проект после сохранения файлов и записывает `myproject/build/myproject.riv`. Стартовая сцена содержит монтажную область, временную шкалу и машину состояний, но пока не содержит рисунков. В начальном предпросмотре виден тёмный прямоугольник.
3. **Передайте программирующему агенту папку проекта и конкретную задачу по дизайну.** В [руководстве по ИИ-агентам](https://rive.app/docs/cli/agents) в качестве примеров названы Claude Code, Cursor и другие агенты, которые умеют читать и записывать файлы, а также выполнять команды оболочки. Сгенерированные инструкции объясняют агенту, как пользоваться `rive docs` и `rive schema`, чтобы находить поддерживаемые объекты и свойства. RML — это XML: элементы соответствуют типам Rive, атрибуты — их свойствам, а вложенность связывает объекты. Агент также может редактировать `.luau` скрипты, `.wgsl` шейдеры и ресурсы проекта. Просите агента работать поэтапно, чтобы вы могли корректировать компоновку и поведение, пока обновляется предпросмотр.
4. **Проверьте сборку и её содержимое.** Попросите агента выполнить `rive myproject --verify`, которая компилирует проект, не создавая файл `.riv`, и `rive inspect myproject --summary`, которая сообщает об ошибках и количестве объектов. Полностью разрешённую сцену можно получить командой `rive inspect myproject --json` описана в документации. Если нужен распространяемый локальный файл без открытия предпросмотра, команда `rive myproject --once` создаёт неподписанный файл `.riv`. Эти проверки помогают обнаружить ошибки компиляции, а также отсутствующие или неожиданные объекты сцены. [В руководстве Rive по RML](https://rive.app/docs/runtimes/advanced-topic/rml) отдельно предупреждается: успешная сборка не гарантирует, что графика выглядит или работает так, как задумано.
5. **Сделайте снимки важных состояний.** `rive myproject --screenshot=out.png` создаёт PNG без открытия окна. В [примерах Rive](https://rive.app/docs/cli/examples) используется параметр `--advance=1s` для получения кадра после запуска анимации, `--viewport=390x844` для выбора размера макета, `--data=battery/level=100` для связанных данных и `--pointer=click@120,60 --advance=20` для имитации щелчка. Подбирайте значения и координаты для собственной сцены. Сравнивайте снимки в разных состояниях и при разных размерах окна, а затем осматривайте их сами. Снимок без параметра `--advance` показывает исходную позу сцены; она не обязательно совпадает с первым кадром анимации.
6. **Запускайте тесты скриптов, если они есть в проекте.** `rive myproject --test` запускает скрипты Luau, размещённые в каталоге `Tests`. В документации Rive описаны `--verify --format=json` и `--test --format=json` для автоматических проверок; при ошибке сборки или теста процесс завершается с ненулевым кодом. Агент может использовать эти отчёты для исправления исходных файлов. Тесты проверяют только написанные утверждения, поэтому отдельно проверяйте взаимодействия, не охваченные тестами.
7. **Выберите способ работы с учётной записью, когда локальный прототип будет готов.** Файл `.riv` — ресурс для среды выполнения; файл `.rev` открывается для редактирования в редакторе Rive. По словам Rive, локальное создание, предпросмотр, проверки, тесты и снимки экрана работают без входа в учётную запись и даже без подключения к сети. `rive login` требуется для `--publish`, `--rev`, `rive push`, `rive pull` и импорта удалённого файла учётной записи. Если нужно начать с резервной копии, экспортированной из редактора, команда `rive create myproject --from-rev=myfile.rev` работает без входа. Чтобы начать с файла учётной записи, используйте `rive create myproject --from-remote-file` после входа. Эта команда связывает проект с таким файлом: `rive push myproject` загружает новую версию; `rive pull myproject` загружает изменения из редактора в проект; команда **перезаписывает локальную сцену, скрипты и ресурсы** после подтверждения. Перед загрузкой проверьте локальные изменения.
8. **Перед публикацией проверьте подпись и ограничения экспорта.** `rive myproject --publish` создаёт подписанный файл `.riv` и требует входа в учётную запись. Rive сообщает, что веб-среды выполнения и её CDN отклоняют неподписанные скрипты, поэтому файлы со скриптами для веба необходимо собирать именно так. Команда `--publish` может добавить водяной знак. В [справочнике команд](https://rive.app/docs/cli/reference/commands) сказано, что для чистого `.riv` проект должен быть связан с файлом учётной записи через `rive push` и сам файл должен находиться в рабочем пространстве уровня Cadet или выше. Условие о водяном знаке действует, даже если в сцене нет скриптов. Команда `--rev=<path>` также требует входа и может использоваться вместе с `--once` или `--publish`; она создаёт файл для редактора, а не замену ресурсу для среды выполнения. Перед развёртыванием проверьте действующий тариф учётной записи и фактически экспортированный результат.

В редакторе Rive также есть [встроенный ИИ-агент](https://rive.app/docs/editor/ai-agent). Он открывается на боковой панели редактора; его работа зависит от тарифа редактора и условий по кредитам ИИ. В этом руководстве описана работа программирующего агента с папкой проекта и CLI; у этих двух способов работы с агентами разные интерфейсы и условия оплаты.

## Источники и дополнительная литература

- [Обзор Rive CLI](https://rive.app/docs/cli/overview) описывает работу из терминала, форматы результатов, предпросмотр и обмен файлами учётной записи.
- [Руководство «Начало работы»](https://rive.app/docs/cli/getting-started) перечисляет поддерживаемые системы, установку, состав шаблона проекта, локальную сборку и условия входа.
- [Руководство «Работа с ИИ-агентами»](https://rive.app/docs/cli/agents) показывает, как программирующий агент использует сгенерированные инструкции проекта и ответы CLI. В [руководстве по встроенному агенту редактора](https://rive.app/docs/editor/ai-agent) описан отдельный интерфейс внутри редактора.
- [Руководство по RML](https://rive.app/docs/runtimes/advanced-topic/rml), [справочник команд](https://rive.app/docs/cli/reference/commands) и [примеры](https://rive.app/docs/cli/examples) подтверждают устройство файлов, точные команды, работу тестов и снимков, а также ограничения публикации.
- [Объявление сотрудников Rive от 11 сентября](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) датирует техническую предварительную версию и временное заявление о бесплатном CLI. [Страница загрузок](https://rive.app/downloads) сейчас обозначает CLI как продукт раннего доступа; [страница тарифов](https://rive.app/pricing) перечисляет условия для учётных записей. О [видеоруководстве Rive](https://youtu.be/Y3E33otHeLE) можно посмотреть процесс совместной работы человека и агента.

## Sources

- [Обзор Rive CLI](https://rive.app/docs/cli/overview) — Описывает назначение CLI, локальные результаты .riv и .rev, предпросмотр в реальном времени, проверку, тесты, снимки и удалённый обмен файлами.
- [Руководство Rive CLI «Начало работы»](https://rive.app/docs/cli/getting-started) — Описывает поддерживаемые платформы, установку, шаблон проекта, вывод предпросмотра, .rev и удалённый импорт, необходимость входа, подпись скриптов и условия появления водяного знака.
- [Работа с ИИ-агентами](https://rive.app/docs/cli/agents) — Описывает работу с внешними программирующими агентами, созданные инструкции для агента, поиск по справочнику, проверку, изучение структуры и поэтапное управление со стороны человека.
- [Язык разметки Rive (RML)](https://rive.app/docs/runtimes/advanced-topic/rml) — Определяет структуру RML и компиляцию текстового проекта, а также раздельные проверки компиляции, структуры и внешнего вида; прямо указывает, что успешная сборка не гарантирует нужное поведение или внешний вид.
- [Справочник команд Rive CLI](https://rive.app/docs/cli/reference/commands) — Основной источник точных команд, флагов, кодов завершения, удалённых операций отправки и получения, входа в учётную запись, подписи, экспорта .rev и требований к чистому .riv.
- [Примеры Rive CLI](https://rive.app/docs/cli/examples) — Показывают снимки экрана без окна, продвижение анимации, размер окна, данные и указатель мыши, тесты Luau и отчёты JSON; примеры приведены в документации, BIG CHANGE их не запускал.
- [ИИ-агент Rive](https://rive.app/docs/editor/ai-agent) — Описывает отдельного встроенного агента редактора Rive и связанные с ним тариф и кредиты ИИ.
- [Загрузки Rive](https://rive.app/downloads) — На актуальной странице CLI указан как продукт раннего доступа.
- [Тарифы Rive](https://rive.app/pricing) — Перечисляют актуальные условия тарифов для учётной записи и встроенного агента редактора; они рассматриваются отдельно от датированного заявления о цене предварительной версии CLI.
- [Объявление «Представляем Rive CLI и RML»](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Сотрудники Rive называют выпуск технической предварительной версией и сообщают, что на время этого периода CLI бесплатен без ограничений. В объявлении также объясняются роли .riv, .rev и RML и дана ссылка на видеоруководство.
- [Видеоруководство по Rive CLI](https://youtu.be/Y3E33otHeLE) — Видео предоставлено владельцем задания и упоминается в тексте и источниках; конкретные сцены или результаты в нём не приписываются.