> ## 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 для документов. Сгруппируйте материалы одной темы и ограничивайте ими область поиска.

<CardGroup cols={2}>
  <Card title="Разделение тем" icon="layer-group" iconType="duotone">Рабочие документы и научные статьи не смешиваются в результатах.</Card>
  <Card title="Точный поиск" icon="bullseye" iconType="duotone">Ограничьте область библиотекой в Launcher, MCP или CLI.</Card>
</CardGroup>

Библиотеки — необязательная расширенная функция. Без них глобальный поиск работает как прежде. Они особенно полезны при большом числе документов.

### Примеры

* Исследователи группируют статьи по темам, например `ml-papers`
* Разработчики разделяют документацию проектов, API и протоколы встреч
* Команды создают библиотеку на проект, чтобы ИИ искал только нужные материалы
* Личные заметки, цитаты из книг и справочные материалы распределяются по категориям

## Создание библиотеки

<Steps>
  <Step title="Откройте Libraries">Перейдите в **Settings → Libraries**.</Step>
  <Step title="Создайте библиотеку">Нажмите **New Library** и укажите уникальное **Name** из строчных букв, цифр и дефисов, например `my-research`, а также необязательное **Description**.<Tip>Имя используется как параметр фильтра, поэтому делайте его коротким.</Tip></Step>
  <Step title="Добавьте папки">На странице библиотеки нажмите **Add Folder**. Можно добавить несколько папок; Linkly AI автоматически просканирует и проиндексирует документы.</Step>
</Steps>

### Управление

* Карандаш изменяет имя и описание
* Значок удаления рядом с папкой отвязывает её, не удаляя реальные файлы
* Удаление библиотеки не удаляет индексированные документы: они остаются в глобальном поиске

## Поиск по библиотеке в Launcher

<Steps>
  <Step title="Введите @">В поле поиска введите `@`; появится список библиотек.</Step>
  <Step title="Выберите библиотеку">Нажмите её или Enter. Синий значок вроде `@my-research` покажет выбранную область.</Step>
  <Step title="Введите запрос">Результаты будут только из папок библиотеки и заметок или клипов, добавленных фильтром тегов.</Step>
  <Step title="Выйдите из режима">При пустом запросе нажмите Backspace или кнопку назад.</Step>
</Steps>

## Библиотеки и ИИ-помощники

<CardGroup cols={1}>
  <Card title="Поиск в библиотеке" icon="magnifying-glass" iconType="duotone" horizontal>«Найди в библиотеке ml-papers документы о механизмах внимания»</Card>
  <Card title="Список библиотек" icon="list" iconType="duotone" horizontal>«Покажи все мои библиотеки»</Card>
  <Card title="Сочетание фильтров" icon="filter" iconType="duotone" horizontal>«Найди PDF о трансформерах в библиотеке ml-papers»</Card>
</CardGroup>

## Библиотеки в CLI

```bash theme={null}
linkly list-libraries
linkly search "attention mechanism" --library ml-papers
linkly search "transformer" --library ml-papers --path-glob "*.pdf"
```

## Отправка в облако

Локальную библиотеку можно целиком отправить в облако. Тогда ИИ сможет искать в ней при выключенном компьютере, а библиотекой можно делиться. Функция доступна бесплатно.

<Card title="Облачные библиотеки" icon="cloud" href="/docs/ru/use-cloud-library">Создание, отправка, автоматическая синхронизация, подключение чужой библиотеки и публикация описаны здесь.</Card>

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

<AccordionGroup>
  <Accordion title="Добавление папки запускает повторное индексирование?">Нет. Библиотека добавляет логическую группировку поверх существующего индекса.</Accordion>
  <Accordion title="Как связаны библиотеки и папки?">Папки библиотеки появляются в общем управлении папками. Прямого добавления папок достаточно большинству пользователей. Библиотеки нужны для тематического разделения, выборочного включения заметок по тегам и отправки набора материалов в облако. Без специальных требований ими можно не пользоваться.</Accordion>
</AccordionGroup>
