feat(export): platform-native delivery — TG popup+downloadFile, VK viewer, mobile share sheet
CI / changes (pull_request) Successful in 1s
CI / unit (pull_request) Successful in 10s
CI / integration (pull_request) Successful in 14s
CI / ui (pull_request) Failing after 1m7s
CI / conformance (pull_request) Successful in 9s
CI / gate (pull_request) Failing after 0s
CI / deploy (pull_request) Has been skipped

Per the on-device review, the last hop is now the most native affordance
per platform, all fed by the same signed URL:

- Telegram: the native showPopup chooser returns (safe here — the whole
  TG chain is bridge calls, which need no user activation) and both
  formats go to the native downloadFile dialog on iOS and Android alike.
- VK: the PNG opens in VK's native photo viewer (VKWebAppShowImages) —
  on screen at once, saved/shared from the viewer's own controls; the
  GCG keeps VKWebAppDownloadFile; either falls back to a plain anchor
  download (the desktop iframe). The gateway now serves /dl/* via
  http.ServeContent (Content-Length + Range/206) — another swing at the
  VK Android DownloadManager hang; if it persists, the next step is the
  clipboard fallback for the VK-Android GCG.
- Mobile browsers: the OS share sheet with the fetched file (the proven
  fetch-then-share pattern) — nothing lands in Downloads first; desktop
  keeps the anchor download.

Legacy Telegram (< 8.0, no downloadFile) keeps the app modal + GCG
clipboard copy and hides the image option.
This commit is contained in:
Ilia Denisov
2026-07-02 22:19:46 +02:00
parent c3c27bba5e
commit c3c26bbbc0
11 changed files with 189 additions and 60 deletions
+14 -11
View File
@@ -331,9 +331,10 @@ Telegram.
**двух форматах за одной кнопкой 📤** — файл GCG и отрисованная **PNG-картинка**
финальной позиции; экспорт доступен **только после завершения партии** и никогда —
для тренировочной партии с ИИ (экспорт идущей партии раскрыл бы журнал ходов, а
партия с ИИ одноразовая). Выбор формата — всегда **собственный модал** приложения,
сознательно не нативный попап Telegram: его коллбек приходит без user activation и
молча ломает доставку через share/буфер, к которой ведёт выбор.
партия с ИИ одноразовая). Выбор формата — **нативный попап Telegram** внутри
Telegram (там это безопасно: вся телеграмовская цепочка — bridge-вызовы, которым
user activation не нужна) и собственный модал приложения в остальных случаях (у VK
нативного чузера нет).
**Картинка** рендерится на сервере (внутренний рендер-сайдкар исполняет тот же
модуль отрисовки, что тестирует веб-клиент; всегда светлая тема): финальная
@@ -349,14 +350,16 @@ Telegram.
и дата завершения в локали устройства. Типографика таблицы фиксирована; длинная
партия растягивает доску (не ниже минимума), так что пустот на картинке нет.
Доставка — **один путь для обоих форматов на любой платформе**: приложение
запрашивает подписанную короткоживущую ссылку на скачивание и передаёт её родному
механизму платформы — диалогу загрузки Telegram, `VKWebAppDownloadFile` у VK или
обычному браузерному скачиванию файла в остальных случаях (включая десктопный
iframe VK). Ссылка не требует логина при скачивании (родные загрузчики платформ его
не несут), живёт минуты и отдаёт артефакт именованным файлом. Единственное
исключение — устаревший клиент Telegram без диалога загрузки (до Bot API 8.0): там
GCG откатывается на прежнее копирование в буфер (с подтверждающим тостом), а пункт
Доставка — **одна подписанная короткоживущая ссылка для обоих форматов на любой
платформе**, отданная самому родному механизму: диалог загрузки Telegram (обе
платформы TG; поделиться дальше — из телеграмовского превью файла); в VK картинка
открывается в **нативном просмотрщике фото VK** (сразу на экране — сохранение и
шаринг штатными кнопками просмотрщика), а GCG идёт через загрузку VK; **мобильный
браузер получает системную share-шторку** с файлом (ничего не оседает в Загрузках);
десктопный браузер скачивает файл. Ссылка не требует логина при скачивании (родные
загрузчики платформ его не несут) и живёт минуты. Единственное исключение —
устаревший клиент Telegram без диалога загрузки (до Bot API 8.0): там GCG
откатывается на прежнее копирование в буфер (с подтверждающим тостом), а пункт
«картинка» не предлагается. Статистика (только у постоянных аккаунтов):
победы, поражения, ничьи, макс. очков за партию и макс. очков за один ход (лучший
ход, уже включающий все образованные им слова и бонус за все фишки). Также