Личные сообщения: - поиск по переписке с подсветкой, переход к дате по календарю; - экран «Медиа и файлы» (/chat/<login>/media); - «без звука» и закрепление чатов (на устройстве), push от заглушённых не показывается; - новая нижняя панель ввода, круглый спиннер истории, медиа-карусель; - история загружается в ~16 раз быстрее: ключ расшифровки достаётся один раз на страницу; - исправлены прозрачные окна подтверждения в чате. Связи: - карта переписана на canvas (graph-canvas.js вместо force-graph.js): плавная анимация без дёрганья, панорама, масштаб щипком/колесом/кнопками, перетаскивание людей; - ручная раскладка и режимы «По близости»/«По группам» запоминаются на устройстве; - цвет нити – тип связи, пунктир – связь с одной стороны, аура только у сияющих; - карточка человека: раскрыть связи на месте, в центр, профиль, написать, заметка; - «Недавние» заменены раскрытием связей; фильтр «Заметки». Личные заметки о людях (текст и цветная метка, только на устройстве) – на карте и в профиле.
23 KiB
Протокол личных сообщений SHiNE DM v1
1. Статус документа
Это актуальная спецификация логики личных сообщений. Точный байтовый формат контейнера описан в Формат_DM_v1.md, а расписание доставки — в Доставка_и_синхронизация_DM.md.
Формат SHiNE_DM не изменён переходом на один access-сервер.
2. Инварианты
- каждый DM-контейнер подписан clientKey автора;
- сервер проверяет формат, пользователей и подпись до сохранения;
- повторная доставка одной ревизии идемпотентна;
- более старая ревизия не заменяет новую;
- PDA 1.2 допускает максимум один access server; если он задан, используется единственная запись;
- старые PDA 1.0 не участвуют в текущем runtime-протоколе;
- DM и настройки не реплицируются между access-серверами одного пользователя;
- пользовательские blockchain синхронизируются через Arweave;
sync_serversв PDA 1.2 отсутствует.
3. Типы DM
- type=1 — входящая копия сообщения для получателя;
- type=2 — исходящая копия сообщения для отправителя;
- type=3 — входящий read-receipt;
- type=4 — исходящая копия read-receipt;
- type=5 — удаление своего исходящего сообщения;
- type=6 — удаление входящего сообщения получателем;
- type=7 — удаление переписки отправителем;
- type=8 — удаление переписки получателем.
Входящая и исходящая копии являются частями криптографического формата, а не серверной репликацией. Они остаются даже при единственном access-сервере.
4. Создание сообщения
Клиент:
- получает актуальные clientKey отправителя и получателя;
- шифрует входящую копию на ключ получателя;
- шифрует исходящую копию на ключ отправителя;
- создаёт два связанных контейнера с общим baseKey;
- подписывает оба контейнера clientKey отправителя;
- вызывает SendMessagePair на своём access-сервере.
Сервер отправителя атомарно сохраняет пару. Исходящая копия доступна отправителю, а входящая хранится для доставки и повторных попыток.
5. Единственный сервер доступа
Пользовательская PDA по-прежнему содержит массив access_servers для совместимости формата. Действующим считается только первый элемент массива.
Routing-проекция user_access_servers_current содержит не более одной строки на пользователя и строится строго из элемента с ord=1.
Если первый элемент отсутствует, указывает не на server-PDA или server_address пуст, маршрут считается отсутствующим. Второй элемент автоматически не используется.
UI позволяет:
- увидеть текущий сервер;
- заменить его другим сервером;
- записать только один логин в access_servers.
Смена сервера не переносит сообщения и настройки. Новый сервер начинает с пустой локальной истории.
6. Доставка сообщения
6.1. SendMessagePair
Официальный UI отправляет пару только через SendMessagePair.
Сервер:
- проверяет оба контейнера и их связь;
- сохраняет пару;
- создаёт delivery-state;
- до ответа UI выполняет первую попытку доставки;
- возвращает baseKey, incomingKey, outgoingKey и deliveryState.
ReceiveOutcomingMessage удалён.
6.2. ReceiveIncomingMessage
Эта операция остаётся внутренней server-to-server операцией. Она нужна, когда отправитель и получатель используют разные физические серверы.
Сервер отправителя передаёт только incomingBlobB64 на единственный сервер получателя. Принимающий сервер:
- разрешает получателя через свою routing-проекцию;
- заново проверяет пользовательскую подпись;
- применяет входящую копию идемпотентно;
- обновляет диалог и realtime-сессии;
- возвращает успешный ответ только после сохранения.
ReceiveIncomingMessage не реплицирует историю на второй сервер пользователя.
7. Повторная доставка
Состояния:
- accepted — пара сохранена сервером отправителя;
- delivered — incoming-копия сохранена сервером получателя;
- failed — закончилась финальная попытка;
- read — подтверждается отдельным type=3/4.
Попытки выполняются сразу, через 30 секунд, 5 минут, 25 минут и 1 час. Перед каждой попыткой первый маршрут получателя читается заново.
Peer отправителя не получает полную пару и не опрашивается о состоянии. DmSyncBatch и GetDmDeliveryStatus удалены.
8. Чтение и realtime
GetDirectMessages возвращает историю страницами. UI использует стабильные messageKey/baseKey для дедупликации и отображает более новую ревизию.
dm_dialog_state хранит:
- последнюю контентную копию;
- время и ключ последнего сообщения;
- unreadCount;
- watermark прочтения.
WebSocket push ускоряет отображение, но после переподключения клиент запрашивает историю у своего единственного access-сервера.
UI-правило для открытого диалога: разделитель «Новые сообщения» относится только к непрочитанным сообщениям, которые уже существовали до открытия экрана чата. Если новое входящее сообщение приходит, пока этот диалог уже открыт, клиент просто добавляет его в текущий поток, не создавая новый разделитель «Новые сообщения»; затем обычный механизм видимого чтения/receipt отмечает его прочитанным.
9. Подтверждения прочтения
Read-receipt создаётся как подписанная пара type=3/type=4 и проходит тот же маршрут SendMessagePair → ReceiveIncomingMessage.
Сервер хранит наибольший известный watermark, поэтому переставленные или повторные receipts не уменьшают состояние прочтения.
10. Редактирование
Редактирование сохраняет логический messageKey исходной копии и увеличивает revisionTimeMs. Сервер принимает только более новую валидную ревизию.
Если доставка исходного сообщения ещё не завершилась, следующая попытка использует актуальную сохранённую incoming-копию.
11. Удаление
DeleteMessage принимает type=5/6. DeleteConversation принимает type=7/8.
Удаление является подписанным tombstone. Оно:
- проверяется как обычный DM-контейнер;
- применяется идемпотентно;
- удаляет или блокирует соответствующий локальный контент;
- доставляется только на единственные access-серверы обеих сторон.
Если сервер уже знает более новый tombstone, старая ревизия контента не восстанавливает удалённую историю.
12. Хранение
Основные таблицы:
- signed_messages — подписанные DM-контейнеры;
- dm_dialog_state — материализованный список диалогов;
- dm_delivery_state — изменяемое состояние сетевой доставки;
- user_access_servers_current — единственный действующий маршрут пользователя.
Удалены:
- dm_sync_outbox;
- dm_sync_peer_state;
- user_settings_sync_peer_state;
- synced-флаги репликации.
13. Границы текущей версии
- межсерверная авторизация ServerHello пока не подписана;
- sourceServerLogin не является криптографическим доказательством сервера;
- пользовательская подпись каждого SHiNE_DM проверяется независимо от транспорта;
- автоматической миграции истории при смене access-сервера нет;
- резервного fallback-сервера нет.
14. Сохранённые механизмы
Переход на один access-сервер не затрагивает:
- байтовый формат SHiNE_DM;
- шифрование входящей и исходящей копий;
- пользовательские подписи;
- deliveryState и retry-воркер;
- read-receipts;
- синхронизацию пользовательских блокчейнов через server-PDA sync_servers;
- общий постоянный WSS ServerConnectionPool.
UI списка личных чатов — фильтры и отображение времени (2026-08-28)
- Заголовок «Чаты» является переключателем фильтра списка.
- Доступные группы: «Все чаты», «Близкие друзья», «Контакты», «Новые».
- Фильтрация использует уже существующий признак отношения диалога:
close_friend,contact,none; формат DM и серверный протокол при этом не меняются. - Для недавних сообщений UI показывает относительное время (секунды, минуты, часы, дни). Для более старых сообщений текущего года используется формат
DD.MM, HH:MM, для другого года —DD.MM.YYYYбез времени.
Мультипрофильный клиент (UI, 2026-09-03)
- На одном устройстве клиент может хранить несколько авторизованных профилей, но одновременно использует только один активный runtime/WebSocket для DM.
- При переключении профиля новая сохранённая сессия сначала проверяется отдельным временным соединением. Текущий профиль не заменяется, если проверка неуспешна.
- Web Push может быть зарегистрирован для нескольких профилей на одном браузерном push endpoint. Поле
toLoginопределяет, какому профилю относится событие. - При клике по push-сообщению другого сохранённого профиля UI сначала спрашивает подтверждение переключения. Сам клик по системному уведомлению не является
read-receiptи не помечает DM прочитанным. - Локальный IndexedDB-кэш DM логически разделён по
ownerLogin, чтобы сообщения разных сохранённых профилей не смешивались.
UI: видимость пустого диалога после DeleteConversation
DeleteConversation (type=7/8) остаётся техническим tombstone и сам по себе не считается пользовательским сообщением диалога.
Для списка личных чатов действует правило:
- если после очистки истории у пары нет обычных DM-сообщений и пользователь не находится в
contact,friendилиclose_friend, строка диалога не показывается; - если связь
contact,friendилиclose_friendсохраняется, пустой чат может оставаться в списке как чат существующей связи; - при удалении чата с
friend/close_friendUI должен отдельно предупредить, что одна очистка истории не уберёт строку чата, и при подтверждении снять социальную связь и очистить историю.
Это правило не меняет wire/API-формат DM и не меняет байтовый формат tombstone.
UI чата: поиск, переход к дате, «Медиа и файлы», «без звука», закрепление (12.10.2026)
Всё ниже работает на клиенте и не меняет ни формат DM, ни серверный API.
- Поиск по переписке и календарь «перейти к дате» работают по расшифрованным сообщениям на устройстве. Если история загружена не целиком, клиент сам долистывает её обычным
GetDirectMessages(страницы по 50) до начала. Экран «Медиа и файлы» (/chat/<login>/media) делает то же самое и показывает фото и видео (<S:file...>до 20 МБ) сеткой, а остальные файлы списком. Голосовые в этот экран не попадают. - При разборе страницы истории ключ
clientKeyдостаётся из локального хранилища ключей один раз на страницу, а не для каждого сообщения. Сама расшифровка (X25519 + HKDF + AES-GCM) не меняется. - «Без звука» и «закреплён» – настройки этого устройства. Они хранятся в
localStorageотдельно для каждогоownerLogin, на сервер не передаются и с другими устройствами не синхронизируются. Для чата «без звука» входящее сообщение доставляется и считается непрочитанным как обычно, но клиент не проигрывает сигнал и не показывает системное уведомление. Список таких чатов дублируется в Cache Storage, чтобы service worker не показывал pushnew_messageот этого собеседника. Если в push нетtoLogin, проверяются списки всех профилей устройства. - Закреплённые чаты показываются в списке выше остальных, независимо от фильтра по типу связи. Последний закреплённый показывается первым.
15. Файлы в личных сообщениях
Файл не встраивается байтами в SHiNE_DM. До отправки DM официальный браузерный клиент:
- генерирует отдельные случайные
AES-256-GCMkey и IV; - шифрует исходный файл локально;
- вычисляет
fileId = Base58(SHA-256(ciphertext)); - подписанным HTTP
PUTзагружает ciphertext на свой текущий access-сервер; - отправляет обычный контентный DM
type=1/2, plaintext которого начинается с<S:file...>.
Внутри <S:file...> находятся fileId, абсолютный URL сервера отправителя, AES-key/IV и исходная метаинформация файла. Так как весь plaintext контентного DM уже шифруется на ключ получателя/отправителя, сервер не получает ключ файла.
Получатель после E2EE-расшифровки DM скачивает ciphertext непосредственно с указанного access-сервера отправителя, сверяет SHA-256, расшифровывает файл в браузере и сохраняет исходный файл.
Отключение функции «Передача файлов» в локальных дополнительных настройках запрещает только отправку новых файлов; ранее полученные <S:file...> остаются скачиваемыми.
Хранение ciphertext и HTTP-контракт описаны в docs/API/18_DM_File_Storage_API.md.
16. Дедупликация файлов и пересылка сообщений (2026-09-11)
Для HTTP-хранилища DM-файлов действует усиленное правило content-addressed хранения:
- перед загрузкой каждого ciphertext-объекта официальный UI делает
HEAD /dm-files/{fileId}; - если сервер подтверждает объект с тем же
fileIdи размером,PUTс байтами повторно не выполняется; - сервер перед ответом на
HEAD,GETи передalreadyExists=trueсам пересчитываетSHA-256сохранённого объекта и сверяет его сfileId; - повреждённый или подменённый объект не считается существующим и не выдаётся клиенту; при следующем корректном
PUTон может быть записан заново.
Пересылка личного сообщения не вводит новый тип DM и не добавляет признак «переслано». UI создаёт обычное новое контентное сообщение type=1/2 выбранному собеседнику:
- для обычного текста переносится отображаемый текст сообщения;
- исходный
<S:reply...>не переносится, поэтому новое сообщение не остаётся ответом на сообщение из старого чата; - для сообщения с файлами повторно используются существующие
<S:file...>-описатели, поэтому ciphertext не шифруется и не загружается повторно; - сервер и получатель видят пересланное сообщение как обычное новое сообщение без служебной пометки об источнике.
Перешифровка локального архива при смене client key (06.10.2026)
При key rotation сервер собеседника повторно не уведомляется. Меняются только локальные копии type=1 и type=2 на access-сервере владельца архива.
reencryptedAtMs=0 означает обычную исходную копию. При входе rotation в MESSAGE_MIGRATION её updatedAtMs фиксирует cutoff текущей миграции. Старые локальные копии, сохранённые до cutoff, получают reencryptedAtMs=cutoff. Следующая ротация использует уже свой новый cutoff.
Правило подписи type=1 зависит от reencryptedAtMs: исходная входящая копия (0) подписана отправителем; локально перешифрованная входящая копия (>0) подписывается новым client key получателя. type=2 остаётся подписанным владельцем исходящей локальной копии (fromLogin). Перешифрованная копия предназначена для локального восстановления содержимого новым client key и не считается сохранением первоначальной подписи отправителя.