> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Область индекса

> Решите, какие файлы попадают в индекс: отключайте целые типы файлов или исключайте файлы и папки правилами в формате .gitignore.

По умолчанию 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. В каждой строке показано, сколько файлов этого типа сейчас есть.

* **Отключить тип**: его файлы больше не сканируются, не индексируются и не учитываются в подсчётах; уже проиндексированные удаляются из индекса примерно через минуту. Перед этим приложение попросит подтверждение.
* **Включить снова**: следующее сканирование вернёт файлы и снова добавит их в индекс. Уже распознанный в изображениях текст и готовые расшифровки используются повторно, пока они остаются в кэше; иначе текст на изображениях распознаётся заново, а аудио и видео расшифровываются заново. Если файлов много, это займёт время.

> [!NOTE]
>
> Если вы хотите только пропустить распознавание текста на изображениях, но находить их по имени, не отключайте тип 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`, по одному правилу в строке:

| Правило | Что исключает |
| - | - |
| `*.csv` | Файлы `.csv` в любом месте |
| `drafts/` | Папки с именем `drafts` на любом уровне |
| `/drafts/` | Только папку `drafts` в корне папки, но не одноимённые папки глубже |
| `project-a/export/` | Правило с `/` в середине отсчитывается от корня папки: только эта папка |
| `**/temp/**` | Всё содержимое папок `temp` на любом уровне |
| `!important.md` | Исключение из правил: предыдущее правило исключило файл, это возвращает его |

Несколько деталей:

* `*` означает любые символы в пределах одного уровня, `?` — один символ, `[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 секунд.

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

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

Если исключённые файлы были отправлены в [облачную библиотеку](/docs/ru/use-cloud-library), при следующей синхронизации они удаляются и из облака. При включённой автосинхронизации, если за раз удаляется слишком много, синхронизация приостанавливается, пока вы не подтвердите удаление ручной отправкой; ручная отправка удаляет файлы сразу.

## Файлы .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` в ваших папках
* Неподдерживаемые форматы, например архивы, установщики и файлы кода

Ваши правила могут только исключать **больше** этого; вернуть то, что отсекают встроенные правила, они не могут.

> [!NOTE]
>
> Папки `Notes`, `Clips` и `Canvas` в [Linkly AI Space](/docs/ru/linkly-space) индексируются всегда, независимо от переключателей типов и правил исключения: от этого зависят поиск по заметкам, теги и чтение заметок агентами.

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

Правила хранятся простым текстом в поле `indexScope` файла `config.json` Linkly AI, поэтому агент может их прочитать.

Чтобы агент помог, опишите, что хотите исключить, и попросите текст правил. Затем вставьте весь текст в редактор правил, проверьте правила и сохраните.

> [!WARNING]
>
> Не позволяйте агенту напрямую менять `config.json`: во время работы приложение не перечитывает этот файл, и при следующем сохранении настроек изменение агента будет перезаписано. Если же приложение перезапустится раньше, изменение сразу вступит в силу при запуске — без проверок редактора, без минутной задержки и без отмены.

Когда агент просматривает папку через `list` и не находит в ней проиндексированных файлов, подсказка упоминает, что файлы могли быть исключены правилами индекса; обзор `explore` тоже сообщает, какие типы не индексируются и у скольких папок есть правила.

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

> **Я отключил тип, но его файлы всё ещё находятся?**
>
> Так и должно быть. Чтобы изменение можно было отменить, исключённые файлы покидают индекс примерно через минуту после последнего изменения переключателей или правил. После этого поиск и библиотека их больше не показывают.

> **Почему не работает !drafts/important.md?**
>
> Потому что `drafts/` исключает всю папку: исключённая папка больше не сканируется, и файлы в ней нельзя вернуть по одному. Напишите `drafts/*` и затем `!drafts/important.md`.

> **Правила пропали после перехода на старую версию?**
>
> Старые версии не знают поле с правилами и при запуске перезаписывают файл конфигурации: правила теряются, а исключённые файлы снова индексируются. После повторного обновления настройте правила ещё раз.

***

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

* [Настройки индекса](/docs/ru/indexing) — все переключатели индексирования и поиск проблем
* [FAQ](/docs/ru/faq) — что делать, если файл не находится даже по имени
* [Linkly AI Space](/docs/ru/linkly-space) — где хранятся заметки, клипы и холсты


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.