Устранение неполадок

Ищите проблемы по симптомам. Каждый раздел содержит симптом / вероятные причины / диагностику / способ исправления. Если вашей ситуации нет в списке, создайте issue на GitHub или обратитесь в поддержку.

Демон не может подключиться к серверу

Симптом: команда aacworkflow daemon status показывает offline или connection refused; в AACWorkflow Cloud не видно недавней активности этой среды выполнения. О механике демона см. Демон и среды выполнения.

Вероятные причины:

1. AACWORKFLOW_SERVER_URL указывает на неправильный адрес — переменная должна быть не задана, либо совпадать со значением по умолчанию wss://api.aacworkflow.com/ws
2. Сеть / фаервол блокирует — исходящий WebSocket-трафик с вашей машины заблокирован
3. Срок действия токена истёк или он недействителен — вы не запускали aacworkflow login, или PAT был отозван
4. Вы не состоите в целевом рабочем пространстве — учётная запись, с которой вы вошли, не находится в рабочем пространстве, куда вы пытаетесь зарегистрировать демон (регистрация возвращает 403)
5. Ошибка разрешения DNS — api.aacworkflow.com не разрешается на машине демона

Диагностика:

aacworkflow daemon logs --lines 100    # поиск ошибок на стороне демона
echo $AACWORKFLOW_SERVER_URL          # проверка адреса, если вы его задавали
cat ~/.aacworkflow/config.json        # проверка существования api_token
aacworkflow workspace list            # подтверждение членства в целевом пространстве

Исправление: устраните каждую из указанных причин. Два самых частых исправления: сбросить кастомный AACWORKFLOW_SERVER_URL и перезапустить демон (aacworkflow daemon restart), а также войти заново (aacworkflow logout && aacworkflow login).

Задачи застряли в статусе queued

Симптом: после назначения задачи агенту статус задачи сразу меняется на in_progress, но проходит много времени без признаков выполнения агентом на странице; aacworkflow daemon status показывает демон online.

Вероятные причины (в порядке частоты):

1. Достигнут лимит одновременных задач агента — max_concurrent_tasks этого агента (по умолчанию 6) полностью занят другими выполняющимися задачами
2. Другая задача того же агента ещё выполняется над той же задачей — один агент × одна задача выполняется последовательно (предотвращает дублирование)
3. Агент архивирован — после архивации новые задачи всё ещё ставятся в очередь, но не могут быть взяты и истекают через 5 минут
4. Демон не зарегистрировал эту среду выполнения в текущем рабочем пространстве — перезапустите демон или выберите среду выполнения заново в интерфейсе
5. Демон отключился — нет heartbeat за последние 45 секунд. daemon status, показывающий online, может отражать очень недавнее отключение

Диагностика:

aacworkflow daemon status --output json       # список сред выполнения + last_seen_at
aacworkflow agent list                         # проверка статуса архивации агента
aacworkflow issue show <id-задачи>             # просмотр истории задач

Исправление:

• Причина 1: подождите завершения выполняющихся задач или настройте max_concurrent_tasks в конфигурации агента
• Причина 2: дождитесь завершения существующей задачи — следующая запустится автоматически
• Причина 3: разархивируйте агента в Настройки → Агенты
• Причина 4: перезапустите демон (aacworkflow daemon restart), затем проверьте среду выполнения в Настройки → Среды выполнения
• Причина 5: проверьте логи демона (aacworkflow daemon logs --lines 50) — если проблема в сети, см. раздел «Демон не может подключиться к серверу» выше

Ошибка «недостаточно средств» при попытке назначить задачу

Симптом: при попытке назначить задачу агенту интерфейс показывает ошибку «недостаточно средств» («insufficient funds») или «баланс слишком низок для запуска задачи».

Вероятные причины:

1. На вашем биллинг-кошельке закончились кредиты — баланс равен нулю или недостаточен для минимальной стоимости задачи
2. Подписка просрочена или отменена — если вы использовали бесплатные кредиты и они закончились

Диагностика: перейдите в Настройки → Биллинг, чтобы увидеть текущий баланс и историю транзакций.

Исправление:

• Пополните кошелёк через Настройки → Биллинг → Пополнить
• Перейдите на более высокий тарифный план, чтобы получить больше кредитов
• Дождитесь ежемесячного сброса кредитов (если вы на подписке)

Нет доступных сред выполнения

Симптом: при создании агента или попытке запустить задачу, интерфейс показывает сообщение «нет доступных сред выполнения» («no runtimes available»).

Вероятные причины:

1. Демон не запущен — AI-инструменты не зарегистрированы
2. Демон запущен, но AI-инструменты не обнаружены — ни один из 16 поддерживаемых инструментов не найден в PATH
3. Среда выполнения зарегистрирована в другом рабочем пространстве — демон подключается не к тому рабочему пространству

Диагностика:

aacworkflow daemon status
aacworkflow daemon logs --lines 50
which claude codex  # проверьте, установлены ли AI-инструменты

Исправление:

• Запустите демон: aacworkflow daemon start
• Установите хотя бы один AI-инструмент (Claude Code, Codex и т.д.)
• Перезапустите демон после установки: aacworkflow daemon restart

WebSocket не подключается

Симптом: задачи выполняются, но на странице задачи прогресс не обновляется в реальном времени; комментарии от агентов появляются только после обновления страницы.

Вероятные причины:

1. Корпоративный прокси или фаервол блокирует WebSocket-апгрейд — некоторые сети пропускают обычный HTTPS, но обрезают заголовок Upgrade
2. Истёк срок действия JWT-cookie — не было повторного входа после истечения 30-дневного срока
3. Вмешательство браузерного расширения — некоторые расширения для приватности/блокировки рекламы выборочно блокируют соединения wss://

Диагностика: проверьте консоль браузера (F12 → Network → фильтр «WS») на статус соединения и код ответа; попробуйте другую сеть (например, мобильный интернет), чтобы исключить корпоративный прокси.

Исправление:

• Истёк cookie → обновите страницу и войдите заново
• Блокировка прокси/фаерволом → попробуйте другую сеть или попросите сетевого администратора разрешить wss://api.aacworkflow.com
• Не помогло → обратитесь в поддержку со скриншотом вкладки Network из DevTools

Не приходит письмо с кодом

Симптом: пользователи не получают код верификации при входе — ни во «Входящих», ни в спаме.

Вероятные причины:

1. Задержка доставки — иногда занимает до минуты
2. Папка «Спам» / «Промоакции» — письма с кодом иногда туда попадают
3. Корпоративная фильтрация почты — некоторые почтовые шлюзы компаний помещают автоматические письма в карантин
4. Опечатка в адресе — проверьте, что ввели именно на странице входа

Исправление:

• Подождите минуту, затем проверьте папки «Спам» / «Промоакции»
• Нажмите Отправить код повторно на странице входа
• Если ваша организация фильтрует входящую почту, попросите IT-отдел добавить noreply@aacworkflow.com в список разрешённых
• Если письмо так и не пришло через несколько минут — обратитесь в поддержку

Конфликты портов (демон)

Симптом: aacworkflow daemon start завершается с ошибкой address already in use.

Вероятные причины:

1. Порт здоровья демона занят (по умолчанию 19514, смещение по хешу для каждого профиля)
2. Другой профиль демона уже привязан к тому же порту

Диагностика:

lsof -i :19514        # macOS / Linux
netstat -ano | findstr :19514    # Windows

Исправление: завершите конфликтующий процесс, либо запускайте дополнительные демоны в отдельных профилях (aacworkflow daemon start --profile <name>) — для каждого профиля порт здоровья выбирается автоматически.

Где найти логи

В фоновом режиме daemon.log ротируется по размеру (по умолчанию 20 МБ × 5 gzip-резервных копий; настраивается через AACWORKFLOW_DAEMON_LOG_MAX_SIZE_MB / _MAX_BACKUPS / _MAX_AGE_DAYS), поэтому файл не разрастается до неоткрываемого размера.

Для более подробных логов демона переключите его из фонового режима в режим переднего плана: aacworkflow daemon stop && aacworkflow daemon start --foreground.