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

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

> Ответы на распространённые вопросы о Linkly AI.

## Как Linkly AI защищает данные?

### Что остаётся на устройстве

* Originals остаются в исходных папках: app только читает, не копирует и не переносит
* BM25 строится локально Tantivy, vectors — в local DB
* Embedding model работает на устройстве; Apple Silicon использует Metal acceleration
* App logs только локальны и не auto-upload

### Куда уходят данные чата

Это зависит от выбранной модели. Официальная облачная модель получает сообщения и фрагменты, которые Chatbot выбрал для ответа. При BYOK данные идут непосредственно указанному провайдеру. Для полностью локальной обработки используйте OpenAI-совместимый сервер в своей сети.

Official model идёт через `api.linkly.ai` к upstream provider; direct third-party минует Linkly; Ollama/LM Studio остаётся локально. Linkly AI не загружает originals для local search. Только explicit cloud library Push отправляет выбранный набор.

### Программа улучшения продукта

Anonymous report по умолчанию включён:

| Отправляется                       | Не отправляется                    |
| ---------------------------------- | ---------------------------------- |
| Агрегированные feature counters    | Document content, filenames, paths |
| Версия приложения, ОС, архитектура | Содержимое чата, поисковые запросы |
| Случайный local device ID          | API keys, custom URLs              |

Отключается в **Settings → Data Privacy → User Experience Improvement Program**; unsent in-memory events отбрасываются.

### Обязательства

* Нет third-party analytics SDK вроде Google Analytics
* Browser history и clipboard не читаются
* Mandatory account отсутствует; core работает offline
* Logs уходят только при вашем явном sharing

## Сколько занимает индексирование?

Три стадии: filename за секунды; full-text extraction/BM25 от минут до часов; vector embedding от минут до часов. Search доступен по завершённым слоям и не блокируется.

### Что влияет на скорость

* Count примерно линейно влияет на время; plain text быстрее PDF/OCR/media
* Apple Silicon Metal значительно быстрее CPU embeddings; Windows/Linux сейчас CPU
* Performance использует больше concurrency; Auto включает его после idle

### Примерные ожидания

| Сценарий                      | Оценка                          |
| ----------------------------- | ------------------------------- |
| Тысячи txt/md на M-series Mac | Минуты                          |
| Десятки тысяч mixed/PDF       | Десятки минут — несколько часов |
| Много OCR images              | Значительно дольше              |
| То же на Windows/Linux CPU    | Медленнее Mac                   |

Начните с сотен/тысяч, затем добавляйте больше.

## Почему определённый файл не находится?

Сначала ищите **по filename**:

| Результат                            | Значение                                |
| ------------------------------------ | --------------------------------------- |
| Найден с grey Not indexed badge      | В index есть metadata, content skipped  |
| Найден без badge, body не searchable | Extraction не закончился или toggle off |
| Даже filename не найден              | Файл вообще не вошёл в index            |

Skipped files не перечислены в Settings; badge выдачи — единственный список.

### Четыре основные причины

| Badge                | Причина                                                 |
| -------------------- | ------------------------------------------------------- |
| cloud placeholder    | Content не скачан локально                              |
| signature mismatch   | Header не соответствует extension                       |
| no audio track       | Видео без audio                                         |
| transcription failed | Аудиопоток нельзя декодировать или он не поддерживается |

### Облачные заглушки

Linkly AI намеренно не открывает on-demand placeholders, иначе scan мог бы скачать сотни GB. В OneDrive выберите Always keep on this device, Dropbox — Make available offline, iCloud — Download Now. Следующий auto scan проиндексирует body без rebuild/re-add; restart запускает scan немедленно.

### Несовпадение подписи

Signature bytes не совпадают с extension: sync stub, half-download или ручное rename. Откройте в соответствующем app; если extension неверен, исправьте. Transient IO/permission error не маркируется mismatch, чтобы реальный файл не был permanently rejected.

## Файл находится по имени, но содержимое не ищется

По порядку: OCR для images/scanned PDFs или ASR toggles (по умолчанию off); тяжёлая queue ещё идёт; конкретный corrupted/encrypted file не распарсился и не retry. Смотрите current work в Settings → Index.

## Файл не находится даже по имени

1. Parent directory не watched; onboarding добавляет только samples
2. Extension не allowlist: поддерживаются PDF, DOCX, PPTX, EPUB, MD/MDX, TXT, HTML, images, audio/video; **xlsx, csv, doc, rtf, htm, avi** пока даже filename не регистрируют
3. В игнорируемом каталоге: скрытые dot-folders, node\_modules, `__pycache__`, `#recycle`, `#SynoRecycle`, `@eaDir`, `@Recycle`, `$RECYCLE.BIN`, `System Volume Information`

В Git repo также соблюдается `.gitignore`. Добавьте ignored notes отдельно в Settings → Folders или перенесите.

## Почему нельзя искать речь в аудио и видео?

Расшифровка по умолчанию выключена. Включите **Audio transcription** и **Video transcription** в **Settings → Index**. Существующие файлы будут обработаны автоматически; повторно добавлять папку не нужно.

## Можно работать без интернета?

Да. OCR, ASR и semantic local; около 870 MB models обычно скачиваются при первом запуске. Заранее перенесите installer и official model pack по [offline guide](/docs/ru/offline-models). Cloud Chatbot, account, cloud libraries и updates без сети недоступны.

## Linux AppImage не запускается

```bash theme={null}
uname -m
ldd --version | head -n 1
chmod +x LinklyAI-*.AppImage
./LinklyAI-*.AppImage 2>&1 | tee linkly-ai-linux-startup.log
```

<AccordionGroup>
  <Accordion title="Permission denied">Выполните chmod и не запускайте через `sudo`, иначе config/data могут стать недоступны regular user.</Accordion>

  <Accordion title="FUSE / libfuse.so.2 / mount error">
    Используйте только официальный репозиторий дистрибутива: Ubuntu 22.04/Debian 12 `sudo apt install libfuse2`; Ubuntu 24.04+ `libfuse2t64`; Fedora `sudo dnf install fuse-libs`; Arch `sudo pacman -S fuse2`; openSUSE `sudo zypper install fuse libfuse2`. Временно: `./LinklyAI-*.AppImage --appimage-extract-and-run`; это не исправляет несовместимость GLIBC, CPU или драйверов.
  </Accordion>

  <Accordion title="GLIBC / GLIBCXX / CXXABI not found">Обновите official packages и distribution. Минимум glibc 2.35. Не заменяйте `/lib/.../libc.so.6`, не копируйте runtime из другой distro и не смешивайте repos/LD\_LIBRARY\_PATH — можно сломать OS.</Accordion>
  <Accordion title="Exec format / architecture">Текущий package только x86\_64/amd64; для aarch64/arm64 Linux installer нет.</Accordion>
  <Accordion title="Process starts, window absent">Обновите system/graphics drivers; сохраните terminal log. При повторе приложите `cat /etc/os-release`, `uname -a`, `echo "session=$XDG_SESSION_TYPE desktop=$XDG_CURRENT_DESKTOP"`. Не закрепляйте случайные WebKit/GTK env vars из интернета.</Accordion>
  <Accordion title="Built-in update failed">AppImage должен лежать в writable user directory, например `~/Applications`, а не read-only/root-owned mount.</Accordion>
</AccordionGroup>

Если `app.log` ещё не создан, используйте startup terminal output.

## Где находятся нужные настройки?

| Задача                | Раздел               |
| --------------------- | -------------------- |
| Добавить папки        | Settings → Folders   |
| OCR, семантика, медиа | Settings → Index     |
| MCP, LAN, туннель     | Settings → MCP       |
| Модели и провайдеры   | Settings → AI        |
| Обновление и журналы  | Settings → About     |
| Библиотеки            | Settings → Libraries |

General также содержит язык, **Launch at Login**, включённый по умолчанию **Silent Launch**, **Search Shortcut** и Space. Appearance — тема, размер шрифта и Dock icon macOS. About — **Check for Updates**, restart, Beta и Data Directory. `⌘/Ctrl + /` открывает Shortcuts. **Pause Indexing** находится только в меню по правому клику на значке в трее.

## Где найти журналы приложения?

### Через приложение

Откройте **Settings → About → Data Directory → Open**, затем `logs/app.log`. Прямой кнопки Application Logs нет. Файл capped/rotated при 2 MB; sensitive data redacted.

### Вручную

| OS      | Путь logs                                              |
| ------- | ------------------------------------------------------ |
| macOS   | `~/Library/Application Support/ai.linkly.desktop/logs` |
| Windows | `%APPDATA%\ai.linkly.desktop\logs`                     |
| Linux   | `~/.local/share/ai.linkly.desktop/logs`                |

Linux можно открыть `xdg-open ~/.local/share/ai.linkly.desktop/logs` или скопировать на Desktop. Просмотрите local paths/identifiers перед sharing.

### Если приложение падает при запуске

Сбой до создания `app.log` записывается в `linkly-ai-startup-panic.log`:

* macOS: `~/Library/Application Support/linkly-ai-startup-panic.log`
* Windows: `%LOCALAPPDATA%\linkly-ai-startup-panic.log` (не `%APPDATA%`)
* Linux: `~/.local/share/linkly-ai-startup-panic.log`

Он создаётся только при startup crash и перезаписывается следующим. Если отсутствует, приложите screenshot и OS version. Не удаляйте data/index; сначала backup и минимальный log fragment в [сообщество](/docs/ru/community).
