y83 code / справочник

Агенты

Агент — это запущенный сервер opencode serve, с которым разговаривает приложение: он держит проекты, сессии и делает всю работу. Главный экран приложения показывает, какие агенты есть и в каком они состоянии, и оттуда же начинается путь к чату: тап по агенту открывает его проекты.

раздел
Чат opencode
пунктов возможностей
6
источник
docs/opencode/agents.md

Что на главном экране

Сверху вниз:

  • Быстрый доступ — плитки инструментов, которые вы выбрали для главного экрана (настраиваются на экране Home settings).
  • Агенты на телефоне — карточки сервисов, которые живут на самом телефоне. Карточка показывает имя, состояние процесса и его номер, а кнопка справа запускает или останавливает сервис. Пока идёт запуск или остановка, вместо кнопки виден спиннер, а состояние подписано словом.
  • Удалённые агенты — серверы, к которым приложение ходит по SSH-туннелю. Карточка показывает имя, адрес пользователь@хост:порт и состояние туннеля, а кнопка справа поднимает или опускает туннель. Тап по карточке открывает агента, при необходимости сначала подняв туннель.

Тумблеров «включить агента» в списке нет: агент — это процесс, поэтому у него кнопка запуска и остановки, а не переключатель.

Состояние связи

Связь с агентом в чате показана тремя состояниями: online — всё в порядке, reconnecting… — соединение оборвалось и приложение восстанавливает его само, offline — связи нет.

  • Строка состояния висит в шапке чата только при обрыве. Постоянное «online» было бы шумом, а при обрыве полоса этапов хода не рисуется вовсе: утверждать, что агент работает, когда связи нет, нельзя.
  • Переподключение идёт само, с нарастающей паузой между попытками; пока связи нет, новые сообщения отправить нельзя, а то, что уже стоит в очереди, остаётся в очереди.
  • Обрыв не съедает ход. История и карточки остаются в ленте, а после восстановления связи приложение сверяется с сервером.

Технические данные

ПараметрЗначение
Состояния связиonline, reconnecting…, offline
Где видно состояниешапка чата, только когда связь не в порядке
Виды агентов в спискесервисы на телефоне и удалённые агенты по SSH-туннелю
Состояния туннеля удалённого агентаCONNECTED, RECONNECTING, CONNECTING…, DISCONNECTING…, ERROR, OFFLINE
Что показывает карточка сервисаимя, состояние, номер процесса; кнопка запуска или остановки
Пауза между попытками переподключениярастёт с каждой неудачной попыткой

Источник: docs/opencode/agents.md. Страница собрана из документации проекта при сборке сайта — без пересказа.