Устраните проблему на шаге

Эти проверки относятся к текущему стабильному выпуску Bee. Сверьте точную команду, установленную версию и код ошибки. Сохраните профиль и данные: ошибка в примере не повод их сбрасывать.

Симптом	Проверка и следующий шаг
bee отсутствует или запускается другая версия	macOS/Linux: command -v bee; PowerShell: Get-Command bee -All. Сравните dotnet tool list --global, --local или --tool-path ./bee-tools с областью установки. Вызывайте нужный исполняемый файл напрямую.
--version или version отклоняется	Установленную версию покажет bee --version (или bee -v); bee --version --json добавит сведения о сборке и платформе. Команды bee version нет. Если флаг отклонён, проверьте исполняемый файл, найденный оболочкой, и область установки.
Пакет NuGet не найден	Проверьте точную версию, feed и .NET 10 SDK через dotnet --info. Следуйте установке и обновлению; новый пакет может ещё индексироваться.
update check возвращает 5	Проверка недоступна; актуальность не установлена. Прочитайте checkStatus и повторите, когда feed доступен. Не переустанавливайте профиль.
bee is not initialized	Для памяти, правил и планов выполните общую настройку. Для локального результата используйте token estimate, не требующий init.
Общее соединение не работает	Проверьте BEE_HOME, bee config path, host/port и доступность базы. Используйте тот же профиль, что в рабочем терминале. Не записывайте строки подключения в лог.
Сохранённая память/план не найдены	Выполните bee remember stats --json в нужном checkout. Сравните фактическую область и базу; worktree может отличаться. Не создавайте дубликат, пока не найдена нужная область.
Graph отсутствует или устарел	bee graph status --check --json: 3 — отсутствует, 6 — устарел. Выполните bee graph build --json, изучите охват и повторите запрос. У outline свои коды выхода.
Анализ без замечаний возвращает 5	Изучите охват, неподдерживаемый контекст и отсутствующие данные компилятора/ссылок. Следуйте требованиям движка и запустите реальные проверки проекта. Частичный результат не означает чистый.
lint --rules пуст или lint --detect не находит инструмент	Ни одна команда не запускает lint. --rules читает рекомендации; --detect показывает план. Настройте и запустите linter проекта; пустые правила не означают успешную проверку.
Путь к тексту/отчёту отклонён	Выберите обычный файл UTF-8 под абсолютным физическим корнем. Избегайте символических ссылок; на macOS/Linux используйте pwd -P. Проверьте ограничения и ошибки, прежде чем копировать приватные файлы.
Сводка/оценка возвращает ненулевой код	TRX-код 1 может верно указывать на неудачный тест. qa assess носит диагностический характер и возвращает 5; qa run выполняет объявленные проверки и возвращает 0 только при подтверждении объявленных критериев, 1 при необходимости исправления, 4 при неверном вводе и 5 при неполных доказательствах. Прочитайте статус отчёта и процесс проверки, прежде чем считать код парсера результатом тестового раннера.
Навыки не настроены или результат пуст	Отличайте сбой соединения от no matches; следуйте руководству навыков. Не угадывайте ID каталога.
Изменение плана конфликтует	Прочитайте bee plan show <plan-id> --json; сравните revision, участника, generation и lease. Разрешите владение перед новым claim. При outcome_unknown сохраните ID и содержимое запроса. Планы.
Сеанс виден, но не отвечает	Проверьте статус сообщения и собственный inbox; поддержку native-сеанса и приёмник в Совместной работе. Присутствие или транспортное подтверждение не доказывают чтение моделью.
Правило отсутствует в контексте	Проверьте область, включение/архив, glob файла и установку hook, затем вывод steering.
guide task предлагает команды, но работа не завершена	Руководство носит рекомендательный характер: оно читает переданные метки, а не исходники и не состояние готовности. Запустите проверки и изучите исходные результаты; справочник.
qa run не может выполнить проверку	Изучите errorCode, argv и объявленные входы; используйте абсолютный путь к интерпретатору или проверенную оболочку. Внешний PATH не передаётся; проверки могут записывать файлы. Выполнение QA.
Данные находятся в другом экземпляре Bee	В нужном checkout запустите bee instance which . --json и bee --version. Привязка сессии и явный выбор экземпляра могут иметь приоритет над каталогом; конфликт даёт код 8. Изоляция экземпляров.

Подготовьте полезное сообщение об ошибке

Укажите OS/архитектуру, область установки, версию Bee, точную команду без секретов, назначение рабочего каталога, фактический код выхода и небольшой синтетический ввод. Опишите ожидаемое и наблюдаемое поведение, приложите минимальные нужные JSON-поля. Исключите учётные данные, приватные prompt и посторонние логи. Если не работает пример, укажите страницу руководства и шаг.

Вернитесь к Первому запуску или Справочнику команд.