Skip to main content
По умолчанию Linkly AI индексирует все поддерживаемые файлы в ваших папках. Лишнее можно не пускать в индекс двумя способами:
  • Переключатели типов файлов: отключают целый тип, например изображения или видео, во всех папках.
  • Правила исключения: пишутся как .gitignore и исключают файлы и папки по имени или пути.
Оба находятся на вкладке Rules страницы Index management: нажмите на состояние индекса внизу боковой панели, чтобы открыть Index management, и перейдите на вкладку Rules. Исключённые файлы удаляются из индекса: поиск, библиотека, чат с ИИ и подключённые агенты их больше не видят. Файлы на диске не затрагиваются.

​
Переключатели типов файлов

Типов 10, в двух группах — Documents и Images, audio and video: PDF, Word documents, Markdown and plain text, Web pages, E-books, Spreadsheets, Presentations, Images, Audio и Video. В каждой строке показано, сколько файлов этого типа сейчас есть.
  • Отключить тип: его файлы больше не сканируются, не индексируются и не учитываются в подсчётах; уже проиндексированные удаляются из индекса примерно через минуту. Перед этим приложение попросит подтверждение.
  • Включить снова: следующее сканирование вернёт файлы и снова добавит их в индекс. Уже распознанный в изображениях текст и готовые расшифровки используются повторно, пока они остаются в кэше; иначе текст на изображениях распознаётся заново, а аудио и видео расшифровываются заново. Если файлов много, это займёт время.
Если вы хотите только пропустить распознавание текста на изображениях, но находить их по имени, не отключайте тип Images, а выключите Text recognition (OCR) в разделе Extraction enhancements на вкладке Index. И наоборот: когда тип Images отключён, OCR обрабатывает только отсканированные PDF и изображения в папках Notes, Clips и Canvas.
Когда аудио или видео отключено, соответствующий переключатель расшифровки в Extraction enhancements становится серым.

​
Правила исключения

На вкладке Rules есть список правил для всех папок (All folders) и отдельный список для каждой папки. Нажмите Edit или Add rules, чтобы открыть редактор правил. Можно также щёлкнуть правой кнопкой по файлу или папке в библиотеке и выбрать Add exclusion rule…: редактор откроется с правилом, которое совпадает только с этим элементом. Если у папки уже есть правила, в меню появится и Edit exclusion rules…. В библиотеке, когда правило прямо называет папку, у папки уровнем выше появляется значок воронки — по нему тоже открывается редактор.

​
Как писать правила

Так же, как в .gitignore, по одному правилу в строке: Несколько деталей:
  • * означает любые символы в пределах одного уровня, ? — один символ, [abc] — один из символов в скобках, а **, занимающее целый уровень, — любое число уровней. ? и […] совпадают только с простыми символами ASCII — латинскими буквами без диакритики, цифрами и обычными знаками; для кириллицы, китайских иероглифов, букв с диакритикой и т. п. используйте *.
  • / в конце означает, что правило совпадает только с папками.
  • Правила применяются сверху вниз, и решает последнее совпавшее, поэтому исключение пишется после правила, которое оно отменяет.
  • Если папка исключена, файлы внутри неё нельзя вернуть через !. Чтобы исключить папку, но оставить один-два файла, напишите drafts/* и затем !drafts/important.md.
  • Регистр латинских букв от A до Z не учитывается: *.PNG — то же, что *.png. Так же и на чувствительных к регистру файловых системах Linux: Draft/ исключит и draft/. В остальных буквах, включая кириллицу, регистр должен совпадать с именем: Черновики/ не исключит черновики/.
  • \ всегда считается /, поэтому экранировать обратной косой чертой нельзя; символы *, ?, [, { и } в имени пишутся как [*], [?], [[], [{] и [}] ({a,b} совпадает с a или b).
  • Пути пишутся от корня папки; не указывайте полный путь на диске.

​
Все папки и отдельная папка

Каждая папка сначала применяет правила All folders, затем свои. Поэтому собственные правила папки могут вернуть через ! файлы, исключённые правилом для всех папок. Если папки вложены (например, добавлены и Docs, и Docs/Project A), файл оценивается только по правилам самой глубокой папки, в которой он лежит.

​
Редактор правил

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

​
Когда правила вступают в силу

Исключённые файлы покидают индекс примерно через минуту после сохранения; до этого их ещё можно найти. Благодаря этому отмена и повторные правки не требуют повторной обработки файлов. Когда вы снимаете правило, следующее сканирование возвращает файлы и обрабатывает их заново. Если исключённые файлы были отправлены в облачную библиотеку, при следующей синхронизации они удаляются и из облака. При включённой автосинхронизации, если за раз удаляется слишком много, синхронизация приостанавливается, пока вы не подтвердите удаление ручной отправкой; ручная отправка удаляет файлы сразу.

​
Файлы .ignore в ваших папках

Правила можно хранить и в файле: положите в папку файл с именем .ignore и пишите его как .gitignore.
  • Он действует на папку, в которой лежит, и на всё её содержимое.
  • Репозиторий Git не нужен.
  • .gitignore работает только внутри репозиториев Git, а .ignore — в любой папке.
  • Он применяется точно так же, как .gitignore: регистр учитывается, а \ экранирует следующий символ, поэтому в путях используется только /.
  • Изменение .ignore не запускает сканирование: уже проиндексированные файлы покинут индекс при следующем полном сканировании, например после перезапуска Linkly AI.
Это удобно для правил, которые должны переезжать вместе с папкой, например для каталога экспорта проекта.

​
Встроенные правила

Они действуют всегда и не отключаются; их список есть и внизу вкладки Rules:
  • Скрытые файлы и папки: имена, начинающиеся с ., например .git, .obsidian, .DS_Store
  • Папки, которые создают система и программы синхронизации: node_modules, __pycache__, #recycle, #SynoRecycle, @eaDir, @Recycle, $RECYCLE.BIN, System Volume Information
  • Файлы данных Linkly AI: индекс, настройки, журналы и другие данные приложения (папка ai.linkly.desktop)
  • Временные файлы: файлы ~$, которые Office создаёт, пока документ открыт, и Thumbs.db
  • Файлы, игнорируемые .gitignore в репозитории Git
  • Правила из файлов .ignore в ваших папках
  • Неподдерживаемые форматы, например архивы, установщики и файлы кода
Ваши правила могут только исключать больше этого; вернуть то, что отсекают встроенные правила, они не могут.
Папки Notes, Clips и Canvas в Linkly AI Space индексируются всегда, независимо от переключателей типов и правил исключения: от этого зависят поиск по заметкам, теги и чтение заметок агентами.

​
Попросите агента написать правила

Правила хранятся простым текстом в поле indexScope файла config.json Linkly AI, поэтому агент может их прочитать. Чтобы агент помог, опишите, что хотите исключить, и попросите текст правил. Затем вставьте весь текст в редактор правил, проверьте правила и сохраните.
Не позволяйте агенту напрямую менять config.json: во время работы приложение не перечитывает этот файл, и при следующем сохранении настроек изменение агента будет перезаписано. Если же приложение перезапустится раньше, изменение сразу вступит в силу при запуске — без проверок редактора, без минутной задержки и без отмены.
Когда агент просматривает папку через list и не находит в ней проиндексированных файлов, подсказка упоминает, что файлы могли быть исключены правилами индекса; обзор explore тоже сообщает, какие типы не индексируются и у скольких папок есть правила.

​
Частые вопросы

Так и должно быть. Чтобы изменение можно было отменить, исключённые файлы покидают индекс примерно через минуту после последнего изменения переключателей или правил. После этого поиск и библиотека их больше не показывают.
Потому что drafts/ исключает всю папку: исключённая папка больше не сканируется, и файлы в ней нельзя вернуть по одному. Напишите drafts/* и затем !drafts/important.md.
Старые версии не знают поле с правилами и при запуске перезаписывают файл конфигурации: правила теряются, а исключённые файлы снова индексируются. После повторного обновления настройте правила ещё раз.

​
Дополнительные материалы

  • Настройки индекса — все переключатели индексирования и поиск проблем
  • FAQ — что делать, если файл не находится даже по имени
  • Linkly AI Space — где хранятся заметки, клипы и холсты