Orca Guide
Справочник

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

Решение распространённых проблем с агентами, worktree, GitHub, CLI и браузером.

Агент не запускается

  • Запустите CLI агента вручную в терминале. Если он не работает там, проблема связана с установкой или авторизацией, а не с Orca.
  • Убедитесь, что CLI находится в доступном Orca PATH, и проверьте Настройки → Агенты.
  • Нажмите Перезапустить на вкладке.

Diff не обновляется или выглядит неправильно

  • Нажмите кнопку обновления на панели diff.
  • Если rebase, reset или другая операция Git выполнялась вне Orca, обновите diff после её завершения.

Не создаётся worktree

  • Исходная ссылка могла быть не загружена. Выполните git fetch origin.
  • Для ветки уже может существовать worktree. Удалите его или выберите другое название ветки.

Orca CLI сообщает command not found

Зарегистрируйте CLI в разделе Настройки → Экспериментальные функции → CLI. В macOS Orca устанавливает прокладку в ~/.local/bin; этот каталог должен входить в PATH.

Браузер сообщает browser_no_tab

В текущем worktree нет вкладки браузера. Выполните orca tab create --url ... или откройте панель браузера вручную.

Производительность и память

  • Закрывайте неиспользуемые worktree: каждый поддерживает наблюдатели файлов.
  • Больше всего памяти занимают разделённые панели с множеством вкладок браузера.

Ошибки GitHub

Лимиты, авторизация gh, недостающие разрешения и доступ к репозиторию влияют на управление версиями и проверки pull request. Полная таблица приведена в статье Ошибки GitHub.

gh auth status -h github.com
gh api user
gh api rate_limit --jq '.resources.core'

Журналы

Команда Справка → Открыть журналы показывает каталог журналов Orca. Прикладывайте их к отчёту об ошибке.

Сообщить о проблеме

  • GitHub Issues: ошибки и предложения.
  • Discord: помощь в реальном времени.

Частые вопросы

Что проверить, если агент не запускается?

Убедитесь, что команда установлена, доступна в PATH Orca и успешно работает в обычном терминале под тем же пользователем.

Почему worktree не создаётся?

Проверьте состояние Git, доступ к репозиторию, допустимость имени ветки и наличие свободного места.

Что делать, если встроенный браузер не открывает локальный сайт?

Проверьте, запущен ли сервер разработки, какой порт он слушает и доступен ли адрес из текущего окружения.

Как диагностировать ошибку Orca CLI?

Сначала выполните команду статуса, затем повторите действие с подробным выводом и сохраните безопасный текст ошибки.

Какие данные приложить к обращению?

Нужны версия Orca, система, шаги воспроизведения и сообщение об ошибке без секретов, токенов и закрытого кода.

On this page