Заметки

Заметки — это внешние записи знаний о проекте с поддержкой поиска. У каждой заметки есть заголовок и текст; она также может содержать теги и ссылки на ассеты.

Выберите Общие или Личные

Область	Хранилище	Поведение системы контроля версий
Общие	`<Project>/ProjectNotes/`	При наличии использует активного поставщика системы контроля версий Unreal
Личные	`<Project>/Saved/Locus/PrivateNotes/`	Никогда не запрашивает поставщика и не изменяет его

Область определяется корнем хранилища. Locus не переводит существующую заметку между областями Общие и Личные.

Быстрая запись заметки

Нажмите Ctrl+Alt+N, чтобы открыть Быстрая запись — компактное всплывающее окно, которое сохраняет обычную заметку Locus, не открывая основную рабочую область Locus. Сочетание клавиш можно переназначить в настройках сочетаний клавиш Unreal Editor.

Основное поле — текст заметки; заголовок необязателен.
Каждое открытие начинается с области Личные. Общие выбирается явно для каждой записи.
Нажмите Ctrl+Enter, чтобы сохранить. Esc закрывает всплывающее окно и сохраняет черновик до конца текущей сессии редактора.

Быстрая запись прикрепляет то, с чем вы работаете, в виде видимых чипов ссылок, которые можно удалить. Контекст может включать заметку в фокусе, выбранную метку, документ в фокусе, выбранные ассеты Браузера контента и выбранные Actor в Level Editor. Actor, на которые нельзя сослаться, перечисляются с указанием причины и не мешают сохранению. Сохранённый текущий мир (World) предлагается отдельно и прикрепляется, только если выбрать Добавить. Обычные правила ссылок продолжают действовать: Общая заметка не может добавить новую ссылку на Личную заметку или Личную метку.

Создать заметку открывает Быструю запись с уже прикреплённым соответствующим контекстом. Это действие доступно в меню Заметки Locus Браузера контента, в контекстном меню Actor в Level Editor, в быстрых действиях метки во viewport, в рабочей области Меток, в рабочей области Locus и в Редакторе документов. Заметка, созданная из метки, не зависит от этой метки и её комментариев.

Входящие быстрых заметок

Раздел Входящие быстрых заметок в рабочей области Заметок показывает ваши быстрые записи, которые всё ещё находятся в корне ваших заметок, и появляется, только когда в нём есть заметки. Каждую из них можно разложить по папке, выбрать Пометить как разложенную, чтобы оставить её в корне и убрать из раздела Входящие, или удалить. Раздел Входящие — только личное представление: каждая быстрая запись — это обычная заметка Locus, а не отдельное место хранения или тип содержимого.

Создание и организация заметок

Используйте Новая заметка или Ctrl+N и выберите область. Locus создаёт уникальный заголовок по умолчанию, сохраняет заметку и начинает редактирование заголовка. Для организации дерева используйте Новая папка или Ctrl+Shift+N.

Папки — это логический уровень организации внутри области. Удаление папки требует подтверждения и перемещает её заметки и дочерние папки в родительскую папку, а не удаляет заметки. Перетаскивайте заметки или папки, чтобы менять их порядок в той же области. Это меняет назначение папки заметки, а не её сохранённый файл, поэтому обычная организация заметок не требует перемещения файла через систему контроля версий. Нажмите F2, чтобы переименовать выбранный элемент, и Ctrl+D, чтобы дублировать выбранную заметку.

Locus фильтрует заметка до Личные при первом открытии проекта. Обычный щелчок выбирает одну строку; Ctrl/Shift-click расширяет выбор. Панель инструментов заметки остается одной строкой, Вставить ссылку, область действия, а затем действия по созданию постепенно перемещаются в меню с многоточием с узкой шириной.

Рабочая область заметок Locus с иерархией папок, контекстом области Общие и активной заметкой — Заметки организуют знания о проекте по папкам и областям, а выбранная заметка остаётся видимой для редактирования.

Редактирование и сохранение

Выберите заметку, чтобы изменить её заголовок, текст, теги и ссылки на ассеты. Теги представлены компактными чипами: введите тег и нажмите Enter, чтобы добавить его, или выберите × на чипе, чтобы удалить его. Пустые теги и дубликаты без учёта регистра отклоняются. Locus сохраняет заметку после небольшой задержки редактирования. Нажмите Ctrl+S, чтобы немедленно записать ожидающие изменения или повторить неудачное сохранение.

Представление Читаемый по умолчанию показывает ссылки на ассеты как подписи. Представление Исходный текст раскрывает их авторскую форму токена. Изменить представление по умолчанию, размер шрифта и перенос строк можно в разделе Настройки.

Поиск заметок

Текстовый поиск учитывает заголовки, текст, теги, подписи ассетов и пути объектов ассетов. Объединяйте его с фильтрами области, тегов или выбранного ассета. Для нескольких выбранных тегов используется сопоставление AND, а регистр при сопоставлении тегов не учитывается.

Используйте контекстное действие Браузера контента Показать связанные заметки проекта, чтобы отфильтровать заметки по выбранному ассету. Создать заметку проекта создаёт Общую или Личную заметку, связанную с контекстом Браузера контента.

Богатые ссылки

Используйте Вставить ссылку для поиска актива, метка, заметка или документ. Вы также можете ввести @, если это поддерживается, или перетащить поддерживаемый элемент Locus или актив Content Browser в редактируемый текст. Ресурсы находятся или открываются в редакторе, заметка выбираются в рабочей области заметка, документ открываются на вкладке редактора документ, а метка используют обычную навигацию.

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

Общие заметка не могут заново ссылаться на частные заметка или частные метка. Частные заметка могут ссылаться на общий или частный контент.

Восстановление и внешние изменения

Снимки восстановления хранятся отдельно от авторитетной заметки:

восстановление Общих заметок: <Project>/Saved/ProjectNotes/Recovery/
восстановление Личных заметок: <Project>/Saved/Locus/Recovery/PrivateNotes/

Если доступно восстановление, изучите его перед выбором Восстановить, Восстановить как новую заметку или Отбросить. Если файл изменился вне Locus, пока есть несохранённые изменения, Locus блокирует незаметную перезапись и предлагает безопасные действия: повторно загрузить файл с диска, сохранить локальный текст как новую заметку, скопировать локальный текст или сравнить версии. Чистая заметка, изменённая извне, обновляется с диска.

Удаление заметок

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

Система контроля версий и Локальный режим

Личные заметки всегда остаются независимыми от поставщика. Выбор, открытие или чтение чистой контролируемой Общей заметки не получает её для редактирования. Она остаётся доступной только для чтения, пока вы не используете действие Получить для редактирования; успешное получение разрешает редактирование, а ошибка оставляет заметку защищённой без обхода Make Writable.

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

Когда активного поставщика нет, новые или неотслеживаемые Общие заметки остаются доступными для редактирования в Локальном режиме. Заметка, уже контролируемая depot, остаётся защищённой, пока поставщик не будет восстановлен и заметка явно не будет получена для редактирования. Locus не отправляет изменения, не синхронизирует их, не управляет changelist и не изменяет typemap репозитория. См. разделы Система контроля версий и Устранение неполадок.

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

Текущие ограничения

Организация заметки остаётся внутри её существующей области Общие или Личные.
Ссылки на ассеты не загружают ассеты только для перечисления или поиска заметок.
Поддержка системы контроля версий ограничена активным поставщиком Unreal и сообщаемым им состоянием файла.

Создание Actor ограничено одним подходящим загруженным World Outliner Actor, помещенным в редактируемый заметка. Перечисление или поиск ссылок не загружает активы, уровни или Actor.