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

# Использование Chatbot

> Общайтесь с ИИ в Desktop: он находит, читает и связывает документы на компьютере и отвечает со ссылками на источники.

## Что такое Chatbot

Chatbot — встроенный ИИ-диалог Linkly AI. В отличие от обычного чата, он вызывает инструменты поиска, структуры и чтения, а ответ связывает с найденными документами.

Он не заменяет Launcher: Launcher быстрее для известного файла, а Chatbot подходит для анализа, сравнения, обобщения и вопросов на естественном языке.

### Разделение с Launcher

| Задача                                | Лучше использовать |
| ------------------------------------- | ------------------ |
| Быстро найти и открыть файл           | Launcher           |
| Ответить по нескольким документам     | Chatbot            |
| Отфильтровать по типу и времени       | Launcher           |
| Сравнить, обобщить, написать черновик | Chatbot            |

## Открытие и интерфейс

Левый клик tray или Dock icon macOS открывает Chatbot; собственного global shortcut нет, `⌘/Ctrl+Shift+L` всегда Launcher. Окно по умолчанию 1200×800, minimum 880×640; Close только скрывает, app остаётся в фоне.

Три колонки:

* Слева: **New chat**, **Note**, **Find Files**, **Settings**, чаты по Today/Yesterday/7 days/month/earlier, Rename/Delete; внизу Model quota, состояние индекса, shortcuts и website
* В центре: сообщения и composer; справа от него model picker и использование контекста
* Workspace: **Files in this chat** (Referenced/Read) и поиск по **Library files** с Add to chat, Reveal/Show, Transcribe now; щелчок открывает preview, панель можно развернуть для чтения

### Сочетания клавиш

| Shortcut             | Действие   |
| -------------------- | ---------- |
| `⌘/Ctrl+N`           | Новый chat |
| `⌘/Ctrl+Shift+N`     | Notes      |
| `⌘/Ctrl+B`           | Sidebar    |
| `⌥⌘B` / `Ctrl+Alt+B` | Workspace  |
| `⌘/Ctrl+,`           | Settings   |

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

Кнопка внизу sidebar показывает **Indexing…**, **Index up to date** или **Indexing error** и открывает Settings → Index. Если AI не видит файл, сначала проверьте её и watched folders.

## Ограничение источников через @

Введите `@`, чтобы выбрать local/cloud library, folder или file. Chips отображаются над composer, лишние строки сворачиваются в `+N`; hard limit нет.

<Warning>`@` — **подсказка области модели, не жёсткий фильтр**. Targets добавляются как references в начало сообщения; app не pre-read документы, AI всё равно вызывает tools и может расширить поиск. Для strict scope прямо попросите искать только там и сообщить отсутствие.</Warning>

Scope действует на одно сообщение: в следующем turn без `@` снова global.

### Две группы выбора

| Группа              | Поведение                                                                      |
| ------------------- | ------------------------------------------------------------------------------ |
| Knowledge libraries | Все перечислены сразу                                                          |
| Files and folders   | Сначала нужен keyword, по умолчанию максимум 8; match только basename, не path |

### Условия для облачной библиотеки

1. Desktop signed in / имеет Cloud API key
2. На web нажата **Link**
3. В **Settings → Libraries → Connected cloud libraries** включён toggle
4. Cloud library **не bound к local library**: bound content показывается только через local entry без дубля

### Загрузки файлов нет

Chatbot не имеет обычной кнопки upload. Добавьте файл в индексируемую папку или библиотеку, дождитесь обработки и выберите источник через `@`. Это сохраняет единый локальный индекс вместо временных копий.

## Модель и квота

### Два источника моделей

* Linkly Official после account sign-in
* Пользовательский OpenAI-совместимый provider: OpenAI, DeepSeek, Mistral, Groq, OpenRouter, Qwen, MiniMax, Moonshot, Zhipu, SiliconFlow, Ollama, LM Studio

Presets заполняют Base URL, но не model list; `/v1/models` обнаруживает его либо IDs вводятся вручную. Picker справа от composer группирует providers; Settings → AI задаёт default и language. Модель обязана поддерживать tool/function calling, иначе в picker не появляется.

### Как работает квота

Официальные модели делят общий pool с multipliers и окнами 5h/7d/30d; заполнение любого ограничивает. Quota button показывает три ring/reset. Amber banner после исчерпания можно скрыть, но server enforcement остаётся. Free не видит Pro models; истёкшая Pro с Pro default получает upgrade banner. Third-party/local не тратят quota. Подробнее: [Сервис моделей](/docs/ru/model-service).

## Диалоги и сжатие контекста

### Диалоги

Каждый chat хранится в local SQLite без count/retention limit и auto-cleanup. Сохраняются tool inputs/outputs/status/errors и reasoning. Временный title берётся из первого сообщения, затем модель генерирует окончательный; manual rename никогда не перезаписывается.

### Сжатие контекста

* Auto trigger — **80% context window**, manual — `/compact`
* Если provider не сообщает `context_length`, usage percentage и auto compact не работают; используйте manual/new chat
* Compaction append-only: original messages остаются видимыми, только oldest stretch заменяется для модели summary; recent остаются verbatim
* Summary содержит goal, все user messages, conclusions, docs read, tool/retrieval results включая negative и open questions; reasoning отбрасывается
* UI показывает **Earlier messages compacted (N)** с summary и originals
* До 80% advance warning нет; при 100% появляется banner с Compact

Новый chat при смене темы дешевле и точнее: compact — отдельный model call и неизбежно теряет detail.

## Что делает ИИ

### Вызовы инструментов

Последовательные calls группируются: во время работы auto-expanded, после — collapsed. Внутри видны exact inputs/results, keywords, scope, count и failures.

### Источники

Sentence-level citation marker открывает source; cited/read files автоматически собираются в Workspace → Files in this chat.

## Экспорт

Экспортируется только один объект в Downloads:

| Объект        | Форматы         | Действие                          |
| ------------- | --------------- | --------------------------------- |
| Один ответ ИИ | Markdown / HTML | **Download response** под ответом |
| Одна table    | CSV / Markdown  | Download table над table          |

Whole-conversation export, PNG и XLSX отсутствуют; экспортируйте по частям или copy selection. Проверяйте пути и secrets.

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

<AccordionGroup>
  <Accordion title="Почему ⌘⇧L не открывает Chatbot?">Это global shortcut Launcher. Chatbot открывается tray/Dock; in-window shortcuts требуют focus.</Accordion>
  <Accordion title="@ выбрал library, но AI искал шире">Scope — suggestion. Для strict поиска сформулируйте запрет на другие источники.</Accordion>
  <Accordion title="@ picker не видит file">Введите keyword; candidates до 8. Match идёт по filename, не path. Затем проверьте index и Settings → Folders.</Accordion>
  <Accordion title="Chats удаляются автоматически?">Нет, local DB хранит их без лимита и срока, включая tool data. Удаляйте вручную.</Accordion>
  <Accordion title="Разговор загружается на server?">Зависит от model. Official/third-party cloud получает messages и retrieved excerpts. Ollama/LM Studio tool-capable model оставляет всё локально.</Accordion>
  <Accordion title="Чем Chatbot отличается от Claude/Cursor + MCP?">Retrieval одинаков; Chatbot готов без config и имеет file tree/citations/preview, MCP/CLI встраивает tools в существующий workflow. Можно использовать вместе.</Accordion>
  <Accordion title="После compact старое доступно?">Да, originals не удаляются и раскрываются под divider. Но model дальше видит summary; повторите забытый detail новым сообщением.</Accordion>
</AccordionGroup>

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

* [Сервис моделей](/docs/ru/model-service)
* [Launcher](/docs/ru/use-launcher)
* [Notes](/docs/ru/use-notes)