Открытая сессия разработки: шапка и метрики, полоса хода с цветными метками, лента сообщений и действий, служебные вызовы, «Следить», раскладка на телефоне.

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

Лента слева, инспектор справа; полоса хода над ними ведёт к любому шагу сессии.

Шапка и метрики

Сверху — кнопка назад «Сессии разработки», название сессии (первая строка первого сообщения разработчика) и строка: логин · устройство · проект · день начала. Если последний ход был меньше пяти минут назад, рядом — зелёная отметка «Идёт».

Кнопки шапки:

Кнопка	Что делает
Спросить	задать модели вопрос по этой сессии — Спросить по сессиям
Следить	держать выбранным последний шаг и показывать новые ходы по мере их появления — см. ниже
Markdown, JSON	выгрузить сессию файлом — Выгрузка

Под кнопками — строка метрик всей сессии: число ходов; токены — сумма и разбивка вход · выход · рассуждение · кэш (наведите на число: кэш-чтение и кэш-запись покажутся отдельно); время работы модели; списано в рублях.

Владелец, открывший сессию другого разработчика, видит под метриками предупреждение «Чужая сессия»: «Вы смотрите сессию разработчика … Просмотр и выгрузка записываются в журнал аудита организации». Подробнее — Журнал аудита и Buff Code.

Полоса хода

Под шапкой — полоса с меткой на каждый шаг: сообщение разработчика или одно действие модели, слева направо по времени. Крайние подписи под полосой — время первого и последнего шага.

Полоса хода (обведена): метка на каждое действие и сообщение, цвет — по виду действия, ошибка красным; под полосой — «шаг i из N» и легенда.

Цвет метки — вид действия. Легенда под полосой: разработчик · терминал · чтение файла · правка файла · код · знания · ошибка. Действие, которое закончилось ошибкой — команда с ненулевым кодом выхода, отказ инструмента, — красное, каким бы оно ни было. У остальных видов (поиск, справочник, вопрос разработчику, интернет, подзадача) свои цвета; наведите на метку — подсказка покажет время и вид.

Как ходить по полосе:

клик по метке выбирает шаг: инспектор показывает это действие, лента прокручивается к его строке. Метки сообщений разработчика не нажимаются — сообщение и так видно в ленте;
стрелки ← и → на клавиатуре (полоса в фокусе) ведут к соседнему действию;
кнопка «К последнему шагу» справа от полосы — в конец сессии;
подпись «шаг 12 из 40 · 14:07» под полосой — где вы сейчас и во сколько это было.

Найти ошибку или правку за десять секунд. Красная метка на полосе — это ошибка: клик по ней открывает в инспекторе команду и её вывод с кодом выхода. Зелёные метки — правки файлов: клик показывает диф. Если правок много, быстрее вкладка «Файлы» инспектора: все файлы сессии с числом изменений, клик ведёт к последней правке файла.

Лента

Лента — история сессии в порядке, как она шла. В её шапке — число сообщений и флажок «Служебные вызовы (N)» (см. ниже).

Сообщение разработчика — пузырь справа с подписью «логин · hh:mm». Длинный текст (больше двенадцати строк или около тысячи знаков) свёрнут; «Показать полностью» раскрывает, «Свернуть» — обратно.
Ответ модели — подпись «Buff Code · hh:mm», под ней:
- «Рассуждение модели» — раскрывающийся блок, если модель рассуждала перед ответом;
- текст ответа — как Markdown, с кодом и списками;
- «Ошибка модели» — красная плашка с текстом отказа, если ход не удался;
- блок «N действий» — по строке на каждое действие: значок вида, глагол и объект — «Запустил · make test», «Изменил · src/api.py», — у правок +N −N добавленных и удалённых строк, у команды с ненулевым кодом выхода — красная метка «код N», у отказавшего инструмента — «ошибка», у действия без ответа — спиннер «ждёт ответа». Если в блоке есть хоть одна ошибка, в его шапке — метка «есть ошибка»;
- строка хода: модель · время · токены · ₽.
«Ответ инструмента на вызов, которого нет в записи» — результат, чей вызов в запись не попал (обрыв потока); показывается как есть.

Клик по строке действия выбирает его в инспекторе. На широком экране инспектор виден всегда: пока вы ничего не выбрали, в нём последний шаг сессии.

Лента и инспектор рядом: в ленте — ответ модели и блок «N действий» со строками «глагол · объект», справа — выбранное действие целиком.

Служебные вызовы

Кроме работы разработчика и модели в записи есть служебные сообщения: сжатие длинного разговора и то, что Buff Code вставляет сам, — напоминание модели о режиме «План», очередной ход цели. Они записываются, как остальные, но в ленте и на полосе хода по умолчанию скрыты, чтобы не мешать читать работу. Флажок «Служебные вызовы (N)» в шапке ленты показывает их: каждое помечено «служебный вызов» и подписано «Buff Code» — разработчик его не писал. Число N — сколько таких ходов было. В выгрузку они входят всегда.

Флажок включён (обведён): в ленте появилось напоминание о режиме «План», которое Buff Code вставил сам. Имя разработчика и устройства на кадре размыты.

«Следить» и «Идёт»

«Идёт» в шапке — у сессии, где последний ход был меньше пяти минут назад: разработчик, скорее всего, ещё работает.

«Следить» — режим, а не подгрузка. Пока он включён, выбранным остаётся последний шаг, лента держится прокрученной к концу, а новые ходы приходят сами: сервер сообщает по push, что в сессии появился ход, и хвост ленты дописывается без перезагрузки. У идущей сессии режим включён с самого начала — кнопка подсвечена. Как только вы выбираете более ранний шаг, слежение выключается; кнопка включает его обратно. Включить «Следить» можно и у давно законченной сессии — тогда оно просто держит последний шаг.

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

«Показать продолжение»

Длинная сессия приходит страницами. Когда лента заканчивается раньше сессии, внизу — кнопка «Показать продолжение»; она дописывает следующую страницу. Полоса хода и вкладка «Файлы» считают только загруженную часть; выгрузка и вопросы по сессии берут её целиком.

На телефоне

На узком экране лента занимает всё место, полоса хода показывается без легенды. Инспектор открывается нижней шторкой по нажатию на строку действия или метку полосы; кнопка «Закрыть» или касание вне шторки прячут его. Вкладки «Действие» и «Файлы» в шторке те же.