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

Хранилище паролей

Зашифрованное хранилище логинов, паролей, адресов сайтов и личных заметок. Всё это лежит только на устройстве под мастер-паролем, а открытый текст существует в памяти ровно до тех пор, пока хранилище не заблокировано.

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

Возможности

  • Создание хранилища. При первом входе приложение просит придумать мастер-пароль. Ввести его нужно дважды, показывается счётчик символов.
  • Вход по мастер-паролю.
  • Вход по отпечатку. Кнопка с отпечатком в шапке появляется, когда биометрия уже включена для этого хранилища. Пункт «включить биометрию» в меню действий есть только на телефонах, которые её поддерживают.
  • Предложение включить биометрию сразу после создания хранилища. Мастер-пароль при этом остаётся запасным путём входа.
  • Добавление записи. Кнопка «плюс» в шапке открывает форму.
  • Поля записи: название, логин или почта, пароль, адрес сайта, личные заметки. Название — единственное обязательное.
  • Показ и скрытие пароля кнопкой прямо в поле.
  • Копирование пароля — и из карточки в списке, и из формы, и из генератора.
  • Генератор паролей. Ползунок длины и четыре переключателя наборов символов: заглавные, строчные, цифры, спецсимволы. Готовый пароль можно скопировать или сразу подставить в поле.
  • Поиск по названию, логину, адресу и заметкам.
  • Меню действий в шапке: выгрузить зашифрованную копию, загрузить копию, сменить мастер-пароль, включить или выключить биометрию, заблокировать сейчас.
  • Удаление записи с подтверждением. Удалённое восстановить нельзя.
  • Строка сообщений под шапкой: держится, пока её не закроют крестиком или пока не начнётся следующая операция. Сама не исчезает.

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

ПараметрЗначение
Минимальная длина мастер-пароля12 символов
Длина пароля генератора12…64, по умолчанию 20
Алгоритм шифрованияAES-256-GCM
Получение ключа из пароляPBKDF2-HMAC-SHA256, 600 000 итераций
Ключ данных32 байта, обёрнут паролем
Соль16 случайных байт
База записейзашифрована целиком, отдельно от конверта ключа
Автоблокировка5 минут бездействия
Очистка буфера обмена30 секунд
Требование к биометриитолько «сильная» биометрия
Что лежит на устройствебаза записей и файл с обёрнутым ключом
Пароли в чате агентане появляются

Три состояния экрана

Создание. Появляется только если хранилища ещё нет. Удалить хранилище из приложения нельзя, поэтому этот экран после первого создания не возвращается.

Заблокировано. Хранилище есть, но не открыто. Видны только ввод мастер-пароля и кнопка биометрии. Список записей при этом не подгружается вообще.

Открыто. Доступны поиск, список, добавление и меню действий.

Что значит «заблокировано»

Хранилище закрывается само через 5 минут, если по нему не трогали, при уходе в фон, при выходе с экрана и по кнопке «Lock now». В момент закрытия из памяти стирается ключ, а список записей очищается — на экране он не остаётся.

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

Бэкапы

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

Запись сопоставляется не по названию, а по внутреннему идентификатору. Если запись с тем же идентификатором уже есть и в копии она старее, текущая останется без изменений — обновление не перетрёт более новую запись.

Пока открыто системное окно выбора файла, хранилище намеренно не закрывается — иначе вход по биометрии сбрасывался бы на каждом выборе. Но если из этого окна отказаться, хранилище всё равно закроется.

Пароль и буфер обмена

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

Копировать стоит непосредственно перед вставкой: через полминуты при вставке будет уже пусто.

Скриншоты

Пока хранилище на экране, система запрещает снимки экрана и запись видео с экрана. Это относится и к экрану ввода пароля. Так задумано: пароли не должны попасть в галерею.

Что агент умеет

Агент может открыть этот экран через мост командой app_navigate на экран passwords — откроется экран входа.

Дальше ничего. Пока хранилище закрыто, мост не видит ни одной записи, а MCP инструмента для паролей не существует. Обойти это нельзя: пароли специально закрыты от агента, иначе секреты попали бы в переписку с моделью. Открыть хранилище за вас агент тоже не сможет — мастер-пароль вводит человек.

Ограничения

  • Восстановить мастер-пароль нельзя. Забытый пароль означает потерянные данные, и единственный путь — ранее выгруженная копия.
  • Хранилище живёт только на этом устройстве. Синхронизации между телефонами нет, перенос — только через файл копии.
  • Удалённую запись вернуть нельзя: истории изменений нет, есть только импорт копии.
  • При неверном мастер-пароле сообщение об ошибке техническое («Tag mismatch»), а не «неверный пароль»: непонятно, ошибся человек или файл повреждён.
  • Поиск не смотрит в поле пароля — только название, логин, адрес и заметки.
  • Генератор не даст пароль короче 12 символов и не сработает, если выключить все наборы символов: в этом случае он покажет подсказку вместо пароля.
  • На этом устройстве хранилище уже создано: экран открывается в состоянии «заблокировано», с включённым входом по отпечатку. Сколько в нём записей — видно только после входа.
  • Все тексты на экране английские.

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

Хранилище паролей Вернуться к справочнику