4.2 KiB
Вложения в TEXT-сообщениях (S:att;v=1)
Технический префикс в UTF-8 text для TEXT_POST, TEXT_REPLY, TEXT_EDIT_POST, TEXT_EDIT_REPLY. Бинарный формат TEXT не меняется. До 10 вложений в начале сообщения, затем обычный текст; порядок сохраняется.
Канонический формат (2026-11)
<S:att;v=1;nm=photo.jpg;sz=248193;pr=BASE58_ROOT;mm=image/jpeg>
<S:att;v=1;nm=video.mp4;sz=15000000;pr=BASE58_ROOT;mm=video/mp4;ar=TXID>
Текст публикации
v— версия (1).nm— имя файла вencodeURIComponent.sz— размер подготовленных байтов в десятичном виде.pr— BitTorrent v2 Pieces Root (32 байта), Base58, не SHA-256 целого файла; текущий стандарт новых вложений.mm— необязательный MIME, в форматеtype/subtype; неизвестный —application/octet-stream.ar— необязательный Arweave Transaction ID, нативный формат Arweave.sha256— исторический lowercase hex SHA-256 для старых тегов/объектов; новые записи его не создают.
ar присутствует → получить файл через Arweave gateway. Нет ar, есть pr → https://files.<домен access-сервера автора>/<pr>. Исторический sha256 без pr/ar → прежний /files/<sha256> access-сервера автора. storage=r2 и абсолютные URL в тег не записываются.
Идентификаторы новых аватаров — тоже Base58(PR), но формат аватара отдельный: <S:ava;v=2;sz=N;pr=ROOT[;ar=TXID]>. Формат v1/SHA-256 аватаров больше не создаётся; миграция v41 не конвертирует старые значения.
Отображение и безопасность
Клиент берёт тип по mm (при его наличии), иначе пытается использовать расширение nm. Для HTTP-открытия URL без расширения R2 также хранит Content-Type в метаданных объекта. Изображения загружаются loading="lazy"; публичные видео не получают src, пока не приблизились к экрану (IntersectionObserver с fallback). Встроенное отображение использует исходный файл, дополнительных preview-объектов нет.
HTML, SVG, XHTML, JavaScript, XML по расширению или MIME выводятся карточками с подтверждением перед переходом из UI. Пользователь может отменить открытие; прямые ссылки R2/Arweave обходят это предупреждение. Это не изменение доступа, криптографии или правила хранения и не даёт защиты от вредоносного содержимого на уровне HTTP.
Публичные вложения сохраняются на R2 либо в Arweave без автоматического удаления; DM-вложения используют отдельный протокол, см. docs/Personal_Messages/Файлы_DM_v3_R2.md. Редактирование текста сохраняет технические attach-блоки и не переносит объекты между хранилищами.
Совместимость
Парсер терпимо читает старое поле sha256 и префиксы <SHiNE:attach>/<S:attach>, если данные сохранились. Массовая миграция не выполняется. Экспериментальные preAr, preSha256, previewAr, previewSha256, width, duration, thumbnail не входят в протокол.