# Запись воркспейса

> Запишите всё, что показывает воркспейс, — каждый терминал, холст, браузер и другие карточки — и воспроизведите потом на шкале времени, без единого нового запроса к модели.

Source: https://docs.neurosquad.ai/ru/canvas/recording

**Запись** сохраняет всё, что показывает один воркспейс, пока он работает: каждый байт, который вывел
каждый терминал, холст с карточками, рамками и стрелками, заметки и списки дел, то, что показывали
карточки браузера, и снимки остальных карточек. Потом запись можно **воспроизвести** в NeuroSquad на
шкале времени — терминалы ровно такими, какими они были, с любой скоростью, без запущенных агентов и
без запросов к модели.

Пригодится, чтобы показать коллеге, как прошёл прогон, сравнить агентов на одной задаче задним
числом, снять демо экранным рекордером в своём темпе или приложить происходившее к отчёту об ошибке.

Нужен NeuroSquad 0.1.264 или новее.

## Запись

**1. Откройте воркспейс, который хотите записать**

Записывается один воркспейс за раз.

**2. Инструменты холста → Начать запись**

Меню инструментов холста — кнопка с ползунками в правом верхнем углу холста. В строке заголовка
появится красный чип **Запись** с прошедшим временем; он остаётся там, пока идёт запись.

**3. Работайте как обычно**

Запись никак не меняет поведение агентов и карточек.

**4. Остановите**

Нажмите красный чип или **Инструменты холста → Остановить запись**. Выход из NeuroSquad тоже
останавливает запись.

Терминал, который уже работал в момент старта, начинается с текущего экрана и последних нескольких
сотен строк прокрутки, а не со всей истории. Чтобы записать прогон с самой первой строки, начните
запись до того, как дадите агентам промпты.

## Воспроизведение

**Инструменты холста → Записи…** показывает ваши записи, новые сверху: воркспейс, дата, длительность,
размер, число карточек и состояние (**Завершена** или **Восстановлена** — для оборванной).
**Воспроизвести** открывает запись; кнопка с корзиной удаляет её сразу, без вопроса.

Плеер занимает всё окно и показывает копию холста только для просмотра — та же раскладка, рамки и
стрелки, тот же масштаб и положение, что были в вашем окне:

- **Терминалы** воспроизводятся байт в байт — с цветами, курсором и изменениями размера.
- **Карточки браузера** показывают страницу такой, какой карточка показывала её в тот момент.
- **Заметки и списки дел** — с текстом того момента.
- **Остальные карточки** (Run Stats, Agent Pulse, карточки сообщества и другие) — снимком карточки,
который делался примерно раз в секунду, пока она была на экране.

| Управление | Что делает |
| --- | --- |
| **Пуск** / **Пауза**, `Space` | Запустить и остановить воспроизведение |
| **Скорость** | 1×, 2×, 4×, 8×, 16×, 32× или 64× |
| Шкала времени | Перетащите или щёлкните, чтобы перейти. Отметки — отправленные промпты, завершения, «ждёт вашего ответа» и метки, поставленные скриптами |
| **Предыдущая метка** / **Следующая метка** | Переход между этими отметками |
| `←` / `→` | Назад или вперёд на 5 секунд |
| **Чистый вид** | Прячет всё управление и показывает холст ровно в размере вашего живого холста — для экранного рекордера. `Esc` возвращает управление |
| `Esc` | Закрывает плеер |

В плеере ничего не происходит по-настоящему: агенты не запускаются, в терминалы ничего не вводится, к
модели ничего не уходит.

## Что не записывается

- Наведение мыши, выделение, прокрутка внутри карточки, меню, подсказки, всплывающие уведомления и
указатель мыши.
- Страницы браузера и снимки карточек — только пока карточка была на экране и холст не был уменьшен
до обзора: ровно то, что вы видели. Снимки — примерно раз в секунду.
- Масштаб и положение холста сохраняются раз в секунду. [Режим сетки](https://docs.neurosquad.ai/ru/canvas/grid-mode)
воспроизводится как холст.
- У карточек в плеере общая шапка карточки, без всех кнопок живой.

## Где хранятся записи

В папке `recordings` внутри [папки данных NeuroSquad](https://docs.neurosquad.ai/ru/help/data): своя папка на каждый воркспейс и
каждую запись. Чтобы хранить их в другом месте — например, на диске побольше, — задайте переменную
окружения `NEUROSQUAD_RECORDINGS_DIR` с путём к папке до запуска NeuroSquad. Если скрипт начинает
запись в свою папку, NeuroSquad и дальше пишет следующие записи туда.

Запись с активными терминалами и карточками браузера растёт быстро. Когда запись превышает 5 ГБ или
на диске остаётся меньше 2 ГБ, NeuroSquad перестаёт сохранять кадры браузера и снимки карточек;
терминалы записываются дальше.

Запись пишется по ходу дела и сбрасывается на диск каждые несколько секунд, поэтому сбой или
отключение питания теряют разве что последние мгновения: при следующем открытии **Записи…**
оборванная запись помечена **Восстановлена** и воспроизводится до места, где остановилась.

## Приватность

> Запись содержит всё, что показывал воркспейс, **и каждую клавишу, нажатую в его терминалах, —
> включая пароли, набранные в оболочке**. Обращайтесь с файлом записи так же, как с экраном, с
> которого она снята.

- Записи остаются на вашем компьютере. NeuroSquad никогда их не загружает.
- Ключи, которые вы вводите в собственных диалогах NeuroSquad (ключи провайдеров, пароли SSH), — не
ввод в терминал и не записываются.
- Пока идёт запись, красный чип всегда на виду; наведите на него, чтобы вспомнить, что сохраняется.
- Начать или остановить запись с телефона нельзя.
- Удалить запись можно в **Записи…** или удалив её папку.
