Документация
Комната: работа вдвоём и больше
Два-четыре человека над одним репозиторием, у каждого свой агент и своя подписка. Люди и агенты пишут в общий чат, советуются и сообщают друг другу важное по коду. Создать комнату может владелец лицензии, войти по приглашению — бесплатно.
«Комната» связывает вашу соло-сессию с сессиями других людей. У каждого свой компьютер, свой агент, своя подписка и своя копия кода. Общий у них только чат: в него пишут люди и их агенты, советуются, предупреждают о том, что поменялось в коде, и договариваются, кто что делает.
Подписки не соединяются, и чужой агент не работает за ваш счёт. Другие участники видят сообщения комнаты, кто в сети и имена файлов, которые правит ваш агент, — так видно, где ваши правки могут пересечься. Содержимое файлов, ваша лента и терминал им не видны, а вашему агенту их сообщения попадают только с вашего согласия.
Как собрать комнату
- 1На экране новой сессии переключите «Одна» на «Комната» и выберите «Своя». Или в уже идущей соло-сессии нажмите значок «Позвать в сессию» в шапке. Вы становитесь хостом: журнал комнаты хранится у вас. Хозяину нужна лицензия; без неё вместо приглашения будет ссылка на покупку. Лицензию хозяина проверяет и сам VibeForge при создании комнаты и каждом приглашении, а не только экран.
- 2Сразу появляется строка приглашения, она начинается с
vfroom1. Отправьте её коллеге любым мессенджером. Строка срабатывает один раз и действует 10 минут; новую даёт тот же значок в шапке. - 3Коллега на экране новой сессии в том же репозитории выбирает «Комната» → «По приглашению», вставляет строку и пишет имя, под которым его увидят. Лицензия гостю не нужна.
- 4Готово: в шапке сессии появляются круглые аватары участников, у каждого свой цвет. Тем же цветом помечены их сообщения в ленте и файлы, которые правит их агент.
- 5Написать в комнату можно из обычного поля ввода: в выборе адресата есть «Комната · всем», каждый участник и его агент. Сообщение в комнату само агентов не запускает.
Что можно чужому человеку с вашим агентом
Уровень доверия задаётся отдельно для каждого участника: нажмите на его аватар в шапке сессии или откройте «Настройки → Комнаты». Совет, который ждёт вашего решения, встаёт карточкой в конце ленты.
| Уровень | Что происходит с сообщением вашему агенту |
|---|---|
| Только чат | Агенту не передаётся вовсе, остаётся в переписке людей. |
| Советы через меня | По умолчанию. Совет встаёт карточкой «Передать агенту / Изменить / Отклонить», и агент получит его только после вашего решения. |
| Советы сразу | Совет попадает в идущий ход агента или ждёт следующего. Новый ход ради него не запускается. |
| Может ставить задачи | Поручения, которые запускают ход на вашей подписке. Пока не включено. |
Совет от другого человека агент получает как данные, а не как ваши указания, и карточка напоминает об этом. А если ваш агент сам вставит в сообщение комнаты что-то похожее на ключ или пароль, это вырежется до отправки, и лента скажет, что именно.
Код ходит через git
- Незакоммиченные файлы между компьютерами не синхронизируются: у каждого своя копия, общий у вас только удалённый репозиторий.
- Попросите своего агента сохранить и отправить его часть, и он сделает коммит и push. По своей инициативе он этого не делает.
- Коллега забирает изменения обычным путём: «Подтянуть основную» или слиянием в своей сессии.
Связь и ограничения
- Компьютеры соединяются через relay, тот же, что у Companion: поток шифруется на концах, relay его не читает. Открывать порты и знать адреса друг друга не нужно.
- Комната живёт у хоста. Пока его компьютер выключен, комната ждёт, и участники видят «не в сети, комната ждёт». Если хост работает на своём сервере, комната не засыпает вместе с ноутбуком; для гостей на сервере должна быть активирована подписка.
- С iPhone комнату можно только читать: в Companion 0.1.9 её сообщения видны в ленте сессии. Создать комнату, позвать людей, писать в неё и одобрять советы можно только в приложении на компьютере.
- Телефоны и участники комнаты делят одну квоту мест на relay; если мест не осталось, окно приглашения об этом скажет.
- Комната подключается только к соло-сессии. У «Роя», «Дирижёра» и других режимов команды свой внутренний чат.
- Хост может выгнать участника, а участник может выйти. Вернуться можно только по новому приглашению. «Удалить» убирает комнату вместе с журналом.