Files
SHiNE-server/docs/Personal_Messages/README.md
T

76 lines
9.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Личные сообщения 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` — формат специальных `<S:...>` вставок внутри plaintext DM после расшифровки
- `docs/Personal_Messages/Файлы_DM_v2.md` — старый формат chunked-вложений с BitTorrent v2 (только чтение);
- `docs/Personal_Messages/Файлы_DM_v3_R2.md` — **новые** chunked-вложения и голосовые в Cloudflare R2, AES-GCM, SHA-256/Base58
- `docs/API/18_DM_File_Storage_API.md` — HTTP-хранилище зашифрованных файлов DM на access-сервере отправителя
Документы с версиями `v1`, `v2` и `v3` описывают разные уровни: `v1` — контейнер и доставка сообщения, `v2` — старый формат больших файлов, `v3` — новые файлы в R2 без BitTorrent. Клиентская реализация находится в `shine-UI/js/services/dm-file-service.js` и `dm-tech-blocks.js`.
Правило сопровождения:
- код DM и затронутые документы из списка выше должны обновляться синхронно; если байтовый контейнер не менялся, это нужно прямо указать в описании изменения;
- если меняется поведение DM в коде, в том же наборе изменений обновляется и эта документация.
- локальная таблица пользователей для DM считается кэшем, а источником истины остаётся Solana PDA; если серверная логика DM меняет правила lazy-import пользователей из PDA, это тоже обязательно фиксируется в документации.
## Зашифрованные файлы DM
Официальный UI v3 отправляет файл как зашифрованные объекты R2 (чтение старого v1/v2 поддерживается):
- файл шифруется в браузере `AES-256-GCM`;
- новый ciphertext хранится в корзине `shine-dm` по адресу `https://dm-files.<домен access-сервера отправителя>/<Base58(SHA-256(ciphertext))>`;
- AES-key, IV, ID ciphertext, исходное имя, MIME и размер находятся в `<S:file...>` (новые v3 без URL; старые URL читаются) внутри plaintext DM, а значит сами защищены существующим E2EE DM;
- получатель скачивает новый ciphertext напрямую из R2, проверяет 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 не изменяются.
## Информационное сообщение о шифровании в начале DM (13.11.2026)
Экран `shine-UI/js/pages/chat-view.js` добавляет в самое начало визуальной ленты каждого личного диалога серое пояснение по центру о сквозном шифровании, ключах, открытом коде и последствиях потери пароля. Текст локализован для RU/EN через `screens.chat_view.security_notice.*`, стили — в `shine-UI/styles/features/chat.css`.
Сообщение создаётся локально при отрисовке диалога и повторно добавляется при обновлении истории. Это **не DM-сообщение**, оно не отправляется собеседнику, не попадает в `GetDirectMessages`, не подписывается и не записывается в Arweave или блокчейн. Кнопок, галочек и обязательного подтверждения нет. Изменения не затрагивают бинарный формат `SHiNE_DM`, серверный API и криптографический протокол.
Текст о перешифровке в интерфейсе воспроизводит утверждённую пользователем формулировку. Техническое ограничение: текущий протокол при ротации client key перешифровывает локальные копии `type=1/2` на access-сервере владельца, а не гарантирует перешифровку всех когда-либо созданных копий сообщения (подробности — в `Протокол_DM_v1.md`). Перед публичным релизом желательно уточнить формулировку на уровне продукта.
### Федеративный файловый resolver (16.11.2026)
Новые вложения DM v3 не сохраняют полный URL в E2EE-технической вставке; адрес
`dm-files.<access-домен>` восстанавливается по отправителю через общий HTTP API
и RAM-кэш. У каждого access-сервера своя корзина R2. Время загрузки `at` позволяет
показывать окончание 14-дневного срока без скачивания; старые v1/v2 сохраняют
прежний протокол и правила хранения. Подробнее в `Файлы_DM_v3_R2.md` и
`docs/API/18_DM_File_Storage_API.md`.
### Вложения и запись голосового в UI (17.11.2026)
В личной переписке выбранные файлы остаются в очереди у поля ввода: можно
дописать подпись, убрать файл и отправить всё одним сообщением. Текст
показывается под вложением. У вложений DM v3
показывается оставшийся срок хранения на основе `at` (14 дней). Запись
голосового начинается при нажатии микрофона: короткое нажатие закрепляет запись,
удержание с отпусканием отправляет, движение вверх закрепляет, влево отменяет.
В закреплённом режиме доступны пауза/продолжение, отправка и отмена. Текст в
поле ввода переключает кнопку микрофона в кнопку отправки текста.
HTTP resolver `/api/files/user-server` обязан возвращать JSON через Jetty,
поэтому Caddy должен направлять этот путь до SPA fallback. Если маршрута нет,
клиент показывает ошибку каталога серверов без вывода HTML в интерфейс.
Бинарный контейнер `SHiNE_DM` и серверный API этим изменением не меняются.