# Личные сообщения SHiNE Эта папка содержит актуальную документацию по личным сообщениям SHiNE. Точка входа: - `docs/Personal_Messages/Протокол_DM_v1.md` — логика протокола, роли API, серверное поведение, routing по `access_servers` - `docs/Personal_Messages/Формат_DM_v1.md` — точный бинарный формат контейнера `SHiNE_DM` - `docs/Personal_Messages/Доставка_и_синхронизация_DM.md` — доставка на единственный access-сервер, retry-воркер и UI-статусы - `docs/Personal_Messages/Технические_вставки_DM_v1.md` — формат специальных `` вставок внутри plaintext DM после расшифровки - `docs/Personal_Messages/Файлы_DM_v2.md` — большие chunked-вложения, голосовые и BitTorrent v2 SHA-256/Merkle metadata - `docs/API/18_DM_File_Storage_API.md` — HTTP-хранилище зашифрованных файлов DM на access-сервере отправителя Документы с версиями `v1` и `v2` описывают разные уровни: `v1` — контейнер и доставка сообщения, `v2` — формат больших файлов внутри зашифрованного содержимого DM. Реализация `v2` находится в `shine-UI/js/services/dm-file-service.js` и `dm-tech-blocks.js`. Правило сопровождения: - код DM и затронутые документы из списка выше должны обновляться синхронно; если байтовый контейнер не менялся, это нужно прямо указать в описании изменения; - если меняется поведение DM в коде, в том же наборе изменений обновляется и эта документация. - локальная таблица пользователей для DM считается кэшем, а источником истины остаётся Solana PDA; если серверная логика DM меняет правила lazy-import пользователей из PDA, это тоже обязательно фиксируется в документации. ## Зашифрованные файлы DM Официальный UI v1 умеет отправлять файл как внешний зашифрованный объект: - файл шифруется в браузере `AES-256-GCM`; - ciphertext хранится только на access-сервере отправителя под именем `Base58(SHA-256(ciphertext))`; - AES-key, IV, исходное имя, MIME, размер и URL находятся в `` внутри plaintext DM, а значит сами защищены существующим E2EE DM; - получатель скачивает ciphertext с сервера отправителя, проверяет SHA-256, расшифровывает локально и только затем отдаёт Blob браузеру для сохранения под исходным именем; - сервер файлов ключ расшифрования не получает. Формат бинарного контейнера `SHiNE_DM` при этом не меняется. ### Key rotation и локальный архив DM При смене client key старые `type=1/2` локальные копии перешифровываются клиентом пакетами. Критерий незавершённой миграции — локальная копия была сохранена до cutoff входа в `MESSAGE_MIGRATION` и имеет `reencryptedAtMs < cutoff`. Повторная отправка на сервер собеседника не выполняется. Для перешифрованного входящего `type=1` подпись принадлежит получателю; это локальная мигрированная копия, а не сохранённая подпись первоначального отправителя. ### Клавиатура личной переписки Обычный `Enter` в поле ввода личного сообщения отправляет непустой текст через существующий обработчик формы (включая ответы и редактирование); `Shift+Enter`, `Ctrl+Enter`, `Alt+Enter` и `Meta+Enter` вставляют перенос строки. Во время композиции IME отправка по Enter отключена. Это изменение относится только к UI; формат контейнера `SHiNE_DM` и серверный API не изменяются.