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

> Папка, которую приложение создаёт и индексирует: расположение, содержимое, перенос и важные предостережения.

## Что такое Linkly AI Space

Это обычная пользовательская папка, автоматически добавленная в индекс. Она служит удобным местом для Notes, веб-клипов, примеров и любых файлов, которые вы хотите сразу сделать доступными Linkly AI.

Она не является обязательным хранилищем всех документов: другие каталоги добавляются отдельно в **Settings → Folders**.

## Где она находится

| Система | Путь                           |
| ------- | ------------------------------ |
| macOS   | `/Users/<username>/LinklyAI`   |
| Windows | `C:\Users\<username>\LinklyAI` |
| Linux   | `/home/<username>/LinklyAI`    |

Это home, не Documents. На macOS `⌘⇧H` открывает home. Windows в Settings может показывать нормализованный `C:/Users/...`, но это тот же каталог. Быстро открыть: **Settings → General → Linkly AI Space → Open**.

## Содержимое

```text theme={null}
LinklyAI/
├── Clips/<clip title>/<page.md and images>
├── Notes/YYYY-MM/<first 10 chars>-<8-char id>.md
└── Linkly_AI_Examples/{A-Life-in-10-Years, Detectives-Library, ...}
```

### Notes

Каждая карточка — `.md` в подпапке UTC-месяца. Формат YAML и правила имени: [Notes](/docs/ru/use-notes).

### Clips

Каждый веб-клип хранится в отдельной папке с Markdown-телом и изображениями страницы.

### Linkly\_AI\_Examples

159 публичных Markdown-файлов, около 11,9 МБ после распаковки: дневники, Detectives Library, Federalist Papers, Mission Logs и WPA Slave Narratives. Они распаковываются и индексируются в onboarding; удалить можно безопасно.

<Note>`Clips/` и `Notes/` создаются заново при каждом запуске, если отсутствуют, но их содержимое не восстанавливается. `Linkly_AI_Examples/` распаковывается ровно один раз и после удаления не возвращается.</Note>

## Индексирование

Onboarding добавляет Space в **Settings → Folders** как обычную watched folder; специальных правил нет. Новые и изменённые файлы ставятся в очередь, удалённые исчезают после обновления.

<Warning>Если убрать Space из **Settings → Folders**, приложение продолжит писать туда Notes и Clips, но они не будут доступны поиску и AI — без явного предупреждения. Добавьте каталог обратно для повторного индексирования.</Warning>

## Перенос

<Steps>
  <Step title="Откройте Settings → General">Внизу найдите **Linkly AI Space** и нажмите **Change…**.</Step>
  <Step title="Выберите родительский каталог">Выбор `~/Documents` создаст `~/Documents/LinklyAI`; если выбранная папка уже называется `LinklyAI`, второй уровень не добавляется.</Step>
  <Step title="Подтвердите">Создаётся пустой новый каталог, и конфигурация немедленно начинает писать туда.</Step>
  <Step title="Скопируйте старые файлы сами">Чтобы перенести Notes/Clips, **скопируйте** их через file manager; удаляйте оригинал только после проверки.</Step>
  <Step title="Решите судьбу старого индекса">Старый путь остаётся в Settings → Folders и продолжает индексироваться. Уберите его вручную только если больше не нужен.</Step>
</Steps>

<Warning>**Change… не переносит ни одного файла.** Оно только создаёт пустой каталог и меняет место для новых файлов. Restart не требуется; **Restore Default** работает так же и тоже ничего не переносит.</Warning>

## Ярлык на рабочем столе

После onboarding создаётся desktop shortcut `LinklyAI`, указывающий на папку, не приложение: symlink на macOS, `.lnk` на Windows, `.desktop` на Linux. Удалите shortcut, чтобы избавиться от него; повторно он появится только после Change location. Существующий пользовательский объект с таким именем никогда не перезаписывается.

## Это не каталог данных приложения

Space хранит ваши пользовательские файлы. Каталог данных приложения содержит базу индекса, модели, настройки и журналы. Не копируйте документы в каталог данных и не перемещайте его как Space.

### Журнал приложения

Откройте **Settings → About → Data Directory → Open**, затем `logs/app.log`: прямой кнопки Open Log нет. Файл ротируется при 2 МБ, сохраняя только вторую половину, поэтому при отчёте сначала скопируйте текущий log и лишь затем воспроизводите проблему.

## Ручное удаление или перенос

<Warning>Не удаляйте и не перемещайте Space вручную: это реальные пользовательские файлы, собственного Trash/backup у приложения нет.</Warning>

| Действие                | Результат                                                                                                                     |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Удалить без restart     | Индекс пока остаётся; Settings → Folders показывает **Folder not found**                                                      |
| Удалить и перезапустить | Создаётся пустой `~/LinklyAI`, и примерно через 60 секунд старые записи очищаются из индекса                                  |
| Переместить вручную     | Config всё ещё указывает на старый путь, который будет создан пустым; новый каталог не индексируется, пока вы не добавите его |
| Удалить только Examples | Безопасно; они не создаются повторно                                                                                          |

Правильная последовательность: сначала **Change…**, затем скопируйте содержимое, проверьте, и только потом при необходимости удалите старый watched path в Settings → Folders.

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

<AccordionGroup>
  <Accordion title="Нужно хранить все документы в Space?">Нет. Добавляйте любые каталоги через Settings → Folders.</Accordion>
  <Accordion title="Можно разместить Space в iCloud/Dropbox/OneDrive?">Можно без гарантий. Placeholder-файлы пропускаются до локальной загрузки, временные удаления ждут 60 секунд, служебные каталоги игнорируются. Но on-demand download и conflict copies нагружают индекс; обычно безопаснее добавить cloud folder как обычную watched folder.</Accordion>
  <Accordion title="Change переносит старые файлы?">Нет: только создаёт новый каталог и меняет config. Скопируйте файлы сами; прерванной «миграции» не бывает.</Accordion>
  <Accordion title="Старое место остаётся searchable?">Да, пока вы сами не удалите его из Settings → Folders.</Accordion>
  <Accordion title="Что если убрать Space из watched folders?">Запись Notes/Clips продолжится, но поиск их не увидит. Добавьте Space обратно.</Accordion>
  <Accordion title="Можно удалить примеры?">Да. Они распакованы один раз и после удаления не восстановятся, поэтому при сомнении сначала сделайте копию.</Accordion>
  <Accordion title="Как удалить desktop shortcut?">Просто удалите его. Change location создаст новый shortcut безусловно.</Accordion>
  <Accordion title="Я случайно удалил ~/LinklyAI">До restart восстановите каталог из Time Machine/File History. После restart приложение создаст пустой каталог и примерно через минуту очистит индекс; вернуть содержимое сможет только системный backup.</Accordion>
  <Accordion title="Где log?">В `logs/app.log` внутри Data Directory: Settings → About → Data Directory → Open. Скопируйте до воспроизведения из-за ротации на 2 МБ.</Accordion>
</AccordionGroup>

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

* [Notes](/docs/ru/use-notes)
* [Расширение](/docs/ru/use-extension)
* [FAQ](/docs/ru/faq)