Начало работы

Это руководство знакомит с тремя рабочими областями Locus и не требует системы контроля версий или онлайн-учётной записи.

1. Откройте Locus

Откройте Window > Locus, нажмите кнопку Locus на панели инструментов Браузера контента или нажмите Ctrl+Shift+L. Верхняя навигация переключается между Заметками, Метками и Документами. Кнопка Настройки находится справа на главной панели инструментов.

2. Создайте Заметку

Откройте Заметки, выберите Новая Заметка и укажите область:

• Общие сохраняют файл .uenote в <Project>/ProjectNotes/ для совместной работы над проектом.
• Личные сохраняют его в <Project>/Saved/Locus/PrivateNotes/ для текущей локальной рабочей области проекта.

Дайте заметке понятное название, введите текст и при необходимости добавьте теги или ссылки на ресурсы. Заметки автоматически сохраняются после небольшой паузы редактирования. Нажмите Ctrl+S, чтобы немедленно сохранить изменения или повторить неудачную попытку сохранения.

Сведения о папках, поиске, восстановлении и конфликтах см. в разделе Заметки.

3. Разместите Метку

Откройте сохранённый уровень, перейдите в Метки и выберите действие размещения Общей или Личной Метки. Щёлкните по поверхности во viewport уровня, чтобы разместить Метку; нажмите Esc, чтобы выйти из режима размещения.

Метка может содержать название, текст, теги, комментарии и тип. Она хранится в файле .locuspin вне карты. Размещение или редактирование Метки не добавляет Actor и не помечает пакет карты как изменённый.

Сведения об управлении viewport, сохранённых представлениях и настройках видимости см. в разделе Метки.

4. Создайте Документ

Перейдите в Документы. Создайте Документ в Документах Locus, чтобы получить Markdown-файл только для Locus, или в Браузере контента, чтобы сопоставить Документ с соответствующей папкой /Game. В обоих случаях это принадлежащие проекту файлы .md в <Project>/ProjectDocuments/; корневые папки различают представление, но не создают отдельные репозитории. Новые Документы имеют статус Неотслеживаемые, поэтому их можно организовать, переименовать, переместить и отредактировать, а затем выбрать Пометить для добавления, когда путь станет окончательным.

Документы используют явное сохранение: нажмите Ctrl+S. Режим редактирования показывает исходный текст Markdown, а Режим чтения отображает поддерживаемый Markdown с нативным интерфейсом Unreal. Одновременно можно открыть несколько Документов.

Сведения о сопоставлении с Браузером контента, импорте и экспорте и ограничениях Markdown см. в разделе Документы.

Локальный режим

Контроль источника не является обязательным. Без настроенного поставщика Locus редактирует локальные и неотслеживаемые файлы в Локальный режим без операций поставщика или пользовательского интерфейса, специфичного для системы управления версиями. При настроенном поставщике новые общие заметка сохраняют свой запрос на добавление после создания; новые общие метка и документ остаются Untracked до тех пор, пока вы явно не выберете Пометить для добавления. Контролируемый контент остается защищенным, когда его поставщик недоступен, а частный контент никогда не связывается с поставщиком. См. Система контроля версий.

6. Настройте рабочую область

Откройте Настройки, чтобы изменить оформление, представление редактора, размеры шрифтов, перенос строк, плотность дерева, восстановление рабочей области и представление Меток. Действия сброса влияют на состояние интерфейса, а не на содержимое. См. разделы Настройки и Оформление.

7. Подключите клиент MCP (необязательно)

Locus может подключить совместимый локальный клиент MCP к поддерживаемым Заметкам, Документам, Меткам и сведениям о состоянии, пока Unreal Editor открыт. Автономного ИИ-помощника в Locus нет; рабочий процесс с ИИ выполняет подключённый клиент. Когда будете готовы к настройке, начните с раздела Интеграция MCP.

Чтобы сообщить о проблеме или предложить улучшение, выберите Оставить отзыв в Locus или посетите сайт отзывов.