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

Начните с подходящего ниже симптома. Сохраните файлы проекта перед ручным изменением хранилища.

Locus отсутствует или не загружается

Убедитесь, что плагин находится в <Project>/Plugins/Locus/ и включён в Edit > Plugins.
Убедитесь, что пакет соответствует точной младшей версии Unreal Engine проекта.
Перезапустите Unreal Editor после включения или замены плагина.
Попробуйте Window > Locus или Ctrl+Shift+L.
Проверьте Unreal Output Log на наличие категории LogLocus и ошибки загрузки плагина.

Если бинарный пакет предназначен для другой младшей версии движка, замените его правильным пакетом; не копируйте отдельные бинарные файлы между пакетами.

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

Откройте раздел Система контроля версий и проверьте, контролируется ли файл, получен ли он для редактирования другим пользователем или клиентом, устарел ли он или недоступен из-за отключённого поставщика. Чистый контролируемый файл также остаётся доступным только для чтения, пока вы явно не получите его для редактирования.

Получить для редактирования может быть недоступно, если файл принадлежит другому клиенту, рабочая область отстаёт от depot или поставщик не может сообщить безопасное состояние. Разрешите состояние владения или ревизии обычным рабочим процессом системы контроля версий проекта. После восстановления поставщика обновите систему контроля версий Unreal или Locus; контролируемое содержимое остаётся доступным только для чтения до успешного получения. Не обходите защиту изменением разрешений файловой системы.

Личные заметки и метки не должны зависеть от поставщика. Если они недоступны, проверьте наличие и доступность для записи хранилища проекта Saved/Locus.

Если поставщик не настроен, отсутствие статуса управления версиями, всплывающих подсказок, указаний, пользовательского интерфейса Получить для редактирования или Пометить для добавления является обычным локальным режимом. Настроенный, но недоступный поставщик отличается от других и обеспечивает защиту известного контролируемого контента.

Получение для редактирования или Пометить для добавления завершилось ошибкой

Убедитесь, что провайдер Unreal настроен, подключен и может сообщить о файле. Неудачный запрос Пометить для добавления после создания Пометить для добавления оставляет на диске новый общий заметка. Новые общие метка и документ остаются Untracked до тех пор, пока они не будут добавлены явно; Общие моментальные снимки метка имеют отдельное состояние системы управления версиями.

Документ не переименовывается и не перемещается

Для переименования и перемещения используйте рабочую область Документов Locus; элемент Браузера контента — это проекция, а не авторитетная поверхность переименования. Подходящий Неотслеживаемый документ можно переименовать через Переименовать или F2, а переместить через Переместить или перетаскиванием в существующую допустимую папку. Locus намеренно блокирует Переименовать и Переместить для документов, помеченных для добавления, и контролируемых документов, поскольку не может безопасно выполнить перемещение в системе контроля версий, нейтральное к поставщику. Не обходите это отключением системы контроля версий или изменением разрешений файловой системы; организуйте документ до действия Пометить для добавления.

Заметки, метки или документы не обновляются

Используйте действие перестроения или обновления активной рабочей области. Для документов, изменённых во внешнем редакторе, сохраните корректный файл .md в UTF-8 под ProjectDocuments. Для меток убедитесь, что текущий мир сохранён и метка связана с разрешённой картой.

Доступно восстановление

Перед действием проверьте основной элемент на диске и копию восстановления. Восстановить заменяет основной элемент восстановленной работой, Восстановить как новый сохраняет оба элемента, а Отбросить удаляет копию. Если вы не уверены, лучше восстановить как новый элемент.

Внешний конфликт

Внешний конфликт означает, что файл на диске изменился, пока Locus хранил несохранённые изменения. Не принуждайте перезапись. Используйте доступные действия, чтобы перезагрузить диск, сохранить локальную работу как новый элемент, скопировать локальный текст или сравнить версии, если это возможно.

Некорректные или неподдерживаемые данные

Сохраните исходный файл и изучите сообщение LogLocus. Не редактируйте вручную идентификаторы или поля владения, если у вас нет проверенной резервной копии и понимания формата. Некорректный Markdown-файл в UTF-8 отклоняется при импорте. Неподдерживаемый Markdown должен оставаться неизменным исходным текстом, даже если Режим чтения не может полностью его показать.

Ссылка отсутствует или устарела

Обновите соответствующую рабочую область и убедитесь, что актив, метка, заметка, документ или Actor все еще существует. Перемещенная или удаленная цель может оставаться читаемой, но неразрешенной, поэтому вы можете намеренно ее восстановить.

Создайте ссылку Actor, только перетащив ровно один подходящий загруженный Actor из World Outliner в редактируемый заметка или документ. Он отсутствует в Вставить ссылку и @; Экземпляры уровней и неподдерживаемые временные или предварительные миры не поддерживаются.

Метки недоступны

Для постоянных меток требуется сохранённый мир верхнего уровня редактора. Сохраните карту, вернитесь к Текущая карта и повторите размещение. Файлы меток не загружают и не изменяют карты только для просмотра Все карты.

Для захвата и обновления снимков также требуется доступный видовой экран Level Editor в перспективе, и они недоступны во время PIE.

Документы отсутствуют

Убедитесь, что файл .md находится под <Project>/ProjectDocuments/ и использует корректный UTF-8. Путь за пределами зарезервированного поддерева Content/ отображается под Документы Locus и не проецируется в Браузер контента Unreal. Путь под ProjectDocuments/Content/ отображается под разреженным корнем Браузер контента и проецируется в соответствующий контекст /Game. Обновите документы после внешних изменений. Несвязанные папки /Game намеренно отсутствуют: дерево строится по индексированным документам, а не по папкам Asset Registry. Помните, что документы — это внешние проецируемые элементы, а не UAsset.

Markdown отображается не так, как ожидалось

Проверьте раздел Документы для списка поддерживаемых конструкций. Необработанный HTML и небезопасные URL остаются неактивными, удалённое содержимое не загружается, а рендеринг, эквивалентный браузеру, не обещан. Переключитесь в Режим редактирования, чтобы подтвердить целостность авторитетного исходного текста.

Клиент MCP не подключается или доступ отклонён

Оставьте Unreal Editor открытым и в Editor Preferences > Plugins > Locus > MCP Integration убедитесь, что Включить MCP включён, а состояние показывает работу. Если локальная конечная точка или конфигурация клиента недоступны, скопируйте свежую конфигурацию после изменения локального порта или генерации нового учётного параметра.

Перед копированием выберите подходящий Формат клиента. Команды регистрации Claude Code и Gemini CLI запускайте в обычном терминале, а не внутри их интерактивных приглашений. Gemini использует область пользователя, поэтому старая глобальная запись locus может указывать на конечную точку другого проекта; замените её свежей конфигурацией из текущего открытого проекта. Никогда не вставляйте скопированную команду или учётный параметр в запрос поддержки.

Одной активной сессией Locus может владеть только один клиент. Закройте или отключите прежний клиент, немного подождите и повторите; используйте Сбросить активный клиент, только если этот клиент больше не используется. Изменение требует Разрешить изменения, а доступ к Личным заметкам или меткам требует отдельного Разрешить личные заметки и метки. Работа MCP с метками ограничена поддерживаемой сохранённой принадлежащей проекту базой мира /Game/....

См. раздел Интеграция MCP с полной информацией о подключении, разрешениях, поддерживаемых инструментах и контексте меток.

Документация или отзыв не открываются

Внешние ссылки используют браузер операционной системы по умолчанию. Проверьте, настроен ли браузер HTTP/HTTPS по умолчанию и разрешает ли операционная система запуск URL. Ошибка не изменяет данные проекта. В интеграции MCP есть кнопка Документация, а Locus также предоставляет Оставить отзыв.