GitBorGitBor

Решение проблем

Частые проблемы и как их исправить

Когда что-то идёт не так, первое место для проверки — Git Activity Log, журнал git-команд, которые запускал GitBor. Обычно его одного достаточно, чтобы понять причину.

Git Activity Log

Индикатор в тулбаре показывает, сколько git-операций сейчас в работе. Клик по нему открывает журнал текущего репозитория. Каждая запись содержит:

  • Сырую команду (например, git log --oneline …) — с кнопкой Copy command.
  • stdout и stderr (длинный вывод обрезается с пометкой).
  • Код выхода, статус (success / warning / error) и длительность в миллисекундах.
  • Рабочую папку, в которой команда выполнялась.

Кнопка Clear history сбрасывает список.

Частые проблемы

Предупреждение о рискованном корне

Если открыть домашнюю папку, корень диска, C:\Windows, Program Files или node_modules, репозиторий откроется, но автоматическое обновление по изменениям файлов будет отключено. Обновляйте вручную через F5. Это намеренно — слежение за такими папками залило бы ОС событиями и подвесило интерфейс.

Граф коммитов долго строится

Большие репозитории (десятки тысяч коммитов) строят граф несколько секунд при первом открытии; последующие переключения на эту вкладку мгновенны, так как граф кэширован. Если ждёте слишком долго, проверьте Git Activity Log — не идёт ли параллельно долгий fetch.

Устаревший .git/index.lock

Если GitBor (или другой клиент) упал посреди операции, в .git/ может остаться index.lock. GitBor помечает его устаревшим и игнорирует, а не удаляет автоматически — удаление могло бы сломать другой работающий git-процесс. Если он реально мешает, preflight-диалог предложит Remove index.lock и покажет запущенные git-процессы, либо удалите вручную:

rm .git/index.lock

AI-ключ сохранён без шифрования

При сохранении AI-ключа GitBor шифрует его через системное хранилище (Windows DPAPI, macOS Keychain, Linux libsecret). Если хранилище недоступно (часто headless Linux без libsecret), ключ всё равно сохранится — просто без шифрования; это безопаснее, чем потерять его. Проверить можно в ai-config.json в папке пользовательских данных GitBor: значение, начинающееся с plain:, означает, что шифрование не сработало.

Белый экран или зависший интерфейс

GitBor ловит свои ошибки интерфейса и показывает экран «Something went wrong» с кнопкой Reload UI. Если он не появился, нажмите Ctrl+R, чтобы перезагрузить интерфейс без потери данных. Если и это не помогает, закройте и снова откройте приложение — изменения репозитория на диске независимо от состояния GitBor.

Git не найден при старте

Если Git не установлен (или его нет в PATH), GitBor при старте предложит Download Git и Specify Git Path. Укажите путь к исполняемому git и перезапустите.

Где логи

Продакшн-сборка намеренно не пишет подробные логи в консоль — ваши пути и SHA не должны утекать через DevTools. Если разработчик просит диагностику, спросите у него, как собрать логи в dev-режиме. Для проблем с AI включите debug-логирование в AI Settings → Debug (ai-debug.log).