From 3ecec25fcea87e6206a72cfed9b83f420fb420f55334c96411ceed6777ed2422 Mon Sep 17 00:00:00 2001 From: AidarKC Date: Sun, 15 Nov 2026 02:24:15 +0300 Subject: [PATCH] =?UTF-8?q?=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D0=BE=D1=82=D0=BE=D0=B1=D1=80=D0=B0=D0=B6=D0=B5?= =?UTF-8?q?=D0=BD=D0=B8=D0=B5=20=D0=BF=D1=83=D0=B1=D0=BB=D0=B8=D1=87=D0=BD?= =?UTF-8?q?=D1=8B=D1=85=20=D0=BC=D0=B5=D0=B4=D0=B8=D0=B0-=D0=B2=D0=BB?= =?UTF-8?q?=D0=BE=D0=B6=D0=B5=D0=BD=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Добавить предпросмотр изображений и видео из R2 и Arweave; неподдерживаемые форматы оставить доступными как файлы. --- VERSION.properties | 2 +- docs/Blockchain/15_TEXT_Attachments.md | 40 +++-- shine-UI/js/components/media-viewer.js | 2 +- shine-UI/js/services/attachment-format.js | 69 ++++++-- shine-UI/styles/components/attachments.css | 14 ++ .../public-attachment-inline-media.test.mjs | 154 ++++++++++++++++++ 6 files changed, 247 insertions(+), 34 deletions(-) create mode 100644 shine-UI/tests/public-attachment-inline-media.test.mjs diff --git a/VERSION.properties b/VERSION.properties index f0e16276..0df82adb 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.20.40 +client.version=1.20.41 server.version=1.16.23 diff --git a/docs/Blockchain/15_TEXT_Attachments.md b/docs/Blockchain/15_TEXT_Attachments.md index 71860608..a0f54c7c 100644 --- a/docs/Blockchain/15_TEXT_Attachments.md +++ b/docs/Blockchain/15_TEXT_Attachments.md @@ -46,18 +46,20 @@ Public file на сервере доступа автора: - `v=1` - версия формата attach-блока; - `nm` - имя файла, закодированное через `encodeURIComponent`; - `sz` - размер файла в байтах; -- `sha256` - SHA-256 исходного файла в hex, 64 символа. +- один из идентификаторов файла: `pr` — pieces root BitTorrent v2 (base64url, 43 символа) для новых вложений; `sha256` — hex SHA-256 (64 символа) для совместимости со старыми. -Опциональное поле: +Опциональные поля: -- `ar` - короткий Arweave Transaction ID, 43 символа, без gateway URL. +- `ar` - короткий Arweave Transaction ID, 43 символа, без gateway URL; +- `mm` - MIME типа `image/jpeg` или `video/mp4`; если отсутствует, UI использует расширение `nm`. -Источник определяется только наличием `ar`: +Источник определяется следующим образом: - `ar` присутствует -> Arweave; -- `ar` отсутствует -> public file текущего сервера доступа автора. +- `ar` отсутствует, но есть `pr` -> публичный Cloudflare R2 (`https://files.shineup.me/`); +- `ar` и `pr` отсутствуют, есть `sha256` -> старое файловое хранилище сервера доступа автора. -Адрес сервера доступа, URL файла и login автора в attach-блок не записываются: автор уже известен из подписанного блока, а актуальный сервер доступа определяется отдельно. +Адрес сервера автора, URL файла и login автора в attach-блок не записываются: автор уже известен из подписанного блока. Старые файлы разрешаются через сервер доступа, новые R2 — по `pr`. ## Preview @@ -75,23 +77,25 @@ Public file на сервере доступа автора: Если присутствует `ar`, файл читается через настроенный Arweave gateway по указанному `txId`. -### Сервер доступа +### Cloudflare R2 (новые публичные файлы) -Если `ar` отсутствует, клиент: +Если `ar` отсутствует и указан `pr`, клиент использует прямой адрес `https://files.shineup.me/`. Браузер запрашивает исходное медиа напрямую; сервер Java в отдаче файла не участвует. При видео браузер может запрашивать только метаданные и нужные фрагменты через HTTP Range. + +### Сервер доступа (старые вложения с SHA-256) + +Если `ar` и `pr` отсутствуют, клиент: 1. определяет текущий сервер доступа автора сообщения; 2. запрашивает файл по стандартному пути `/files/`; -3. при необходимости проверяет полученные байты по `sha256` из блока. - -Физическое хранилище сервера является content-addressed: один и тот же SHA-256 должен соответствовать одному набору байтов. Это позволяет дедуплицировать одинаковые файлы разных пользователей. +3. использует прежний формат ссылок для совместимости с существующими сообщениями. URL или домен конкретного сервера в блокчейн не записывается. Поэтому смена сервера доступа не требует изменения старых сообщений. ## Создание вложения в UI -UI предлагает два способа хранения: `Сервер доступа` и `Arweave`. По умолчанию выбран сервер доступа. Отдельные preview-файлы не создаются. +UI предлагает два способа хранения публичных вложений: `Cloudflare R2` (через пункт сервера доступа) и `Arweave`. Отдельные preview-файлы не создаются. -После успешной загрузки на сервер доступа формируется тот же `S:att v=1`, но без поля `ar`. Для Arweave используется существующий механизм Arweave/Turbo и добавляется `ar`. +После загрузки в R2 формируется `S:att v=1` с `pr` и `mm`, без `ar`. Для Arweave используется механизм Arweave/Turbo; дополнительно записывается `ar`. Журнал загрузок Arweave хранится только в `sessionStorage` текущего браузера и не является частью блокчейна. @@ -102,8 +106,8 @@ UI предлагает два способа хранения: `Сервер д 1. читает валидные attach-блоки только из начала текста; 2. скрывает технические attach-строки; 3. определяет источник по наличию `ar`; -4. получает Arweave-файл по `txId` либо server-файл по `/files/` текущего сервера доступа автора; -5. определяет тип вложения по расширению `nm`; +4. получает Arweave-файл по `txId`, R2-файл по `pr` либо старый server-файл по `/files/`; +5. определяет тип вложения по `mm` (если указан), иначе по расширению `nm`; 6. изображение отображает из исходного файла; 7. видео отображает из исходного файла и открывает HTML5-плеер; 8. обычный файл показывает как карточку с именем, размером и скачиванием; @@ -117,12 +121,12 @@ UI предлагает два способа хранения: `Сервер д ## Совместимость и ограничения - полный URL в поле `ar` не используется; -- MIME type не записывается, тип UI определяется по расширению `nm`; +- для старых `sha256`-вложений MIME не записывался, тип UI определяется по расширению `nm`; - старые текстовые префиксы `` и `` могут продолжать читаться как совместимые формы; - отдельные preview-поля не входят в текущий протокол; -- MIME type, width, height, duration и thumbnail не записываются в блокчейн отдельными полями. +- `width`, `height`, `duration` и `thumbnail` не записываются отдельными полями; новые вложения могут содержать `mm` (MIME). ## MVP R2 (2026-11): новые публичные вложения -Для **новых** публичных вложений использовать ``; при загрузке в Arweave добавляется `;ar=TXID`. `pr` — 32-байтный BitTorrent v2 pieces root в base64url без padding (43 символа), а не SHA-256 файла. `mm` необязателен; отсутствие означает `application/octet-stream`. Новое публичное вложение без `ar` скачивается с `https://files.shineup.me/`. `storage=r2` отсутствует. Новые аватары **не изменяются**: SHA-256 и старый API `/files/` остаются. Существующий формат чтения `sha256` оставлен для ранее созданных данных и уже загруженных транзакций Arweave. Предпросмотр изображений и видео **публичных вложений** в MVP отключён (файловая карточка); UI личных зашифрованных файлов не изменяется. +Для **новых** публичных вложений использовать ``; при загрузке в Arweave добавляется `;ar=TXID`. `pr` — 32-байтный BitTorrent v2 pieces root в base64url без padding (43 символа), а не SHA-256 файла. `mm` необязателен; отсутствие означает `application/octet-stream`. Новое публичное вложение без `ar` скачивается с `https://files.shineup.me/`. `storage=r2` отсутствует. Новые аватары **не изменяются**: SHA-256 и старый API `/files/` остаются. Существующий формат чтения `sha256` оставлен для ранее созданных данных и уже загруженных транзакций Arweave. Публичные изображения и видео показываются внутри сообщения из исходного файла (`` / `