> ## 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. Каждая заметка — локальный Markdown-файл, доступный для поиска, чтения ИИ и любого редактора.

## Что такое заметки

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

### Для чего они подходят

* Быстрые мысли и задачи
* Итоги встреч и решений
* Выдержки из диалога с ИИ
* Небольшие справочные записи с тегами

## Открытие Notes

Notes — представление внутри Chatbot, не отдельное окно. Нажмите **Note** в sidebar или `⌘⇧N` (`Ctrl+Shift+N`). Shortcut работает только при фокусе Chatbot; единственный глобальный — `⌘⇧L` / `Ctrl+Shift+L` для Launcher.

## Первая заметка

<Steps>
  <Step title="Введите текст">Постоянное поле внизу показывает **Write a note… Use #tag to tag it**. Expand увеличивает поле вверх до 60% окна, не теряя draft/cursor.</Step>
  <Step title="Сохраните">Нажмите `⌘/Ctrl+Enter` или send. Обычный Enter добавляет строку. Карточка сразу появляется внизу timeline.</Step>
  <Step title="Измените">Edit делает одну карточку редактируемой на месте; завершите через Save или shortcut.</Step>
  <Step title="Удалите">`⋯` → Delete → подтверждение.</Step>
</Steps>

<Warning>Delete навсегда удаляет файл с диска, минуя Trash; undo нет.</Warning>

### Возможности редактора

Это простой Markdown source editor. Toolbar имеет ровно пять действий:

| Кнопка                   | Действие                                 |
| ------------------------ | ---------------------------------------- |
| Bold                     | Оборачивает в `**`                       |
| Strikethrough            | Оборачивает в `~~`                       |
| Bulleted / Numbered list | Превращает выбранные строки в `-` / `1.` |
| Insert tag               | Вставляет `#` и открывает autocomplete   |

Кнопок italics, headings, links или code нет намеренно. Enter внутри списка продолжает его. После save карточка рендерит Markdown.

<Warning>**Autosave нет.** Draft переживает переход Chat/Notes, но теряется при выходе из приложения. Сохраняйте `⌘/Ctrl+Enter`.</Warning>

В reading mode remote images не загружаются: показывается placeholder с alt text, чтобы внешний server не узнал о чтении. UI не ограничивает длину, backend — 10 MiB на Note.

## Теги

Тег задаётся только встроенным `#tag` в теле; отдельного поля нет. При `#` появляется до восьми вариантов, ↑↓ перемещают, Enter выбирает. После save теги показываются strip под карточкой и кликом фильтруют timeline.

Допустимы вложенные `projects/client-a`; до 50 тегов по 1–64 символа. Чтобы удалить тег, удалите `#tag` из тела: тело — единственный источник истины.

## Поиск заметок

### Временная шкала и сортировка

Timeline — плоский поток без группировки дат: старые сверху, новые снизу; загружается по 20, прокрутка вверх предлагает более ранние. Sort: Newest created (default, newest last), Oldest created, Recently edited. Выбор действует только в текущем сеансе.

### Поиск

`⌘/Ctrl+F` или magnifier запускает hybrid full-text/semantic search (до готовности semantic — keyword-only). Максимум 20 результатов без пагинации; сначала tag filter помогает сузить. Запрос debounce примерно 0,3 секунды. Launcher и ИИ тоже находят Notes. В CLI:

```bash theme={null}
linkly list --scope notes
linkly list --scope notes --tags project,urgent
linkly search "решение по API" --scope notes
```

Timeline/tag filter сканируют filesystem и показывают Note сразу; search и tag autocomplete зависят от индекса и задерживаются. Это нормальные разные data paths, а не потеря записи.

## Где хранятся заметки

```text theme={null}
~/LinklyAI/
└── Notes/
    └── YYYY-MM/
        └── <первые 10 символов>-<8 символов id>.md
```

Месяц вычисляется в UTC, поэтому на границе месяца папка может отличаться от локальной даты. Корень зависит от [Linkly AI Space](/docs/ru/linkly-space).

### Имена и формат

Stem — первые 10 Unicode-символов тела: whitespace сжимается, запрещённые `/ \ : * ? " < > |` удаляются и не считаются. Если stem пуст или равен Windows device name вроде `CON`/`NUL`, используется `YYYY-MM-DD-HHMMSS-<id>.md`. Имя фиксируется при создании и больше не меняется.

```markdown theme={null}
---
note_id: 91805137-c3f8-4bc9-8db4-e7e8d99409bc
created_at: 2026-07-28T08:02:21.095Z
updated_at: 2026-07-28T08:05:33.709Z
source: user
updated_by: user
tags:
  - test
---

**Launch checklist**

- Website copy finalized

#test
```

`source`/`updated_by` равны `user` или `agent`; AI-файл также имеет `agent` и `updated_by_agent` (`linkly-chatbot` или `external-mcp`). Порядок полей фиксирован, неизвестные пользовательские YAML-поля сохраняются.

## Другой редактор

Кнопка **Open notes folder** открывает каталог. Obsidian, VS Code и Typora читают формат; Obsidian понимает `tags:`. External changes подхватываются при scan. Если тот же Note редактируется в приложении, conflict dialog предлагает **Reload latest** или **Copy my text**, не перезаписывая молча. Файлы можно переименовывать.

<Warning>Timeline видит только `.md` в структуре `Notes/YYYY-MM/`; файлы в корне или `Notes/archive/` всё ещё индексируются, но не показываются как карточки. Без YAML header файл тоже останется searchable, но перестанет считаться Note.</Warning>

## Заметки через ИИ

ИИ может `note_save` и `list` через MCP либо `note-save` / `list --scope notes` в CLI, только по вашему явному запросу:

```bash theme={null}
linkly note-save --mode create --content "Не забыть обновить сертификат" --tags ops
```

* Edit требует `note_id` и прочитанную `version`; конкурентная правка даёт `NOTE_VERSION_CONFLICT`, а не overwrite
* AI-разметка ограничена абзацами, bold, strikethrough и списками; headings, italics, code, links, images и tables отклоняются. Ручной UI не имеет этого backend-ограничения
* Delete tool отсутствует
* Remote gateway только проксирует на Desktop; cloud copy Notes не хранится, нужен включённый компьютер и Pro
* Desktop 0.11.0+: tags берутся из body, параметр только добавляет tokens; удаление — убрать `#tag`

После MCP save переключитесь Chat → Notes, если карточка ещё не обновилась.

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

<AccordionGroup>
  <Accordion title="Notes синхронизируются в облако?">Специальной sync нет. Но если Notes включены в библиотеку, которую вы Push в cloud, они загрузятся как Markdown. Для строго локального хранения не добавляйте их туда.</Accordion>
  <Accordion title="⌘⇧N ничего не делает">Chatbot должен быть в foreground/focus; shortcut не глобальный.</Accordion>
  <Accordion title="Почему новая Note не находится?">Timeline читает filesystem сразу, а search/tag autocomplete ждут index. Запись не потеряна.</Accordion>
  <Accordion title="Можно pin, favorite, archive или export?">Пока нет. Export не нужен: скопируйте `.md`. Перенос файла для archive уберёт его из timeline.</Accordion>
  <Accordion title="Не могу изменить tags старой AI Note">До 0.11.0 tags могли быть только в YAML. Следующая AI edit добавит body tokens автоматически, либо добавьте `#tags` вручную и сохраните.</Accordion>
  <Accordion title="Удаление обратимо?">Нет. Файл удаляется с диска без Trash и undo; сначала сделайте backup.</Accordion>
  <Accordion title="Notes входят в document count библиотеки?">Да, это обычные индексируемые Markdown-файлы.</Accordion>
</AccordionGroup>

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

* [Linkly AI Space](/docs/ru/linkly-space)
* [Справочник инструментов](/docs/ru/tools-intro)
* [Библиотеки](/docs/ru/use-libraries)