> ## 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.

# Настройки индекса

> Все параметры Settings → Index: назначение, значения по умолчанию, последствия изменения и диагностика.

Linkly AI находит документы за доли секунды благодаря фоновому **индексированию**. Здесь описаны переключатели **Settings → Index**.

## Как работает индексирование

Индекс строится слоями, поэтому часть функций доступна раньше полного завершения:

1. **Filename, секунды** — путь и имя записываются сразу
2. **Full text** — тело разбирается в локальный keyword index
3. **Semantic** — embedding-модель превращает chunks в vectors

OCR изображений/сканированных PDF и ASR аудио/видео — optional extractors, создающие текст перед этими слоями.

Оригинал не изменяется. Пауза индексирования не отключает поиск по уже готовым данным.

## Страница Settings → Index

| Блок              | Содержимое                     |
| ----------------- | ------------------------------ |
| Indexed Documents | Общее число документов         |
| Status detail     | Шесть read-only строк по слоям |
| Settings          | Семь переключателей            |
| Maintenance       | Optimization и Rebuild         |

### Подробности состояния

| Строка                   | Значение                                              |
| ------------------------ | ----------------------------------------------------- |
| Status                   | Один из Idle / Scanning / Indexing / Watching / Error |
| Filename Search          | Ready при здоровье                                    |
| Full-text Search         | Ready при здоровье                                    |
| Semantic Search          | Ready / Preparing / Queued либо Disabled              |
| Text Recognition         | Ready / Preparing / текущий файл либо Disabled        |
| Audio & Video            | Ready / Processing / Waiting либо Not enabled         |
| Last Updated / Data Size | Последняя запись и размер на диске                    |

## Параметры

### 1. Performance Mode

Default — **Auto**:

| Режим       | Поведение                                                                                     |
| ----------- | --------------------------------------------------------------------------------------------- |
| Balanced    | Минимальная нагрузка                                                                          |
| Performance | Использует доступный compute и может мешать работе                                            |
| Auto        | После 120 секунд без клавиатуры/мыши включает Performance, при активности возвращает Balanced |

На чистом Wayland Linux idle signal недоступен, поэтому Auto ведёт себя как Balanced. Режим меняет ресурсы, но не останавливает indexing.

### 2. Power Saving

Default — off. Работает только когда toggle включён **и** ноутбук на батарее. Приостанавливает OCR, scanned-PDF Markdown, vector generation, ASR, cloud auto-sync и DB housekeeping. Filename/full-text продолжаются, поэтому новые файлы searchable. На desktop или при питании ничего не меняет.

### 3. Выгрузка моделей при простое (Sleep AI Models When Idle)

Default — on. Через \~300 секунд простоя выгружает embedding/OCR/speech models; по запросу загружает снова. Если выключить, вместе они занимают около 1 ГБ RAM. На машине с 8 ГБ и меньше оставьте включённым.

### 4. Распознавание текста изображений (OCR)

Default — on. Один toggle управляет и image OCR, и превращением scanned PDFs в structured Markdown. Обычные текстовые PDF не зависят от него.

### 5. Semantic Search

Default — on. Строит многоязычные vectors для natural-language queries. Отключение не влияет на full-text; повторное включение backfill выполняется автоматически.

### 6 / 7. Audio и Video Transcription

Оба по умолчанию выключены. Audio: mp3, wav, m4a, flac, aac, ogg. Video: mp4, mov, mkv, webm; avi не поддерживается. После включения существующие медиа ставятся в очередь. При выключении файлы всё равно находятся по имени, но не по речи.

## Оптимизация и перестроение

### Оптимизация хранилища индекса

Перестраивает vector index в compact format: примерно на **80% меньше диска** (измерялось до 11,6×) и быстрее search ценой около 1% recall. Выход из приложения безопасен — продолжит на следующем запуске. Если уже оптимизировано, кнопка сообщает **Your index is already optimized** и принудительный повтор невозможен.

### Rebuild Index

Красная destructive-кнопка удаляет full-text directory, vectors и progress markers, но сохраняет оригиналы, extracted text cache и модели. Поэтому обычно быстрее первого индекса. Во время rebuild search возвращает пусто, не ошибку.

Действие отклоняется без изменений, если идёт OCR/ASR, indexing paused, scan/index pass или другой rebuild. Это последний шаг диагностики. Сначала:

1. Проверьте папки и права
2. Убедитесь, что файл доступен локально
3. Посмотрите журнал и точную ошибку
4. Используйте перестроение только при системном повреждении или после рекомендации поддержки

Перестроение не удаляет исходные документы, Notes, Clips, text cache или модели.

## Состояние индекса

| Status   | Значение                              |
| -------- | ------------------------------------- |
| Idle     | Ещё не стартовал **или paused**       |
| Scanning | Обходит folders                       |
| Indexing | Разбирает и индексирует тела          |
| Watching | Желаемое steady state, ждёт изменений |
| Error    | Сбой, причина в application log       |

### Пауза

Pause находится **только** в system tray menu: right-click L → **⏸ Pause Indexing** / **▶ Start Indexing**. В Settings кнопки нет. После Resume очередь продолжится; Rebuild при pause запрещён.

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

<AccordionGroup>
  <Accordion title="Медиа находится по имени, но не по речи">Включите Audio/Video transcription. Скачается 161 MB speech model и существующие файлы обработаются без rescan/rebuild. Исключение: рядом есть `.srt`/`.vtt` или сохранился старый cache.</Accordion>
  <Accordion title="Текст скана не searchable">Проверьте OCR toggle, который также управляет scanned PDFs. Preparing означает загрузку/прогрев модели.</Accordion>
  <Accordion title="Status завис на Idle">Чаще всего indexing paused: right-click tray и выберите Start Indexing. Иначе проверьте собственные folders — onboarding добавляет только samples.</Accordion>
  <Accordion title="Semantic search слишком буквальный">Проверьте Disabled, затем Preparing/Queued. Иначе откройте Settings → AI → Embedding model: неудачная загрузка незаметно переводит search в keyword-only; нажмите Retry.</Accordion>
  <Accordion title="Как поставить на паузу?">Только tray → Pause Indexing; Settings не содержит toggle.</Accordion>
  <Accordion title="Индекс занимает много места">Запустите optimization: около 80% экономии, \~1% recall tradeoff. Already optimized означает, что повтор невозможен.</Accordion>
  <Accordion title="Сразу делать Rebuild при плохой выдаче?">Нет. Проверьте toggles, pause и состояние Watching. Rebuild — последний шаг, временно дающий пустую выдачу.</Accordion>
  <Accordion title="Performance Mode может остановить индекс?">Нет, только меняет threads/yield. Для остановки используйте tray Pause.</Accordion>
  <Accordion title="Power Saving ничего не изменил">Он действует только при включённом toggle и реальной батарее; при питании не влияет.</Accordion>
  <Accordion title="Индексирование тормозит компьютер">Поставьте Balanced, временно отключите ASR, затем при необходимости Pause. ASR — самая тяжёлая работа и делит один slot с OCR.</Accordion>
</AccordionGroup>

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

* [FAQ](/docs/ru/faq)
* [Launcher](/docs/ru/use-launcher)
* [Автономные модели](/docs/ru/offline-models)
