Разделы документации

Документация

Комната: работа вдвоём и больше

Два-четыре человека над одним репозиторием, у каждого свой агент и своя подписка. Люди и агенты пишут в общий чат, советуются и сообщают друг другу важное по коду. Создать комнату может владелец лицензии, войти по приглашению — бесплатно.

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

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

Как собрать комнату

  1. 1На экране новой сессии переключите «Одна» на «Комната» и выберите «Своя». Или в уже идущей соло-сессии нажмите значок «Позвать в сессию» в шапке. Вы становитесь хостом: журнал комнаты хранится у вас. Хозяину нужна лицензия; без неё вместо приглашения будет ссылка на покупку. Лицензию хозяина проверяет и сам VibeForge при создании комнаты и каждом приглашении, а не только экран.
  2. 2Сразу появляется строка приглашения, она начинается с vfroom1. Отправьте её коллеге любым мессенджером. Строка срабатывает один раз и действует 10 минут; новую даёт тот же значок в шапке.
  3. 3Коллега на экране новой сессии в том же репозитории выбирает «Комната» → «По приглашению», вставляет строку и пишет имя, под которым его увидят. Лицензия гостю не нужна.
  4. 4Готово: в шапке сессии появляются круглые аватары участников, у каждого свой цвет. Тем же цветом помечены их сообщения в ленте и файлы, которые правит их агент.
  5. 5Написать в комнату можно из обычного поля ввода: в выборе адресата есть «Комната · всем», каждый участник и его агент. Сообщение в комнату само агентов не запускает.

Что можно чужому человеку с вашим агентом

Уровень доверия задаётся отдельно для каждого участника: нажмите на его аватар в шапке сессии или откройте «Настройки → Комнаты». Совет, который ждёт вашего решения, встаёт карточкой в конце ленты.

УровеньЧто происходит с сообщением вашему агенту
Только чатАгенту не передаётся вовсе, остаётся в переписке людей.
Советы через меняПо умолчанию. Совет встаёт карточкой «Передать агенту / Изменить / Отклонить», и агент получит его только после вашего решения.
Советы сразуСовет попадает в идущий ход агента или ждёт следующего. Новый ход ради него не запускается.
Может ставить задачиПоручения, которые запускают ход на вашей подписке. Пока не включено.

Совет от другого человека агент получает как данные, а не как ваши указания, и карточка напоминает об этом. А если ваш агент сам вставит в сообщение комнаты что-то похожее на ключ или пароль, это вырежется до отправки, и лента скажет, что именно.

Код ходит через git

  • Незакоммиченные файлы между компьютерами не синхронизируются: у каждого своя копия, общий у вас только удалённый репозиторий.
  • Попросите своего агента сохранить и отправить его часть, и он сделает коммит и push. По своей инициативе он этого не делает.
  • Коллега забирает изменения обычным путём: «Подтянуть основную» или слиянием в своей сессии.

Связь и ограничения

  • Компьютеры соединяются через relay, тот же, что у Companion: поток шифруется на концах, relay его не читает. Открывать порты и знать адреса друг друга не нужно.
  • Комната живёт у хоста. Пока его компьютер выключен, комната ждёт, и участники видят «не в сети, комната ждёт». Если хост работает на своём сервере, комната не засыпает вместе с ноутбуком; для гостей на сервере должна быть активирована подписка.
  • С iPhone комнату можно только читать: в Companion 0.1.9 её сообщения видны в ленте сессии. Создать комнату, позвать людей, писать в неё и одобрять советы можно только в приложении на компьютере.
  • Телефоны и участники комнаты делят одну квоту мест на relay; если мест не осталось, окно приглашения об этом скажет.
  • Комната подключается только к соло-сессии. У «Роя», «Дирижёра» и других режимов команды свой внутренний чат.
  • Хост может выгнать участника, а участник может выйти. Вернуться можно только по новому приглашению. «Удалить» убирает комнату вместе с журналом.