sanspie
f22242e5aa
ci / release (push) Successful in 5m5s
ci-platforms / build (amd64, windows, windows-2022) (push) Skipped
ci-platforms / build (arm64, darwin, macos-15) (push) Skipped
ci-platforms / build (amd64, darwin, macos-15-intel) (push) Skipped
ci / checks (push) Successful in 4m41s
ci / build (amd64, linux, ubuntu-24.04) (push) Successful in 7m14s
The remaining editor strings and undo step names; component, field, enum, setting, diagnostic and Script API texts under schema.*, enum.*, setting.*, diag.* and api.*; the launcher, the in-game Settings View with a Language setting, the CLI and aego schema show --lang. Every documentation page has a .ru.md translation; the site has a full Russian tree with hreflang, a language switch and ru/llms.txt; aego docs check --lang ru. New doc.tutorial and doc.recipe icons. Fix: an animator restored by a rewind prepares its controller before the replayed step.
31 lines
3.0 KiB
Markdown
31 lines
3.0 KiB
Markdown
---
|
||
id: tools
|
||
title: Командная строка и агенты
|
||
---
|
||
|
||
# Командная строка и агенты
|
||
|
||
Всё, что редактор делает с проектом, доступно и через команду `aego`. Поэтому проверки, тесты, сборки и документация работают одинаково на ноутбуке, в CI и для ИИ-агента, который работает над проектом.
|
||
|
||
## Повседневные команды
|
||
|
||
| Команда | Что делает |
|
||
|---|---|
|
||
| `aego new <dir> --template 2d` | создаёт проект из шаблона и проверяет его |
|
||
| `aego edit [path]` | открывает проект по пути, редактор на файле сцены или префаба или лаунчер, если проект не найден; `--launcher new` открывает лаунчер |
|
||
| `aego run [dir]` | запускает главную сцену и перезагружает ассеты и скрипты при сохранении |
|
||
| `aego check [dir]` | компилирует каждый пакет скриптов и проверяет проект; при ошибках в скриптах код выхода 1, при сломанном нативном коде — 2 |
|
||
| `aego test [dir]` | запускает тесты скриптов `*_test.aes`; `--determinism` запускает главную сцену дважды и сравнивает хеши состояния |
|
||
| `aego export [dir]` | собирает игру для распространения под целевую платформу |
|
||
| `aego docs serve` | раздаёт эту документацию вместе с задокументированными скриптами вашего проекта на localhost |
|
||
|
||
## В CI
|
||
|
||
`aego check` и `aego test` завершаются с ненулевым кодом при любой ошибке. Они выводят каждую диагностику с файлом, строкой и кодом. Им не нужны ни окно, ни GPU. Типичный конвейер запускает обе команды при каждом push, а перед релизом — `aego export --check`.
|
||
|
||
## Для агентов
|
||
|
||
- `aego docs export --out docs.json` записывает весь реестр документации в JSON: руководства, каждую функцию скриптов, компонент, поле и диагностику, а также doc-комментарии ваших собственных скриптов. Дайте агенту этот файл вместо сайта.
|
||
- Сайт публикует `llms.txt` — простой список всех страниц с их группой и кратким описанием.
|
||
- У диагностик стабильные коды, например `AES2050`. Справочник диагностик объясняет каждую и как её исправить.
|