y83 code / справочник

Заметки

Блокнот для текста, списков дел и картинок. Всё, что вы пишете, лежит на телефоне и остаётся доступным без интернета, а любую заметку можно одним нажатием передать агенту в чат.

раздел
Подсистемы приложения
пунктов возможностей
24
источник
docs/about/notes.md

Возможности

  • Список заметок карточками: буква категории, категория, время изменения, число вложений и число слов — всё видно без открытия заметки.
  • Поиск по заголовку, тексту и именам файлов вложений — с подсветкой найденного куска прямо в карточке.
  • Фильтры: категория, тег, «только заметки с вложениями». Все фильтры включаются разом и сбрасываются одной кнопкой.
  • Сортировка: по изменению, по созданию или по названию. Выбранный вариант запоминается и остаётся при следующем открытии.
  • Закрепление заметки: закреплённые собираются в отдельной верхней секции и не тонут в общем списке.
  • Четыре категории: работа, личное, идеи, прочее.
  • Теги — обычные хэштеги прямо в тексте (#покупки). Список тегов собирается автоматически, самые частые сверху.
  • Редактор: заголовок, текст, категория, закрепление и панель внизу с кнопками «Фото», «Файл», «Чек-лист».
  • Чек-лист: пункт добавляется кнопкой, галочка переключается прямо в тексте и в режиме просмотра, а сделанный пункт там зачёркивается.
  • Вложения: фото из галереи или любой файл. Картинки показываются превью прямо в заметке, остальные файлы — иконкой, имя и размер видно всегда. Вложение можно открыть другим приложением или убрать.
  • Режим просмотра: текст заметки показывается уже разметкой — заголовками, списками, кодом, а чекбоксы в нём остаются нажимаемыми.
  • Счётчики в шапке редактора: слова, символы, файлы и отметка о сохранении.
  • Удаление свайпом влево по карточке, с полосой отмены внизу экрана. Второй способ — через меню заметки с подтверждением.
  • Копирование текста заметки в буфер и отправка в любое системное приложение (мессенджер, почта, заметки).
  • «Отправить агенту»: заметка уезжает в чат с агентом.
  • Экспорт всех заметок в один архив и импорт архива или одиночных файлов.
  • Автосохранение — закрывать редактор с незаписанным текстом не страшно.

Технические данные

ПараметрЗначение
Хранениеотдельный файл на заметку во внутренней памяти приложения
ФорматJSON с заголовком, текстом, категорией, датами, закреплением и вложениями
Вложенияотдельные файлы рядом с заметкой, до 5 МБ на файл
Автосохранениечерез 1,5 секунды после последней правки и при выходе с экрана
Категории4 штуки, подписи на английском: Work, Personal, Ideas, Other
Тегихэштеги от 2 до 24 символов, без дублей
Сортировка3 варианта, выбор запоминается
Экспортzip-архив с файлами .md и папкой вложений, имя с датой
Импортzip (до 200 заметок, файл до 8 МБ), .md, .markdown, .txt, .json
Удалениесначала можно отменить, потом файлы исчезают окончательно
Интернетне нужен, всё работает на телефоне

Как хранятся заметки

Заметки не лежат в общей базе приложения — каждая заметка это отдельный файл, а вложения лежат рядом в своей папке. Из этого следуют два практических вывода. Первый: обмена с облаком и синхронизации между устройствами нет — перенести заметки можно только архивом. Второй: файлы заметок находятся в закрытой папке приложения, обычные программы и агент туда не достанутся.

Экспорт и импорт

При экспорте каждая заметка превращается в текстовый файл .md с шапкой, где записаны идентификатор, заголовок, категория, закрепление, даты и теги; рядом складывается папка с вложениями. Такой архив можно открыть и прочитать в любом редакторе текста. Импорт всегда создаёт новые заметки с новыми внутренними именами — заголовок и текст берутся из файла, а записи на диске создаются заново. Существующие заметки не обновляются и не перезаписываются, поэтому импорт одного и того же архива дважды даст две копии. Непонятная категория в текстовом файле становится «Прочее», а если файл не читается или слишком большой, он пропускается. После импорта показывается, сколько заметок загрузилось и сколько пропущено.

Как отменяется удаление

Свайп по карточке не стирает заметку сразу: файл убирается, но вложения остаются, а внизу экрана появляется полоса с отменой. Если нажать отмену, заметка возвращается вместе с вложениями. Если полоса просто исчезла (например, вы ушли на другой экран), вложения удалённой заметки удаляются окончательно, а сама уже не вернётся.

Что агент умеет с заметками

Прямых инструментов нет

У агента нет ни одного инструмента для работы с заметками: он не видит список заметок, не может создать, изменить или удалить заметку. В его наборе команд нет ничего, что работало бы с блокнотом, а лежащие в закрытой папке приложения файлы заметок ему недоступны.

Как передать заметку агенту

В меню заметки есть пункт «Отправить агенту». Он открывает новый тред в чате и подставляет текст заметки в поле ввода — ничего не отправляется само, текст можно поправить и только потом нажать отправку. Если агент в списке один, открывается сразу его чат; если несколько — сначала выбираете, кому.

Если у заметки есть вложения, к тексту добавляется список их путей. Это подсказка для человека: сами файлы лежат в закрытой папке приложения, агент по этим путям их прочитать не сможет.

Что делать, если нужно обратно

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

Ограничения

  • Нет синхронизации, облака и версий: перенос только архивом.
  • Импорт не обновляет существующие заметки, а добавляет копии.
  • Файл крупнее 5 МБ не присоединится, и сообщения об отказе не будет.
  • Имена вложений приводятся к латинице, кириллица заменяется на подчёркивания.
  • Категории и счётчики подписаны по-английски.
  • Вложения удалённой заметки пропадают, как только полоса отмены исчезла.
  • Правки попадают в файл не сразу, а через 1,5 секунды после последнего нажатия. При выходе с экрана текст дописывается принудительно, но если приложение в эти полторы секунды убить из памяти, последние правки пропадут.

Источник: docs/about/notes.md. Страница собрана из документации проекта при сборке сайта — без пересказа.