> ## 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 Clipper сохраняет веб-страницы в чистом Markdown: предпросмотр, копирование, скачивание и отправка прямо в Linkly AI Space.

## Возможности

Расширение извлекает основное содержимое страницы, удаляет навигацию и рекламу и показывает Markdown в боковой панели. Его можно скопировать, скачать или сохранить в `Clips` вашего Linkly AI Space.

Для поддерживаемых сайтов оно также обрабатывает субтитры видео и экспорт диалогов. Извлечение, перевод и AI outline выполняются в браузере, не на servers Linkly AI; изображения скачиваются рядом для offline reading.

## Установка

Установите [Linkly AI Clipper](https://chromewebstore.google.com/detail/linkly-ai-clipper/akplbgdjkgkakgoemhpjpphfilipdbda). Требуется Chrome 116+; Edge/Brave устанавливают из Chrome Web Store. On-device translation/outline требуют свежий Chrome и встроенные models. Sign-in/payment не нужны. Firefox build пока отсутствует.

## Первый клип

<Steps>
  <Step title="Откройте страницу">Дождитесь загрузки динамического содержимого.</Step>
  <Step title="Нажмите L на toolbar">Это единственный способ открыть side panel: context menu и keyboard shortcut нет.</Step>
  <Step title="Проверьте Preview">Доступны Edit source, Metadata, Table of contents и четыре размера текста.</Step>
  <Step title="Copy или Download">Copy кладёт весь Markdown в clipboard; Download выбирает путь в зависимости от Desktop.</Step>
</Steps>

При смене browser tab страница автоматически конвертируется снова; отключите **Settings → Auto-refresh** и используйте Re-convert вручную. **Selection clipping не поддерживается**: всегда извлекается full body; удалите лишнее через Edit source.

## Где сохраняются клипы

Одна и та же Download button имеет два пути:

| Состояние           | Путь                             | Индексирование |
| ------------------- | -------------------------------- | -------------- |
| Desktop running     | `~/LinklyAI/Clips/<clip title>/` | Автоматически  |
| Offline/save failed | `~/Downloads/Linkly/`            | Нет            |

Каждый clip — папка с `.md` и images.

### Как понять способ сохранения

| Toast                                       | Значение                                        |
| ------------------------------------------- | ----------------------------------------------- |
| Saved to Linkly Space                       | В библиотеке                                    |
| Client offline — saved to browser downloads | Desktop не найден, использован резервный путь   |
| Couldn't save… — saved to browser downloads | Передача не удалась, использован резервный путь |
| Saved locally                               | Save to Linkly Space выключен                   |

**Settings → Download settings** показывает Online + version или App not detected, имеет Re-check/Launch. Fallback одноразовый: позже не retry и не импортирует автоматически; перенесите вручную или индексируйте Downloads. Default fallback folder меняется, `Clips/` следует Space и отдельно не настраивается. После успеха Open save location требует современный Desktop. Отдельного UI для browsing clips в Desktop нет.

## Формат клипа

```yaml theme={null}
---
type: "Video Transcript"
title: "What is Linkly AI?"
resource: "https://www.youtube.com/watch?v=HnGMkWaWvVo"
timestamp: 2026-07-28T12:11:16Z
site: "YouTube"
author: "Linkly AI"
---
```

Поля Open Knowledge Format v0.1: `type`, `title`, optional `description`, `resource`, `tags`, `timestamp`, `site`, `author`, `published`, `lang`; отсутствующие не пишутся. Type зависит от сайта: Web Article, WeChat Article, X Thread, Zhihu Article, Video Transcript, AI Conversation. Frontmatter отключается в Export content.

### Изображения

Изображения скачиваются локально, references переписываются на relative paths, поэтому remote links не остаются. Файлы лежат плоско рядом с `.md`, называются `<title>-visual-N.<ext>`, максимум 200 файлов на clip. **Include images** off не скачивает их и удаляет references.

## Специальная обработка сайтов

| Сайт               | Обработка                          |
| ------------------ | ---------------------------------- |
| ChatGPT / Claude   | Весь conversation или один reply   |
| X                  | Полный thread и long-form отдельно |
| YouTube / Bilibili | Timestamped subtitles              |
| WeChat             | Body, author, publication date     |
| Zhihu              | Answers и columns                  |
| Lark Docs          | Document data model вместо DOM     |
| Xiaohongshu        | Body + carousel без avatars        |
| Weibo              | Один post + images                 |
| V2EX               | Topic body                         |

Остальные идут через generic extractor; code blocks получают autodetected language.

## Другие функции

### Локальный перевод

Translate переводит Markdown на English, Simplified/Traditional Chinese, Japanese или Korean через встроенную Chrome model; можно вернуться к original. Первая language pair скачивает model с progress; API key не нужен.

### Режим чтения

Preview даёт typography, четыре font sizes, system dark mode и side-by-side translation без обязательного save.

### Структура с помощью ИИ

Когда headings нет, **Generate AI outline** использует on-device Chrome model и строит clickable TOC. Copy/Download включает generated headings, пока не выключено **Include AI-generated article headings**. Работает только modern desktop Chrome/Edge.

### Экспорт одного ответа ИИ

На ChatGPT/Claude рядом с каждым AI reply внедряется Download. Весь conversation также сохраняется обычным flow с `type: AI Conversation`.

## Работа с Desktop

Для direct save нужен достаточно новый Desktop; auto-update достаточно. Связь идёт plain loopback HTTP `127.0.0.1`, никогда через cloud. Desktop принимает только direct local connection и allowlisted extension origin.

Port может отличаться от 60606; extension проверяет только 60606–60615. Если все заняты, app считается offline и срабатывает downloads fallback.

Индексирование clip занимает от нескольких секунд до минуты из-за debounce/queue.

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

<AccordionGroup>
  <Accordion title="Нужен sign-in или payment?">Нет. Sign-in button сейчас только показывает account details и не меняет функции.</Accordion>
  <Accordion title="Нужен Desktop?">Нет для extraction/translation/copy/download. Без него clip идёт в `~/Downloads/Linkly/` и позже не импортируется автоматически.</Accordion>
  <Accordion title="Не могу найти clip">Проверьте `~/LinklyAI/Clips/<title>/`, затем `~/Downloads/Linkly/`; отдельного browser UI в Desktop нет.</Accordion>
  <Accordion title="Сразу не находится в search">Подождите секунды–минуту; при долгой задержке проверьте Settings → Index.</Accordion>
  <Accordion title="Firefox?">Не поддерживается; Chrome Web Store подходит Chrome/Edge/Brave.</Accordion>
  <Accordion title="Есть shortcut или context menu?">Нет. Только значок на toolbar; исключение — встроенная кнопка загрузки ответа в ChatGPT/Claude.</Accordion>
  <Accordion title="Страница уходит на Linkly servers?">Нет. Extraction/translation/outline внутри browser; destinations только Space или Downloads; Desktop через loopback.</Accordion>
  <Accordion title="Зачем permission на все сайты?">Чтобы clip работал на любом текущем tab; content читается только после вашего click, background browsing не сканируется.</Accordion>
</AccordionGroup>

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

* [Linkly AI Space](/docs/ru/linkly-space)
* [Настройки индекса](/docs/ru/indexing)
* [Notes](/docs/ru/use-notes)