chore: release 1.0.11

Co-authored-by: Cursor <cursoragent@cursor.com>

.gitea/workflows/release.yml

@@ -0,0 +1,150 @@
+# Сборка по тегу v* и выкладка в публичный репо (ветка updates).
+#
+# Метки runs-on = labels твоих act_runner (Админка Gitea → Действия → Раннеры).
+# Не используем windows-latest/macos-latest — это только GitHub-hosted.
+# По умолчанию: один job на ubuntu-22.04 — Win (Wine+NSIS), Linux AppImage (x64+arm64), sync в updates без затирания других ОС.
+#
+# Один job без actions/upload-artifact: официальный upload-artifact@v4 с GitHub на Gitea
+# падает (GHESNotSupportedError). Сборка и sync-update-feed идут в одном окружении.
+#
+# Secrets: DND_UPDATE_FEED_URL, DND_UPDATES_SERVER, UPDATES_REPO, DND_UPDATES_PUSH_TOKEN — docs/GITEA_AUTO_UPDATE.md
+
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+env:
+  CSC_IDENTITY_AUTO_DISCOVERY: 'false'
+
+jobs:
+  release:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      # Не включаем i386 / wine32: на Debian с репами только amd64 (nginx, sury, …)
+      # apt ломается на цепочке libgphoto2/libgd:i386. NSIS — нативный пакет `nsis`;
+      # electron-builder подхватывает makensis; wine64 — для win-утилит (rcedit и т.п.).
+      # Пакет `wine` (мета) тянет wine32 → снова i386. electron-builder ищет именно `wine` в PATH.
+      - name: Зависимости Win-сборки на Linux (amd64, без multiarch i386)
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
+            ca-certificates \
+            nsis \
+            wine64
+          export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
+          W64="$(command -v wine64 2>/dev/null || true)"
+          if [[ -z "$W64" || ! -x "$W64" ]]; then
+            for p in /usr/bin/wine64 /usr/lib/wine/wine64; do
+              if [[ -x "$p" ]]; then W64="$p"; break; fi
+            done
+          fi
+          if [[ -z "${W64:-}" || ! -x "$W64" ]]; then
+            echo "wine64 binary not found after apt install wine64" >&2
+            dpkg -L wine64 2>/dev/null | head -80 >&2 || true
+            exit 1
+          fi
+          printf '%s\n' '#!/bin/sh' "exec $W64 \"\$@\"" | sudo tee /usr/local/bin/wine >/dev/null
+          sudo chmod +x /usr/local/bin/wine
+          wine --version
+
+      - name: Версия из тега
+        shell: bash
+        run: |
+          TAG="${GITHUB_REF_NAME:-${GITEA_REF_NAME:-}}"
+          VERSION="${TAG#v}"
+          npm version "$VERSION" --allow-same-version --no-git-tag-version
+
+      - run: npm ci
+
+      - run: npm run build
+
+      # Linux AppImage (x64 + arm64) до подмешивания win32-sharp в node_modules.
+      - name: Зависимости Linux AppImage и кросс-сборка arm64 на amd64
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
+            qemu-user-static \
+            binfmt-support \
+            desktop-file-utils \
+            squashfs-tools
+
+      - name: electron-builder (linux AppImage x64, arm64)
+        shell: bash
+        env:
+          DND_UPDATE_FEED_URL: ${{ secrets.DND_UPDATE_FEED_URL }}
+        run: |
+          set -euo pipefail
+          if [[ -z "${DND_UPDATE_FEED_URL:-}" ]]; then
+            echo "Secret DND_UPDATE_FEED_URL is not set (URL со слэшем в конце)" >&2
+            exit 1
+          fi
+          npx electron-builder --linux AppImage --x64 --arm64 --publish never \
+            --config.publish.provider=generic \
+            --config.publish.url="${DND_UPDATE_FEED_URL}"
+
+      # Не используем `npm install`: на Linux npm падает с EBADPLATFORM для win32-пакета.
+      - name: sharp (@img/sharp-win32-x64) для Windows-артефакта при сборке на Linux
+        shell: bash
+        run: |
+          set -euo pipefail
+          tmp="$(mktemp -d)"
+          npm pack @img/sharp-win32-x64@0.34.5 --pack-destination "$tmp"
+          mkdir -p node_modules/@img/sharp-win32-x64
+          tar -xzf "$tmp/img-sharp-win32-x64-0.34.5.tgz" -C "$tmp"
+          cp -a "$tmp/package/." node_modules/@img/sharp-win32-x64/
+          test -f node_modules/@img/sharp-win32-x64/lib/sharp-win32-x64.node
+          rm -rf "$tmp"
+
+      - name: electron-builder (win)
+        shell: bash
+        env:
+          DND_UPDATE_FEED_URL: ${{ secrets.DND_UPDATE_FEED_URL }}
+        run: |
+          set -euo pipefail
+          if [[ -z "${DND_UPDATE_FEED_URL:-}" ]]; then
+            echo "Secret DND_UPDATE_FEED_URL is not set (URL со слэшем в конце)" >&2
+            exit 1
+          fi
+          npx electron-builder --win --publish never \
+            --config.publish.provider=generic \
+            --config.publish.url="${DND_UPDATE_FEED_URL}"
+
+      # Артефакты читает sync напрямую из release/ (без дублирующих _win/_linux — меньше ENOSPC).
+      - name: Пустой каталог mac (пока нет сборки mac в CI)
+        run: mkdir -p _mac
+
+      - name: Push в публичный репозиторий updates
+        shell: bash
+        env:
+          DND_UPDATES_SERVER: ${{ secrets.DND_UPDATES_SERVER }}
+          UPDATES_REPO: ${{ secrets.UPDATES_REPO }}
+          DND_UPDATES_PUSH_TOKEN: ${{ secrets.DND_UPDATES_PUSH_TOKEN }}
+          ARTIFACT_WIN: ${{ github.workspace }}/release
+          ARTIFACT_MAC: ${{ github.workspace }}/_mac
+          ARTIFACT_LINUX: ${{ github.workspace }}/release
+          DND_FEED_TMP_ROOT: ${{ github.workspace }}/.dnd-feed-tmp
+          DND_UPDATES_SQUASH_HISTORY: '1'
+          GIT_COMMIT_TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          mkdir -p "${{ github.workspace }}/.dnd-feed-tmp" "${{ github.workspace }}/_mac"
+          node scripts/sync-update-feed.mjs
+
+  # Когда появится macOS-раннер: отдельный job build-macos, копирование eb-mac в _mac перед sync
+  # или расширить шаг «Каталог артефактов»; сейчас всё в одном job `release`.
+  #
+  # build-macos:
+  #   runs-on: macos-14
+  #   steps: ...

app/main/index.ts

@@ -7,6 +7,7 @@ import { installIpcRouter, registerHandler, setLicenseAssert } from './ipc/route
 import { LicenseService } from './license/licenseService';
 import { ZipProjectStore } from './project/zipStore';
 import { registerDndAssetProtocol } from './protocol/dndAssetProtocol';
+import { installAutoUpdater } from './update/installAutoUpdater';
 import { getAppSemanticVersion, getOptionalBuildNumber } from './versionInfo';
 import { VideoPlaybackStore } from './video/videoPlaybackStore';
 import {
@@ -251,6 +252,7 @@ async function main() {
   registerHandler(ipcChannels.app.getVersion, () => ({
     version: getAppSemanticVersion(),
     buildNumber: getOptionalBuildNumber(),
+    packaged: app.isPackaged,
   }));
   registerHandler(ipcChannels.license.getStatus, () => licenseService.getStatus());
   registerHandler(ipcChannels.license.setToken, async ({ token }) => licenseService.setToken(token));
@@ -525,6 +527,7 @@ async function main() {
     return { ok: true };
   });
 
+  installAutoUpdater(licenseService, registerHandler);
   installIpcRouter();
   applyDockIconIfNeeded();
   await runStartupAfterHandlers(licenseService);

app/main/ipc/router.ts

@@ -36,6 +36,8 @@ export function registerHandler<K extends keyof IpcInvokeMap>(channel: K, handle
   handlers.set(channelStr, inner);
 }
 
+export type IpcRegisterHandler = typeof registerHandler;
+
 export function installIpcRouter(): void {
   for (const [channel, handler] of handlers.entries()) {
     ipcMain.handle(channel, async (_event, payload: unknown) => handler(payload));

app/main/license/licenseService.ts

@@ -17,6 +17,28 @@ type Preferences = {
   eulaAcceptedVersion?: number;
 };
 
+type LicenseChangeListener = () => void;
+
+const licenseChangeListeners = new Set<LicenseChangeListener>();
+
+/** Слушатели вызываются после смены состояния лицензии (сохранённый токен, EULA, отзыв). */
+export function addLicenseChangeListener(fn: LicenseChangeListener): () => void {
+  licenseChangeListeners.add(fn);
+  return () => {
+    licenseChangeListeners.delete(fn);
+  };
+}
+
+function notifyLicenseChangeListeners(): void {
+  for (const fn of licenseChangeListeners) {
+    try {
+      fn();
+    } catch (err) {
+      console.error('[license] change listener failed', err);
+    }
+  }
+}
+
 function readPreferences(userData: string): Preferences {
   try {
     const raw = fs.readFileSync(preferencesPath(userData), 'utf8');
@@ -35,6 +57,7 @@ function emitLicenseStatusChanged(): void {
   for (const win of BrowserWindow.getAllWindows()) {
     win.webContents.send(ipcChannels.license.statusChanged, {});
   }
+  notifyLicenseChangeListeners();
 }
 
 export class LicenseService {

app/main/update/installAutoUpdater.ts

@@ -0,0 +1,127 @@
+import { app, dialog } from 'electron';
+import { autoUpdater } from 'electron-updater';
+
+import {
+  ipcChannels,
+  type UpdaterCheckResponse,
+  type UpdaterDownloadResponse,
+} from '../../shared/ipc/contracts';
+import type { IpcRegisterHandler } from '../ipc/router';
+import { addLicenseChangeListener } from '../license/licenseService';
+import type { LicenseService } from '../license/licenseService';
+
+const STARTUP_CHECK_DELAY_MS = 12_000;
+/** Не дёргать сервер чаще (смена лицензии / повторные emit). */
+const RE_CHECK_COOLDOWN_MS = 30_000;
+
+let lastCheckAt = 0;
+/** Ручная установка: не показывать второй диалог из `update-downloaded`. */
+let suppressAutoInstallDialog = false;
+
+type RegisterFn = IpcRegisterHandler;
+
+function isLicensedForUpdates(licenseService: LicenseService): boolean {
+  const snap = licenseService.getStatusSync();
+  return snap.active;
+}
+
+function maybeCheckForUpdates(licenseService: LicenseService, ignoreCooldown: boolean): void {
+  if (!app.isPackaged) return;
+  if (!isLicensedForUpdates(licenseService)) return;
+  const now = Date.now();
+  if (!ignoreCooldown && now - lastCheckAt < RE_CHECK_COOLDOWN_MS) return;
+  lastCheckAt = now;
+  void autoUpdater.checkForUpdates().catch(() => undefined);
+}
+
+async function runManualUpdaterCheck(licenseService: LicenseService): Promise<UpdaterCheckResponse> {
+  if (!app.isPackaged) {
+    return { outcome: 'not_packaged' };
+  }
+  if (!isLicensedForUpdates(licenseService)) {
+    return { outcome: 'no_license' };
+  }
+  try {
+    const result = await autoUpdater.checkForUpdates();
+    if (result && result.isUpdateAvailable && result.updateInfo.version) {
+      return { outcome: 'available', version: result.updateInfo.version };
+    }
+    return { outcome: 'current', currentVersion: app.getVersion() };
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    return { outcome: 'error', message };
+  }
+}
+
+async function runManualDownloadAndRestart(): Promise<UpdaterDownloadResponse> {
+  if (!app.isPackaged) {
+    return { ok: false, message: 'NOT_PACKAGED' };
+  }
+  try {
+    suppressAutoInstallDialog = true;
+    await autoUpdater.downloadUpdate();
+    autoUpdater.quitAndInstall(false, true);
+    return { ok: true };
+  } catch (e) {
+    suppressAutoInstallDialog = false;
+    const message = e instanceof Error ? e.message : String(e);
+    return { ok: false, message };
+  }
+}
+
+function registerUpdaterHandlers(register: RegisterFn, licenseService: LicenseService): void {
+  register(ipcChannels.updater.check, () => runManualUpdaterCheck(licenseService));
+  register(ipcChannels.updater.downloadAndRestart, () => runManualDownloadAndRestart());
+}
+
+/**
+ * Проверка обновлений: только упакованное приложение, только при активной лицензии.
+ * Канал и URL задаются при сборке (`publish` → `app-update.yml` внутри установки).
+ */
+export function installAutoUpdater(licenseService: LicenseService, register: RegisterFn): void {
+  registerUpdaterHandlers(register, licenseService);
+
+  if (!app.isPackaged) return;
+
+  const feedOverride = process.env.DND_UPDATE_FEED_URL?.trim();
+  if (feedOverride) {
+    const url = feedOverride.endsWith('/') ? feedOverride : `${feedOverride}/`;
+    autoUpdater.setFeedURL({ provider: 'generic', url });
+  }
+
+  autoUpdater.autoDownload = true;
+  autoUpdater.autoInstallOnAppQuit = true;
+
+  autoUpdater.on('update-downloaded', (info) => {
+    if (suppressAutoInstallDialog) {
+      suppressAutoInstallDialog = false;
+      return;
+    }
+    void dialog
+      .showMessageBox({
+        type: 'info',
+        title: 'DNDGamePlayer',
+        message: `Доступна новая версия ${info.version}. Установить и перезапустить?`,
+        buttons: ['Перезапустить сейчас', 'Позже'],
+        defaultId: 0,
+        cancelId: 1,
+      })
+      .then((r) => {
+        if (r.response === 0) {
+          autoUpdater.quitAndInstall(false, true);
+        }
+      });
+  });
+
+  autoUpdater.on('error', () => {
+    /* без console: в production main минифицируется с drop console */
+  });
+
+  addLicenseChangeListener(() => {
+    maybeCheckForUpdates(licenseService, false);
+  });
+
+  setTimeout(() => {
+    maybeCheckForUpdates(licenseService, true);
+  }, STARTUP_CHECK_DELAY_MS);
+}

app/main/windows/bootWindow.ts

@@ -4,6 +4,8 @@ import { app, BrowserWindow } from 'electron';
 
 import { getAppSemanticVersion } from '../versionInfo';
 
+import { loadBrandingWindowIcon } from './brandingIcon';
+
 let bootSplashRef: BrowserWindow | null = null;
 
 export function getBootSplashWindow(): BrowserWindow | null {
@@ -37,6 +39,7 @@ function bootWebPreferences(): Electron.WebPreferences {
  * Показывать после `waitForBootWindowReady`.
  */
 export function createBootWindow(): BrowserWindow {
+  const icon = loadBrandingWindowIcon();
   const win = new BrowserWindow({
     width: 440,
     height: 420,
@@ -50,8 +53,16 @@ export function createBootWindow(): BrowserWindow {
     transparent: false,
     backgroundColor: '#09090B',
     roundedCorners: true,
+    ...(icon ? { icon } : {}),
     webPreferences: bootWebPreferences(),
   });
+  if (icon) {
+    try {
+      win.setIcon(icon);
+    } catch {
+      /* ignore */
+    }
+  }
 
   bootSplashRef = win;
   win.once('closed', () => {

app/main/windows/brandingIcon.ts

@@ -0,0 +1,114 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { app, nativeImage } from 'electron';
+
+let resolved = false;
+let cached: Electron.NativeImage | undefined;
+
+/** ICO рядом с exe (вне asar): надёжно для `nativeImage` / панели задач на Windows. */
+function getPackagedBrandingIcoPath(): string | undefined {
+  if (!app.isPackaged) return undefined;
+  const p = path.join(process.resourcesPath, 'branding', 'icon.ico');
+  try {
+    if (fs.existsSync(p)) return p;
+  } catch {
+    /* ignore */
+  }
+  return undefined;
+}
+
+function brandingPngPaths(): string[] {
+  const root = app.getAppPath();
+  const relPack = path.join('dist', 'renderer', 'app-pack-icon.png');
+  const relWindow = path.join('dist', 'renderer', 'app-window-icon.png');
+  const paths: string[] = [];
+  if (app.isPackaged) {
+    const unpacked = path.join(process.resourcesPath, 'app.asar.unpacked');
+    paths.push(path.join(unpacked, relPack), path.join(unpacked, relWindow));
+  }
+  paths.push(
+    path.join(root, relPack),
+    path.join(root, relWindow),
+    path.join(root, 'build', 'icon.png'),
+    path.join(root, 'app', 'renderer', 'public', 'app-window-icon.png'),
+  );
+  return paths;
+}
+
+function tryLoadImageFile(filePath: string): Electron.NativeImage | undefined {
+  try {
+    const buf = fs.readFileSync(filePath);
+    const fromBuf = nativeImage.createFromBuffer(buf);
+    if (!fromBuf.isEmpty()) return fromBuf;
+  } catch {
+    /* ignore */
+  }
+  try {
+    const fromPath = nativeImage.createFromPath(filePath);
+    if (!fromPath.isEmpty()) return fromPath;
+  } catch {
+    /* ignore */
+  }
+  return undefined;
+}
+
+function tryLoadSvgFile(filePath: string): Electron.NativeImage | undefined {
+  try {
+    const fromPath = nativeImage.createFromPath(filePath);
+    if (!fromPath.isEmpty()) return fromPath;
+  } catch {
+    /* ignore */
+  }
+  return undefined;
+}
+
+function tryDarwinSvgPaths(): Electron.NativeImage | undefined {
+  if (process.platform !== 'darwin') return undefined;
+  const root = app.getAppPath();
+  for (const p of [
+    path.join(root, 'dist', 'renderer', 'app-logo.svg'),
+    path.join(root, 'app', 'renderer', 'public', 'app-logo.svg'),
+  ]) {
+    if (!fs.existsSync(p)) continue;
+    const img = tryLoadSvgFile(p);
+    if (img) return img;
+  }
+  return undefined;
+}
+
+/**
+ * Иконка окна / дока. Сначала ICO из `extraResources` (реальный путь на диске), затем PNG
+ * через буфер — `createFromPath` к файлам внутри `app.asar` на Windows часто даёт пустой `NativeImage`.
+ */
+export function loadBrandingWindowIcon(): Electron.NativeImage | undefined {
+  if (resolved) return cached;
+  resolved = true;
+
+  const ico = getPackagedBrandingIcoPath();
+  if (ico) {
+    const img = tryLoadImageFile(ico);
+    if (img) {
+      cached = img;
+      return cached;
+    }
+  }
+
+  for (const p of brandingPngPaths()) {
+    if (!fs.existsSync(p)) continue;
+    const img = tryLoadImageFile(p);
+    if (img) {
+      cached = img;
+      return cached;
+    }
+  }
+
+  const svgIcon = tryDarwinSvgPaths();
+  if (svgIcon) {
+    cached = svgIcon;
+    return cached;
+  }
+
+  cached = undefined;
+  return undefined;
+}

app/main/windows/createWindows.editorClose.test.ts

@@ -22,10 +22,11 @@ void test('createWindows: закрытие редактора завершает
 
 void test('createWindows: иконка окна (pack PNG, затем window PNG; SVG только вне win32)', () => {
   const src = readCreateWindows();
-  assert.ok(src.includes('resolveWindowIconPath'));
+  assert.ok(src.includes('loadBrandingWindowIcon'));
-  assert.ok(src.includes('app-pack-icon.png'));
+  const branding = fs.readFileSync(path.join(here, 'brandingIcon.ts'), 'utf8');
-  assert.ok(src.includes('app-window-icon.png'));
+  assert.ok(branding.includes('app-pack-icon.png'));
-  assert.ok(src.includes('app-logo.svg'));
+  assert.ok(branding.includes('app-window-icon.png'));
+  assert.ok(branding.includes('tryDarwinSvgPaths'));
 });
 
 void test('createWindows: пульт поверх экрана просмотра (дочернее окно)', () => {

app/main/windows/createWindows.ts

@@ -1,11 +1,11 @@
-import fs from 'node:fs';
 import path from 'node:path';
 
-import { app, BrowserWindow, nativeImage, screen } from 'electron';
+import { app, BrowserWindow, screen } from 'electron';
 
 import { ipcChannels } from '../../shared/ipc/contracts';
 
 import { getBootSplashWindow } from './bootWindow';
+import { loadBrandingWindowIcon } from './brandingIcon';
 
 type WindowKind = 'editor' | 'presentation' | 'control';
 
@@ -13,6 +13,19 @@ const windows = new Map<WindowKind, BrowserWindow>();
 
 let appQuitting = false;
 
+/** Учитываем окна, которые уже уничтожены при каскадном закрытии (родитель → дочернее). */
+function broadcastMultiWindowStateChanged(open: boolean): void {
+  for (const w of BrowserWindow.getAllWindows()) {
+    if (w.isDestroyed()) continue;
+    if (w.webContents.isDestroyed()) continue;
+    try {
+      w.webContents.send(ipcChannels.windows.multiWindowStateChanged, { open });
+    } catch {
+      /* окно могло закрыться между проверкой и send */
+    }
+  }
+}
+
 /** Разрешает реальное закрытие окна редактора (выход из приложения). */
 export function markAppQuitting(): void {
   appQuitting = true;
@@ -56,82 +69,15 @@ function getPreloadPath(): string {
   return path.join(app.getAppPath(), 'dist', 'preload', 'index.cjs');
 }
 
-/**
+/** macOS: в Dock — тот же растр, что и у окон (ICO/PNG из brandingIcon). */
- * PNG для иконки окна / дока: тот же растр, что electron-builder берёт из `build/icon.png`
- * (копия в dist после сборки), затем окно 256px, затем dev-пути. SVG не используем для
- * nativeImage на Windows — иначе пустая картинка и дефолтная иконка Electron вместо exe.
- */
-function resolveBrandingPngPaths(): string[] {
-  const root = app.getAppPath();
-  return [
-    path.join(root, 'dist', 'renderer', 'app-pack-icon.png'),
-    path.join(root, 'dist', 'renderer', 'app-window-icon.png'),
-    path.join(root, 'build', 'icon.png'),
-    path.join(root, 'app', 'renderer', 'public', 'app-window-icon.png'),
-  ];
-}
-
-function resolveWindowIconPath(): string | undefined {
-  for (const p of resolveBrandingPngPaths()) {
-    try {
-      if (fs.existsSync(p)) return p;
-    } catch {
-      /* ignore */
-    }
-  }
-  const root = app.getAppPath();
-  const svgFallback = [
-    path.join(root, 'dist', 'renderer', 'app-logo.svg'),
-    path.join(root, 'app', 'renderer', 'public', 'app-logo.svg'),
-  ];
-  for (const p of svgFallback) {
-    try {
-      if (fs.existsSync(p)) return p;
-    } catch {
-      /* ignore */
-    }
-  }
-  return undefined;
-}
-
-function resolveWindowIcon(): Electron.NativeImage | undefined {
-  const tryPath = (filePath: string): Electron.NativeImage | undefined => {
-    try {
-      const img = nativeImage.createFromPath(filePath);
-      if (!img.isEmpty()) return img;
-    } catch {
-      /* ignore */
-    }
-    return undefined;
-  };
-
-  if (process.platform === 'win32' || process.platform === 'linux') {
-    for (const p of resolveBrandingPngPaths()) {
-      if (!fs.existsSync(p)) continue;
-      const img = tryPath(p);
-      if (img) return img;
-    }
-    return undefined;
-  }
-
-  const p = resolveWindowIconPath();
-  if (!p) return undefined;
-  return tryPath(p);
-}
-
-/** macOS: в Dock показываем тот же PNG, что и у упакованного приложения на Windows (иконка exe). */
 export function applyDockIconIfNeeded(): void {
   if (process.platform !== 'darwin' || !app.dock) return;
-  for (const p of resolveBrandingPngPaths()) {
+  const icon = loadBrandingWindowIcon();
-    if (!fs.existsSync(p)) continue;
+  if (!icon || icon.isEmpty()) return;
-    try {
+  try {
-      const img = nativeImage.createFromPath(p);
+    app.dock.setIcon(icon);
-      if (img.isEmpty()) continue;
+  } catch {
-      app.dock.setIcon(img);
+    /* ignore */
-      return;
-    } catch {
-      /* try next */
-    }
   }
 }
 
@@ -167,7 +113,7 @@ function ensureWindowBecomesVisible(win: BrowserWindow): void {
 
 function createWindow(kind: WindowKind, opts?: CreateWindowOpts): BrowserWindow {
   const deferEditor = kind === 'editor' && opts?.deferVisibility === true;
-  const icon = resolveWindowIcon();
+  const icon = loadBrandingWindowIcon();
   const win = new BrowserWindow({
     width: kind === 'editor' ? 1280 : kind === 'control' ? 1200 : 1280,
     height: 800,
@@ -186,6 +132,13 @@ function createWindow(kind: WindowKind, opts?: CreateWindowOpts): BrowserWindow
       webSecurity: Boolean(process.env.VITE_DEV_SERVER_URL),
     },
   });
+  if (icon) {
+    try {
+      win.setIcon(icon);
+    } catch {
+      /* ignore */
+    }
+  }
 
   win.webContents.on('preload-error', (_event, preloadPath, error) => {
     console.error(`[preload-error] ${preloadPath}:`, error);
@@ -212,9 +165,7 @@ function createWindow(kind: WindowKind, opts?: CreateWindowOpts): BrowserWindow
   win.on('closed', () => {
     if (kind !== 'presentation' && kind !== 'control') return;
     const open = windows.has('presentation') || windows.has('control');
-    for (const w of BrowserWindow.getAllWindows()) {
+    broadcastMultiWindowStateChanged(open);
-      w.webContents.send(ipcChannels.windows.multiWindowStateChanged, { open });
-    }
   });
   windows.set(kind, win);
   return win;
@@ -292,10 +243,7 @@ export function openMultiWindow() {
     // Keep control window independent on darwin.
     createWindow('control', process.platform === 'darwin' ? undefined : { parent: presentation });
   }
-  const open = true;
+  broadcastMultiWindowStateChanged(true);
-  for (const w of BrowserWindow.getAllWindows()) {
-    w.webContents.send(ipcChannels.windows.multiWindowStateChanged, { open });
-  }
 }
 
 export function closeMultiWindow(): void {

app/renderer/control/ControlApp.tsx

@@ -4,6 +4,7 @@ import { pickEraseTargetId } from '../../shared/effectEraserHitTest';
 import { ipcChannels } from '../../shared/ipc/contracts';
 import type { SessionState } from '../../shared/ipc/contracts';
 import type { GraphNodeId, Scene, SceneId } from '../../shared/types';
+import { useEditorI18n } from '../editor/i18n/EditorI18nContext';
 import { getDndApi } from '../shared/dndApi';
 import { PixiEffectsOverlay } from '../shared/effects/PxiEffectsOverlay';
 import { useEffectsState } from '../shared/effects/useEffectsState';
@@ -44,6 +45,9 @@ function playLightningEffectSound(): void {
 
 export function ControlApp() {
   const api = getDndApi();
+  const { t } = useEditorI18n();
+  const tRef = useRef(t);
+  tRef.current = t;
   const [fxState, fx] = useEffectsState();
   const [session, setSession] = useState<SessionState | null>(null);
   const historyRef = useRef<GraphNodeId[]>([]);
@@ -278,8 +282,7 @@ export function ControlApp() {
           const m = sceneAudioMetaRef.current.get(ref.assetId) ?? { lastPlayError: null };
           sceneAudioMetaRef.current.set(ref.assetId, {
             ...m,
-            lastPlayError:
+            lastPlayError: tRef.current('control.audioAutoplayBlocked'),
-              'Автозапуск заблокирован (нужно действие пользователя) или ошибка воспроизведения.',
           });
           setSceneAudioStateTick((x) => x + 1);
           try {
@@ -382,8 +385,7 @@ export function ControlApp() {
           const m = campaignAudioMetaRef.current.get(ref.assetId) ?? { lastPlayError: null };
           campaignAudioMetaRef.current.set(ref.assetId, {
             ...m,
-            lastPlayError:
+            lastPlayError: tRef.current('control.audioAutoplayBlocked'),
-              'Автозапуск заблокирован (нужно действие пользователя) или ошибка воспроизведения.',
           });
           setCampaignAudioStateTick((x) => x + 1);
           try {
@@ -546,21 +548,21 @@ export function ControlApp() {
       group === 'scene'
         ? (sceneAudioElsRef.current.get(assetId) ?? null)
         : (campaignAudioElsRef.current.get(assetId) ?? null);
-    if (!el) return { label: 'URL не получен', detail: 'Не удалось получить dnd://asset URL для аудио.' };
+    if (!el) return { label: t('control.audioNoUrl'), detail: t('control.audioNoUrlDetail') };
     const meta =
       group === 'scene'
         ? (sceneAudioMetaRef.current.get(assetId) ?? { lastPlayError: null })
         : (campaignAudioMetaRef.current.get(assetId) ?? { lastPlayError: null });
-    if (meta.lastPlayError) return { label: 'Ошибка/блок', detail: meta.lastPlayError };
+    if (meta.lastPlayError) return { label: t('control.audioBlocked'), detail: meta.lastPlayError };
     if (el.error)
       return {
-        label: 'Ошибка',
+        label: t('control.audioError'),
-        detail: `MediaError code=${String(el.error.code)} (1=ABORTED, 2=NETWORK, 3=DECODE, 4=SRC_NOT_SUPPORTED)`,
+        detail: t('control.audioMediaError', { code: String(el.error.code) }),
       };
-    if (el.readyState < 2) return { label: 'Загрузка…' };
+    if (el.readyState < 2) return { label: t('control.audioLoading') };
-    if (!el.paused) return { label: 'Играет' };
+    if (!el.paused) return { label: t('control.audioPlaying') };
-    if (el.currentTime > 0) return { label: 'Пауза' };
+    if (el.currentTime > 0) return { label: t('control.audioPaused') };
-    return { label: 'Остановлено' };
+    return { label: t('control.audioStopped') };
   }
   const nextScenes = useMemo(() => {
     if (!project) return [];
@@ -955,21 +957,21 @@ export function ControlApp() {
   return (
     <div className={styles.page}>
       <Surface className={styles.remote}>
-        <div className={styles.remoteTitle}>ПУЛЬТ УПРАВЛЕНИЯ</div>
+        <div className={styles.remoteTitle}>{t('control.remoteTitle')}</div>
         <div className={styles.spacer12} />
         {!isVideoPreviewScene ? (
           <>
-            <div className={styles.sectionLabel}>ЭФФЕКТЫ</div>
+            <div className={styles.sectionLabel}>{t('control.effects')}</div>
             <div className={styles.spacer8} />
             <div className={styles.effectsStack}>
               <div className={styles.effectsGroup}>
-                <div className={styles.subsectionLabel}>Инструменты</div>
+                <div className={styles.subsectionLabel}>{t('control.tools')}</div>
                 <div className={styles.iconRow}>
                   <Button
                     variant={tool.tool === 'eraser' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Ластик"
+                    title={t('control.eraser')}
-                    ariaLabel="Ластик"
+                    ariaLabel={t('control.eraser')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'eraser' } })}
                   >
                     <span className={styles.iconGlyph}>🧹</span>
@@ -977,8 +979,8 @@ export function ControlApp() {
                   <Button
                     variant="ghost"
                     iconOnly
-                    title="Очистить эффекты"
+                    title={t('control.clearEffects')}
-                    ariaLabel="Очистить эффекты"
+                    ariaLabel={t('control.clearEffects')}
                     onClick={() => void fx.dispatch({ kind: 'instances.clear' })}
                   >
                     <span className={styles.clearIcon}>
@@ -999,13 +1001,13 @@ export function ControlApp() {
                 </div>
               </div>
               <div className={styles.effectsGroup}>
-                <div className={styles.subsectionLabel}>Эффекты поля</div>
+                <div className={styles.subsectionLabel}>{t('control.fieldEffects')}</div>
                 <div className={styles.iconRow}>
                   <Button
                     variant={tool.tool === 'fog' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Туман"
+                    title={t('control.fog')}
-                    ariaLabel="Туман"
+                    ariaLabel={t('control.fog')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'fog' } })}
                   >
                     <span className={styles.iconGlyph}>🌫️</span>
@@ -1013,8 +1015,8 @@ export function ControlApp() {
                   <Button
                     variant={tool.tool === 'rain' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Дождь"
+                    title={t('control.rain')}
-                    ariaLabel="Дождь"
+                    ariaLabel={t('control.rain')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'rain' } })}
                   >
                     <span className={styles.iconGlyph}>🌧️</span>
@@ -1022,8 +1024,8 @@ export function ControlApp() {
                   <Button
                     variant={tool.tool === 'fire' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Огонь"
+                    title={t('control.fire')}
-                    ariaLabel="Огонь"
+                    ariaLabel={t('control.fire')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'fire' } })}
                   >
                     <span className={styles.iconGlyph}>🔥</span>
@@ -1031,8 +1033,8 @@ export function ControlApp() {
                   <Button
                     variant={tool.tool === 'water' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Вода"
+                    title={t('control.water')}
-                    ariaLabel="Вода"
+                    ariaLabel={t('control.water')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'water' } })}
                   >
                     <span className={styles.iconGlyph}>💧</span>
@@ -1040,13 +1042,13 @@ export function ControlApp() {
                 </div>
               </div>
               <div className={styles.effectsGroup}>
-                <div className={styles.subsectionLabel}>Эффекты действий</div>
+                <div className={styles.subsectionLabel}>{t('control.actionEffects')}</div>
                 <div className={styles.iconRow}>
                   <Button
                     variant={tool.tool === 'lightning' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Молния"
+                    title={t('control.lightning')}
-                    ariaLabel="Молния"
+                    ariaLabel={t('control.lightning')}
                     onClick={() =>
                       void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'lightning' } })
                     }
@@ -1056,8 +1058,8 @@ export function ControlApp() {
                   <Button
                     variant={tool.tool === 'sunbeam' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Луч света"
+                    title={t('control.sunbeam')}
-                    ariaLabel="Луч света"
+                    ariaLabel={t('control.sunbeam')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'sunbeam' } })}
                   >
                     <span className={styles.iconGlyph}>☀️</span>
@@ -1065,8 +1067,8 @@ export function ControlApp() {
                   <Button
                     variant={tool.tool === 'freeze' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Заморозка"
+                    title={t('control.freeze')}
-                    ariaLabel="Заморозка"
+                    ariaLabel={t('control.freeze')}
                     onClick={() => void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'freeze' } })}
                   >
                     <span className={styles.iconGlyph}>❄️</span>
@@ -1074,8 +1076,8 @@ export function ControlApp() {
                   <Button
                     variant={tool.tool === 'poisonCloud' ? 'primary' : 'ghost'}
                     iconOnly
-                    title="Облако яда"
+                    title={t('control.poisonCloud')}
-                    ariaLabel="Облако яда"
+                    ariaLabel={t('control.poisonCloud')}
                     onClick={() =>
                       void fx.dispatch({ kind: 'tool.set', tool: { ...tool, tool: 'poisonCloud' } })
                     }
@@ -1085,7 +1087,7 @@ export function ControlApp() {
                 </div>
               </div>
               <div className={styles.radiusRow}>
-                <div className={styles.radiusLabel}>Радиус кисти</div>
+                <div className={styles.radiusLabel}>{t('control.brushRadius')}</div>
                 <input
                   type="range"
                   min={0.015}
@@ -1098,7 +1100,7 @@ export function ControlApp() {
                     void fx.dispatch({ kind: 'tool.set', tool: { ...tool, radiusN: next } });
                   }}
                   className={styles.range}
-                  aria-label="Радиус кисти"
+                  aria-label={t('control.brushRadius')}
                 />
                 <div className={styles.radiusValue}>{Math.round(tool.radiusN * 100)}</div>
               </div>
@@ -1107,7 +1109,7 @@ export function ControlApp() {
           </>
         ) : null}
         <div className={styles.storyWrap}>
-          <div className={styles.sectionLabel}>СЮЖЕТНАЯ ЛИНИЯ</div>
+          <div className={styles.sectionLabel}>{t('control.storyLine')}</div>
           <div className={styles.spacer10} />
           <div className={styles.storyScroll}>
             {history.map((gnId, idx) => {
@@ -1122,7 +1124,7 @@ export function ControlApp() {
                   className={[styles.historyBtn, isCurrent ? styles.historyBtnCurrent : '']
                     .filter(Boolean)
                     .join(' ')}
-                  title={project && !isCurrent ? 'Перейти к этой сцене' : undefined}
+                  title={project && !isCurrent ? t('control.gotoScene') : undefined}
                   onClick={() => {
                     if (!project) return;
                     if (isCurrent) return;
@@ -1132,15 +1134,17 @@ export function ControlApp() {
                   }}
                 >
                   {isCurrent ? (
-                    <div className={styles.historyBadge}>ТЕКУЩАЯ СЦЕНА</div>
+                    <div className={styles.historyBadge}>{t('control.currentSceneBadge')}</div>
                   ) : (
-                    <div className={styles.historyMuted}>Пройдено</div>
+                    <div className={styles.historyMuted}>{t('control.passed')}</div>
                   )}
                   <div className={styles.historyTitle}>{s?.title ?? (gn ? String(gn.sceneId) : gnId)}</div>
                 </button>
               );
             })}
-            {history.length === 0 ? <div className={styles.emptyStory}>Нет активной сцены.</div> : null}
+            {history.length === 0 ? (
+              <div className={styles.emptyStory}>{t('control.noActiveScene')}</div>
+            ) : null}
           </div>
         </div>
       </Surface>
@@ -1148,20 +1152,15 @@ export function ControlApp() {
       <div className={styles.rightStack}>
         <Surface className={styles.surfacePad}>
           <div className={styles.previewHeader}>
-            <div className={styles.previewTitle}>Предпросмотр экрана</div>
+            <div className={styles.previewTitle}>{t('control.screenPreview')}</div>
             <div className={styles.previewActions}>
               <Button onClick={() => void api.invoke(ipcChannels.windows.closeMultiWindow, {})}>
-                Выключить демонстрацию
+                {t('control.stopPresentation')}
               </Button>
             </div>
           </div>
           <div className={styles.spacer10} />
-          {isVideoPreviewScene ? (
+          {isVideoPreviewScene ? <div className={styles.videoHint}>{t('control.videoBrushHint')}</div> : null}
-            <div className={styles.videoHint}>
-              Видео-превью: кисть эффектов отключена (как на экране демонстрации — оверлей только для
-              изображения).
-            </div>
-          ) : null}
           <div className={styles.spacer10} />
           <div className={styles.previewFrame}>
             <div ref={previewHostRef} className={styles.previewHost}>
@@ -1258,33 +1257,33 @@ export function ControlApp() {
         </Surface>
 
         <Surface className={styles.surfacePad}>
-          <div className={styles.branchTitle}>Варианты ветвления</div>
+          <div className={styles.branchTitle}>{t('control.branches')}</div>
           <div className={styles.branchGrid}>
             {nextScenes.map((o, i) => (
               <div key={o.graphNodeId} className={styles.branchCard}>
                 <div className={styles.branchCardHeader}>
-                  <div className={styles.branchOption}>ОПЦИЯ {String(i + 1)}</div>
+                  <div className={styles.branchOption}>{t('control.option', { n: String(i + 1) })}</div>
                 </div>
-                <div className={styles.branchName}>{o.scene.title || 'Без названия'}</div>
+                <div className={styles.branchName}>{o.scene.title || t('control.unnamed')}</div>
                 <Button
                   variant="primary"
                   onClick={() =>
                     void api.invoke(ipcChannels.project.setCurrentGraphNode, { graphNodeId: o.graphNodeId })
                   }
                 >
-                  Переключить
+                  {t('control.switchScene')}
                 </Button>
               </div>
             ))}
             {nextScenes.length === 0 ? (
               <div className={styles.branchEmpty}>
-                <div>Нет вариантов перехода.</div>
+                <div>{t('control.noBranches')}</div>
                 <Button
                   variant="primary"
                   disabled={!session?.project?.currentGraphNodeId}
                   onClick={() => void api.invoke(ipcChannels.windows.closeMultiWindow, {})}
                 >
-                  Завершить показ
+                  {t('control.endPresentation')}
                 </Button>
               </div>
             ) : null}
@@ -1293,13 +1292,13 @@ export function ControlApp() {
 
         <Surface className={styles.surfacePad}>
           <div className={styles.musicHeader}>
-            <div className={styles.previewTitle}>Музыка</div>
+            <div className={styles.previewTitle}>{t('control.music')}</div>
           </div>
           <div className={styles.spacer10} />
-          <div className={styles.sectionLabel}>МУЗЫКА СЦЕНЫ</div>
+          <div className={styles.sectionLabel}>{t('control.sceneMusic')}</div>
           <div className={styles.spacer10} />
           {sceneAudios.length === 0 ? (
-            <div className={styles.musicEmpty}>В текущей сцене нет аудио.</div>
+            <div className={styles.musicEmpty}>{t('control.noSceneAudio')}</div>
           ) : null}
           {sceneAudios.length > 0 ? (
             <div className={styles.audioList}>
@@ -1314,8 +1313,8 @@ export function ControlApp() {
                     <div className={styles.audioMeta}>
                       <div className={styles.audioName}>{asset.originalName}</div>
                       <div className={styles.audioBadges}>
-                        <div>{ref.autoplay ? 'Авто' : 'Ручн.'}</div>
+                        <div>{ref.autoplay ? t('control.modeAuto') : t('control.modeManual')}</div>
-                        <div>{ref.loop ? 'Цикл' : 'Один раз'}</div>
+                        <div>{ref.loop ? t('control.loop') : t('control.once')}</div>
                         <div title={st.detail}>{st.label}</div>
                       </div>
                       <div className={styles.spacer10} />
@@ -1344,7 +1343,7 @@ export function ControlApp() {
                           styles.audioScrub,
                           dur > 0 ? styles.audioScrubPointer : styles.audioScrubDefault,
                         ].join(' ')}
-                        title={dur > 0 ? 'Клик — перемотка' : 'Длительность неизвестна'}
+                        title={dur > 0 ? t('control.scrubSeek') : t('control.durationUnknown')}
                       >
                         <div
                           className={styles.scrubFill}
@@ -1369,7 +1368,7 @@ export function ControlApp() {
                               ({ lastPlayError: null } as const);
                             sceneAudioMetaRef.current.set(ref.assetId, {
                               ...mm,
-                              lastPlayError: 'Не удалось запустить.',
+                              lastPlayError: t('control.playFailed'),
                             });
                             setSceneAudioStateTick((x) => x + 1);
                           });
@@ -1403,10 +1402,10 @@ export function ControlApp() {
           ) : null}
 
           <div className={styles.spacer12} />
-          <div className={styles.sectionLabel}>МУЗЫКА ИГРЫ</div>
+          <div className={styles.sectionLabel}>{t('control.gameMusic')}</div>
           <div className={styles.spacer10} />
           {campaignAudios.length === 0 ? (
-            <div className={styles.musicEmpty}>В игре нет аудио.</div>
+            <div className={styles.musicEmpty}>{t('control.noGameAudio')}</div>
           ) : (
             <div className={styles.audioList}>
               {campaignAudios.map(({ ref, asset }) => {
@@ -1420,10 +1419,12 @@ export function ControlApp() {
                     <div className={styles.audioMeta}>
                       <div className={styles.audioName}>{asset.originalName}</div>
                       <div className={styles.audioBadges}>
-                        <div>{ref.autoplay ? 'Авто' : 'Ручн.'}</div>
+                        <div>{ref.autoplay ? t('control.modeAuto') : t('control.modeManual')}</div>
-                        <div>{ref.loop ? 'Цикл' : 'Один раз'}</div>
+                        <div>{ref.loop ? t('control.loop') : t('control.once')}</div>
                         <div title={st.detail}>{st.label}</div>
-                        {!allowCampaignAudio ? <div title="В сцене есть музыка">Пауза (сцена)</div> : null}
+                        {!allowCampaignAudio ? (
+                          <div title={t('control.pauseSceneMusicTitle')}>{t('control.pauseSceneMusic')}</div>
+                        ) : null}
                       </div>
                       <div className={styles.spacer10} />
                       <div
@@ -1451,7 +1452,7 @@ export function ControlApp() {
                           styles.audioScrub,
                           dur > 0 ? styles.audioScrubPointer : styles.audioScrubDefault,
                         ].join(' ')}
-                        title={dur > 0 ? 'Клик — перемотка' : 'Длительность неизвестна'}
+                        title={dur > 0 ? t('control.scrubSeek') : t('control.durationUnknown')}
                       >
                         <div
                           className={styles.scrubFill}
@@ -1466,7 +1467,7 @@ export function ControlApp() {
                     <div className={styles.audioTransport}>
                       <Button
                         variant="primary"
-                        title={!allowCampaignAudio ? 'Пауза: в сцене есть музыка' : undefined}
+                        title={!allowCampaignAudio ? t('control.pauseCampaignTitle') : undefined}
                         onClick={() => {
                           if (!el) return;
                           const m = campaignAudioMetaRef.current.get(ref.assetId) ?? { lastPlayError: null };
@@ -1484,7 +1485,7 @@ export function ControlApp() {
                               ({ lastPlayError: null } as const);
                             campaignAudioMetaRef.current.set(ref.assetId, {
                               ...mm,
-                              lastPlayError: 'Не удалось запустить.',
+                              lastPlayError: t('control.playFailed'),
                             });
                             setCampaignAudioStateTick((x) => x + 1);
                           });

app/renderer/control/ControlScenePreview.tsx

@@ -2,6 +2,7 @@ import React, { useEffect, useMemo, useState } from 'react';
 
 import { computeTimeSec } from '../../main/video/videoPlaybackStore';
 import type { SessionState } from '../../shared/ipc/contracts';
+import { useEditorI18n } from '../editor/i18n/EditorI18nContext';
 import { RotatedImage } from '../shared/RotatedImage';
 import { useAssetUrl } from '../shared/useAssetImageUrl';
 import { useVideoPlaybackState } from '../shared/video/useVideoPlaybackState';
@@ -23,6 +24,7 @@ function fmt(sec: number): string {
 }
 
 export function ControlScenePreview({ session, videoRef, onContentRectChange }: Props) {
+  const { t } = useEditorI18n();
   const [vp, video] = useVideoPlaybackState();
   const scene =
     session?.project && session.currentSceneId ? session.project.scenes[session.currentSceneId] : undefined;
@@ -102,7 +104,7 @@ export function ControlScenePreview({ session, videoRef, onContentRectChange }:
           onTimeUpdate={() => setTick((x) => x + 1)}
           onLoadedMetadata={() => setTick((x) => x + 1)}
         >
-          <track kind="captions" srcLang="ru" label="Превью без субтитров" />
+          <track kind="captions" srcLang="ru" label={t('control.previewTrackLabel')} />
         </video>
       ) : (
         <div className={styles.placeholder} />
@@ -132,7 +134,7 @@ export function ControlScenePreview({ session, videoRef, onContentRectChange }:
                 void video.dispatch({ kind: 'seek', timeSec: Math.min(dur, cur + 5) });
               if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') setTick((x) => x + 1);
             }}
-            title="Клик — перемотка"
+            title={t('control.scrubSeek')}
           >
             <div className={styles.scrubFill} style={{ width: `${String(Math.round(pct * 100))}%` }} />
           </div>
@@ -142,7 +144,7 @@ export function ControlScenePreview({ session, videoRef, onContentRectChange }:
                 type="button"
                 className={styles.transportBtn}
                 onClick={() => void video.dispatch({ kind: 'play' })}
-                title="Play"
+                title={t('control.transportPlay')}
               >
                 ▶
               </button>
@@ -150,7 +152,7 @@ export function ControlScenePreview({ session, videoRef, onContentRectChange }:
                 type="button"
                 className={styles.transportBtn}
                 onClick={() => void video.dispatch({ kind: 'pause' })}
-                title="Pause"
+                title={t('control.transportPause')}
               >
                 ❚❚
               </button>
@@ -161,7 +163,7 @@ export function ControlScenePreview({ session, videoRef, onContentRectChange }:
                   void video.dispatch({ kind: 'stop' });
                   setTick((x) => x + 1);
                 }}
-                title="Stop"
+                title={t('control.transportStop')}
               >
                 ■
               </button>

app/renderer/control/controlApp.effectsPanel.test.ts

@@ -47,28 +47,28 @@ void test('ControlApp: звук облака яда (public/oblako-yada.mp3)', (
 
 void test('ControlApp: эффекты в пульте, иконки с тултипами и подписью для a11y', () => {
   const src = readControlApp();
-  assert.ok(src.includes('ЭФФЕКТЫ'));
+  assert.ok(src.includes("t('control.effects')"));
-  assert.ok(src.includes('Инструменты'));
+  assert.ok(src.includes("t('control.tools')"));
-  assert.ok(src.includes('Эффекты поля'));
+  assert.ok(src.includes("t('control.fieldEffects')"));
-  assert.ok(src.includes('Эффекты действий'));
+  assert.ok(src.includes("t('control.actionEffects')"));
-  assert.ok(src.includes('Луч света'));
+  assert.ok(src.includes("t('control.sunbeam')"));
-  assert.ok(src.includes('title="Вода"'));
+  assert.ok(src.includes("title={t('control.water')}"));
-  assert.ok(src.includes('title="Облако яда"'));
+  assert.ok(src.includes("title={t('control.poisonCloud')}"));
-  assert.ok(src.includes('title="Туман"'));
+  assert.ok(src.includes("title={t('control.fog')}"));
-  assert.ok(src.includes('ariaLabel="Туман"'));
+  assert.ok(src.includes("ariaLabel={t('control.fog')}"));
   assert.ok(src.includes('iconOnly'));
-  assert.ok(src.includes('title="Очистить эффекты"'));
+  assert.ok(src.includes("title={t('control.clearEffects')}"));
-  assert.ok(src.includes('ariaLabel="Очистить эффекты"'));
+  assert.ok(src.includes("ariaLabel={t('control.clearEffects')}"));
   assert.ok(src.includes('#e5484d'));
-  const fx = src.indexOf('ЭФФЕКТЫ');
+  const fx = src.indexOf("t('control.effects')");
-  const story = src.indexOf('СЮЖЕТНАЯ ЛИНИЯ');
+  const story = src.indexOf("t('control.storyLine')");
   assert.ok(fx !== -1 && story !== -1 && fx < story, 'Блок эффектов должен быть выше сюжетной линии');
 });
 
 void test('ControlApp: сюжетная линия — колонка сверху вниз и фон как у карточек ветвления', () => {
   const src = readControlApp();
   const css = readControlAppCss();
-  const story = src.indexOf('СЮЖЕТНАЯ ЛИНИЯ');
+  const story = src.indexOf("t('control.storyLine')");
   assert.ok(story !== -1);
   assert.ok(src.includes('className={styles.storyScroll}'));
   assert.match(css, /\.storyScroll[\s\S]*?justify-content:\s*flex-start/);
@@ -86,8 +86,8 @@ void test('ControlApp: слой кисти не использует курсо
 
 void test('ControlApp: радиус кисти не в блоке предпросмотра', () => {
   const src = readControlApp();
-  const previewLabel = src.indexOf('Предпросмотр экрана');
+  const previewLabel = src.indexOf("t('control.screenPreview')");
-  const radius = src.indexOf('Радиус кисти');
+  const radius = src.indexOf("t('control.brushRadius')");
   assert.ok(previewLabel !== -1 && radius !== -1);
   assert.ok(
     radius < previewLabel,
@@ -97,8 +97,8 @@ void test('ControlApp: радиус кисти не в блоке предпро
 
 void test('ControlApp: музыка разделена на сцену и кампанию', () => {
   const src = readControlApp();
-  assert.ok(src.includes('МУЗЫКА СЦЕНЫ'));
+  assert.ok(src.includes("t('control.sceneMusic')"));
-  assert.ok(src.includes('МУЗЫКА ИГРЫ'));
+  assert.ok(src.includes("t('control.gameMusic')"));
   // при музыке сцены — кампанию ставим на паузу
   assert.ok(src.includes('allowCampaignAudio'));
   assert.ok(

app/renderer/control/main.tsx

@@ -2,6 +2,8 @@ import React from 'react';
 import { createRoot } from 'react-dom/client';
 
 import '../shared/ui/globals.css';
+import { EditorI18nProvider } from '../editor/i18n/EditorI18nContext';
+
 import { ControlApp } from './ControlApp';
 
 const rootEl = document.getElementById('root');
@@ -11,6 +13,8 @@ if (!rootEl) {
 
 createRoot(rootEl).render(
   <React.StrictMode>
-    <ControlApp />
+    <EditorI18nProvider>
+      <ControlApp />
+    </EditorI18nProvider>
   </React.StrictMode>,
 );

app/renderer/editor/EditorApp.module.css

@@ -243,6 +243,33 @@
   font: inherit;
 }
 
+.fileMenuSubHost {
+  position: relative;
+}
+
+.fileMenuItemExpand {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  width: 100%;
+}
+
+.fileMenuSub {
+  position: absolute;
+  left: calc(100% + 6px);
+  top: 0;
+  min-width: 200px;
+  border-radius: var(--radius-md);
+  border: 1px solid var(--stroke);
+  background: var(--color-surface-elevated-2);
+  box-shadow: var(--shadow-lg);
+  padding: 6px;
+  display: grid;
+  gap: 4px;
+  z-index: calc(var(--z-file-menu) + 1);
+}
+
 .modalBackdrop {
   position: fixed;
   inset: 0;

app/renderer/editor/graph/SceneGraph.tsx

@@ -1,4 +1,4 @@
-import React, { useCallback, useEffect, useMemo, useState } from 'react';
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
 import { createPortal } from 'react-dom';
 import ReactFlow, {
   Background,
@@ -50,11 +50,53 @@ export const DND_SCENE_ID_MIME = 'application/x-dnd-scene-id';
 const SCENE_CARD_W = 220;
 const SCENE_CARD_H = 248;
 
+/** UI strings for the scene graph (passed from editor i18n). */
+export type SceneGraphUiStrings = {
+  badgeStart: string;
+  untitled: string;
+  videoBadge: string;
+  audioBadge: string;
+  loop: string;
+  autoplay: string;
+  previewAutostart: string;
+  videoLoop: string;
+  zoomBar: string;
+  zoomIn: string;
+  zoomOut: string;
+  fitAll: string;
+  closeMenu: string;
+  startScene: string;
+  unsetStartScene: string;
+  delete: string;
+};
+
+const DEFAULT_SCENE_GRAPH_UI: SceneGraphUiStrings = {
+  badgeStart: 'НАЧАЛО',
+  untitled: 'Без названия',
+  videoBadge: 'Видео',
+  audioBadge: 'Аудио',
+  loop: 'Цикл',
+  autoplay: 'Автостарт',
+  previewAutostart: 'Авто превью',
+  videoLoop: 'Цикл видео',
+  zoomBar: 'Масштаб графа',
+  zoomIn: 'Увеличить',
+  zoomOut: 'Уменьшить',
+  fitAll: 'Показать всё',
+  closeMenu: 'Закрыть меню',
+  startScene: 'Начальная сцена',
+  unsetStartScene: 'Снять метку «Начальная сцена»',
+  delete: 'Удалить',
+};
+
+const GraphUiContext = createContext<SceneGraphUiStrings>(DEFAULT_SCENE_GRAPH_UI);
+
 export type SceneGraphProps = {
   sceneGraphNodes: SceneGraphNode[];
   sceneGraphEdges: SceneGraphEdge[];
   sceneCardById: Record<SceneId, SceneGraphSceneCard>;
   currentSceneId: SceneId | null;
+  graphUi?: SceneGraphUiStrings;
   onCurrentSceneChange: (id: SceneId) => void;
   onConnect: (sourceGraphNodeId: GraphNodeId, targetGraphNodeId: GraphNodeId) => void;
   onDisconnect: (edgeId: string) => void;
@@ -131,6 +173,7 @@ function IconVideoPreviewAutostart() {
 }
 
 function SceneCardNode({ data }: NodeProps<SceneCardData>) {
+  const ui = useContext(GraphUiContext);
   const thumbUrl = useAssetUrl(data.previewThumbAssetId);
   const previewUrl = useAssetUrl(data.previewAssetId);
   const cardClass = [styles.card, data.active ? styles.cardActive : ''].filter(Boolean).join(' ');
@@ -141,7 +184,7 @@ function SceneCardNode({ data }: NodeProps<SceneCardData>) {
       <Handle type="target" position={Position.Top} className={styles.handle} />
       <div className={cardClass}>
         <div className={styles.previewShell}>
-          {data.isStartScene ? <div className={styles.badgeStart}>НАЧАЛО</div> : null}
+          {data.isStartScene ? <div className={styles.badgeStart}>{ui.badgeStart}</div> : null}
           {thumbUrl ? (
             <div className={styles.previewFill}>
               {data.previewRotationDeg === 0 ? (
@@ -209,12 +252,12 @@ function SceneCardNode({ data }: NodeProps<SceneCardData>) {
           {showCornerVideo || showCornerAudio ? (
             <div className={styles.cornerBadges}>
               {showCornerVideo ? (
-                <span className={styles.mediaBadge} title="Видео">
+                <span className={styles.mediaBadge} title={ui.videoBadge}>
                   <IconVideoBadge />
                 </span>
               ) : null}
               {showCornerAudio ? (
-                <span className={styles.mediaBadge} title="Аудио">
+                <span className={styles.mediaBadge} title={ui.audioBadge}>
                   <IconAudioBadge />
                 </span>
               ) : null}
@@ -222,19 +265,19 @@ function SceneCardNode({ data }: NodeProps<SceneCardData>) {
           ) : null}
         </div>
         <div className={styles.nodeBody}>
-          <div className={styles.title}>{data.title || 'Без названия'}</div>
+          <div className={styles.title}>{data.title || ui.untitled}</div>
           {data.hasAnyAudioLoop || data.hasAnyAudioAutoplay ? (
             <div className={styles.musicParams}>
               {data.hasAnyAudioLoop ? (
                 <div className={styles.musicParam}>
                   <IconLoopParam />
-                  <span>Цикл</span>
+                  <span>{ui.loop}</span>
                 </div>
               ) : null}
               {data.hasAnyAudioAutoplay ? (
                 <div className={styles.musicParam}>
                   <IconAutoplayParam />
-                  <span>Автостарт</span>
+                  <span>{ui.autoplay}</span>
                 </div>
               ) : null}
             </div>
@@ -244,13 +287,13 @@ function SceneCardNode({ data }: NodeProps<SceneCardData>) {
               {data.showPreviewVideoAutostart ? (
                 <div className={styles.musicParam}>
                   <IconVideoPreviewAutostart />
-                  <span>Авто превью</span>
+                  <span>{ui.previewAutostart}</span>
                 </div>
               ) : null}
               {data.showPreviewVideoLoop ? (
                 <div className={styles.musicParam}>
                   <IconLoopParam />
-                  <span>Цикл видео</span>
+                  <span>{ui.videoLoop}</span>
                 </div>
               ) : null}
             </div>
@@ -265,18 +308,19 @@ function SceneCardNode({ data }: NodeProps<SceneCardData>) {
 const nodeTypes = { sceneCard: SceneCardNode };
 
 function GraphZoomToolbar() {
+  const ui = useContext(GraphUiContext);
   const { zoomIn, zoomOut, fitView } = useReactFlow();
   const zoom = useStore((s) => s.transform[2]);
   const pct = Math.max(1, Math.round(zoom * 100));
 
   return (
     <Panel position="bottom-center" className={styles.zoomPanel}>
-      <div className={styles.zoomBar} role="toolbar" aria-label="Масштаб графа">
+      <div className={styles.zoomBar} role="toolbar" aria-label={ui.zoomBar}>
-        <button type="button" className={styles.zoomBtn} onClick={() => zoomIn()} aria-label="Увеличить">
+        <button type="button" className={styles.zoomBtn} onClick={() => zoomIn()} aria-label={ui.zoomIn}>
           +
         </button>
         <span className={styles.zoomPct}>{pct}%</span>
-        <button type="button" className={styles.zoomBtn} onClick={() => zoomOut()} aria-label="Уменьшить">
+        <button type="button" className={styles.zoomBtn} onClick={() => zoomOut()} aria-label={ui.zoomOut}>
           −
         </button>
         <span className={styles.zoomDivider} aria-hidden />
@@ -284,8 +328,8 @@ function GraphZoomToolbar() {
           type="button"
           className={styles.zoomBtn}
           onClick={() => fitView({ padding: 0.25 })}
-          aria-label="Показать всё"
+          aria-label={ui.fitAll}
-          title="Показать всё"
+          title={ui.fitAll}
         >
           <svg className={styles.zoomFitIcon} viewBox="0 0 24 24" width={18} height={18} aria-hidden>
             <path
@@ -307,6 +351,7 @@ function SceneGraphCanvas({
   sceneGraphEdges,
   sceneCardById,
   currentSceneId,
+  graphUi,
   onCurrentSceneChange,
   onConnect,
   onDisconnect,
@@ -316,6 +361,7 @@ function SceneGraphCanvas({
   onSetGraphNodeStart,
   onDropSceneFromList,
 }: SceneGraphProps) {
+  const ui = graphUi ?? DEFAULT_SCENE_GRAPH_UI;
   const { screenToFlowPosition } = useReactFlow();
   const [menu, setMenu] = useState<{ x: number; y: number; graphNodeId: GraphNodeId } | null>(null);
 
@@ -446,109 +492,111 @@ function SceneGraphCanvas({
   }, [menu]);
 
   return (
-    <div className={styles.canvasWrap}>
+    <GraphUiContext.Provider value={ui}>
-      <ReactFlow
+      <div className={styles.canvasWrap}>
-        nodes={nodes}
+        <ReactFlow
-        edges={edges}
+          nodes={nodes}
-        nodeTypes={nodeTypes}
+          edges={edges}
-        onNodesChange={onNodesChange}
+          nodeTypes={nodeTypes}
-        onNodeDragStop={(_, node) => {
+          onNodesChange={onNodesChange}
-          onNodePositionCommit(node.id as GraphNodeId, node.position.x, node.position.y);
+          onNodeDragStop={(_, node) => {
-        }}
+            onNodePositionCommit(node.id as GraphNodeId, node.position.x, node.position.y);
-        onEdgesChange={onEdgesChange}
+          }}
-        isValidConnection={isValidConnection}
+          onEdgesChange={onEdgesChange}
-        onConnect={onConnectInternal}
+          isValidConnection={isValidConnection}
-        onEdgesDelete={(eds) => {
+          onConnect={onConnectInternal}
-          for (const ed of eds) {
+          onEdgesDelete={(eds) => {
-            onDisconnect(ed.id);
+            for (const ed of eds) {
-          }
+              onDisconnect(ed.id);
-        }}
+            }
-        onEdgeClick={(_, edge) => {
+          }}
-          onDisconnect(edge.id);
+          onEdgeClick={(_, edge) => {
-        }}
+            onDisconnect(edge.id);
-        onNodesDelete={(nds) => {
+          }}
-          onRemoveGraphNodes(nds.map((n) => n.id as GraphNodeId));
+          onNodesDelete={(nds) => {
-        }}
+            onRemoveGraphNodes(nds.map((n) => n.id as GraphNodeId));
-        onNodeClick={(_, node) => {
+          }}
-          setMenu(null);
+          onNodeClick={(_, node) => {
-          const d = node.data as SceneCardData;
+            setMenu(null);
-          onCurrentSceneChange(d.sceneId);
+            const d = node.data as SceneCardData;
-        }}
+            onCurrentSceneChange(d.sceneId);
-        onNodeContextMenu={(e, node) => {
+          }}
-          e.preventDefault();
+          onNodeContextMenu={(e, node) => {
-          setMenu({ x: e.clientX, y: e.clientY, graphNodeId: node.id as GraphNodeId });
+            e.preventDefault();
-        }}
+            setMenu({ x: e.clientX, y: e.clientY, graphNodeId: node.id as GraphNodeId });
-        onPaneClick={() => {
+          }}
-          setMenu(null);
+          onPaneClick={() => {
-        }}
+            setMenu(null);
-        onPaneContextMenu={(e) => {
+          }}
-          e.preventDefault();
+          onPaneContextMenu={(e) => {
-          setMenu(null);
+            e.preventDefault();
-        }}
+            setMenu(null);
-        onInit={(instance) => {
+          }}
-          instance.fitView({ padding: 0.25 });
+          onInit={(instance) => {
-        }}
+            instance.fitView({ padding: 0.25 });
-        onDragOver={onDragOver}
+          }}
-        onDrop={onDrop}
+          onDragOver={onDragOver}
-        panOnScroll
+          onDrop={onDrop}
-        selectionOnDrag={false}
+          panOnScroll
-        deleteKeyCode={['Backspace', 'Delete']}
+          selectionOnDrag={false}
-        proOptions={{ hideAttribution: true }}
+          deleteKeyCode={['Backspace', 'Delete']}
-      >
+          proOptions={{ hideAttribution: true }}
-        <Background gap={18} size={1} color="rgba(255,255,255,0.06)" />
+        >
-        <GraphZoomToolbar />
+          <Background gap={18} size={1} color="rgba(255,255,255,0.06)" />
-      </ReactFlow>
+          <GraphZoomToolbar />
-      {menu && menuPosition
+        </ReactFlow>
-        ? createPortal(
+        {menu && menuPosition
-            <>
+          ? createPortal(
-              <button
+              <>
-                type="button"
-                aria-label="Закрыть меню"
-                className={styles.menuBackdrop}
-                onClick={() => setMenu(null)}
-              />
-              <div
-                role="menu"
-                tabIndex={-1}
-                className={styles.ctxMenu}
-                style={{ left: menuPosition.x, top: menuPosition.y }}
-                onClick={(e) => e.stopPropagation()}
-                onKeyDown={(e) => {
-                  if (e.key === 'Escape') setMenu(null);
-                }}
-              >
                 <button
                   type="button"
-                  role="menuitem"
+                  aria-label={ui.closeMenu}
-                  className={styles.ctxItem}
+                  className={styles.menuBackdrop}
-                  onClick={() => {
+                  onClick={() => setMenu(null)}
-                    if (menuNodeIsStart) {
+                />
-                      onSetGraphNodeStart(null);
+                <div
-                    } else {
+                  role="menu"
-                      onSetGraphNodeStart(menu.graphNodeId);
+                  tabIndex={-1}
-                    }
+                  className={styles.ctxMenu}
-                    setMenu(null);
+                  style={{ left: menuPosition.x, top: menuPosition.y }}
+                  onClick={(e) => e.stopPropagation()}
+                  onKeyDown={(e) => {
+                    if (e.key === 'Escape') setMenu(null);
                   }}
                 >
-                  {menuNodeIsStart ? 'Снять метку «Начальная сцена»' : 'Начальная сцена'}
+                  <button
-                </button>
+                    type="button"
-                <button
+                    role="menuitem"
-                  type="button"
+                    className={styles.ctxItem}
-                  role="menuitem"
+                    onClick={() => {
-                  className={styles.ctxItemDanger}
+                      if (menuNodeIsStart) {
-                  onClick={() => {
+                        onSetGraphNodeStart(null);
-                    onRemoveGraphNode(menu.graphNodeId);
+                      } else {
-                    setMenu(null);
+                        onSetGraphNodeStart(menu.graphNodeId);
-                  }}
+                      }
-                >
+                      setMenu(null);
-                  Удалить
+                    }}
-                </button>
+                  >
-              </div>
+                    {menuNodeIsStart ? ui.unsetStartScene : ui.startScene}
-            </>,
+                  </button>
-            document.body,
+                  <button
-          )
+                    type="button"
-        : null}
+                    role="menuitem"
-    </div>
+                    className={styles.ctxItemDanger}
+                    onClick={() => {
+                      onRemoveGraphNode(menu.graphNodeId);
+                      setMenu(null);
+                    }}
+                  >
+                    {ui.delete}
+                  </button>
+                </div>
+              </>,
+              document.body,
+            )
+          : null}
+      </div>
+    </GraphUiContext.Provider>
   );
 }
 

app/renderer/editor/i18n/EditorI18nContext.tsx

@@ -0,0 +1,55 @@
+import React, { createContext, useCallback, useContext, useMemo, useState } from 'react';
+
+import {
+  EDITOR_LOCALE_STORAGE_KEY,
+  inferEditorLocaleFromSystem,
+  normalizeEditorLocale,
+  translateEditorMessage,
+  type EditorLocale,
+} from './editorMessages';
+
+type EditorI18nContextValue = {
+  locale: EditorLocale;
+  setLocale: (next: EditorLocale) => void;
+  t: (key: string, vars?: Record<string, string | number>) => string;
+};
+
+const EditorI18nContext = createContext<EditorI18nContextValue | null>(null);
+
+function readInitialLocale(): EditorLocale {
+  try {
+    return normalizeEditorLocale(localStorage.getItem(EDITOR_LOCALE_STORAGE_KEY));
+  } catch {
+    return inferEditorLocaleFromSystem();
+  }
+}
+
+export function EditorI18nProvider({ children }: { children: React.ReactNode }) {
+  const [locale, setLocaleState] = useState<EditorLocale>(readInitialLocale);
+
+  const setLocale = useCallback((next: EditorLocale) => {
+    setLocaleState(next);
+    try {
+      localStorage.setItem(EDITOR_LOCALE_STORAGE_KEY, next);
+    } catch {
+      // ignore
+    }
+  }, []);
+
+  const t = useCallback(
+    (key: string, vars?: Record<string, string | number>) => translateEditorMessage(locale, key, vars),
+    [locale],
+  );
+
+  const value = useMemo<EditorI18nContextValue>(() => ({ locale, setLocale, t }), [locale, setLocale, t]);
+
+  return <EditorI18nContext.Provider value={value}>{children}</EditorI18nContext.Provider>;
+}
+
+export function useEditorI18n(): EditorI18nContextValue {
+  const ctx = useContext(EditorI18nContext);
+  if (!ctx) {
+    throw new Error('useEditorI18n must be used within EditorI18nProvider');
+  }
+  return ctx;
+}

app/renderer/editor/i18n/editorMessages.locale.test.ts

@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { inferEditorLocaleFromSystem, normalizeEditorLocale } from './editorMessages';
+
+void test('inferEditorLocaleFromSystem: en-* wins when listed first', () => {
+  assert.equal(inferEditorLocaleFromSystem(['en-GB', 'ru-RU']), 'en');
+});
+
+void test('inferEditorLocaleFromSystem: ru-* wins when listed first', () => {
+  assert.equal(inferEditorLocaleFromSystem(['ru-RU', 'en-US']), 'ru');
+});
+
+void test('inferEditorLocaleFromSystem: unknown tags fall back to ru', () => {
+  assert.equal(inferEditorLocaleFromSystem(['de-DE', 'fr']), 'ru');
+});
+
+void test('inferEditorLocaleFromSystem: empty list → ru', () => {
+  assert.equal(inferEditorLocaleFromSystem([]), 'ru');
+});
+
+void test('normalizeEditorLocale: trims stored en/ru', () => {
+  assert.equal(normalizeEditorLocale(' EN '), 'en');
+  assert.equal(normalizeEditorLocale('ru '), 'ru');
+});
+
+void test('normalizeEditorLocale: blank or invalid defers to infer (explicit list)', () => {
+  assert.equal(normalizeEditorLocale(''), inferEditorLocaleFromSystem([]));
+  assert.equal(normalizeEditorLocale('xx'), inferEditorLocaleFromSystem([]));
+});

app/renderer/editor/i18n/editorMessages.ts

@@ -0,0 +1,522 @@
+export type EditorLocale = 'ru' | 'en';
+
+export const EDITOR_LOCALE_STORAGE_KEY = 'dnd_editor_locale';
+
+function primaryLanguageTag(lang: string): string {
+  const trimmed = lang.trim().toLowerCase();
+  if (!trimmed) return '';
+  const sep = trimmed.search(/[-_]/);
+  return sep === -1 ? trimmed : trimmed.slice(0, sep);
+}
+
+/**
+ * Выбор `ru` / `en` по языку ОС/браузера, если пользователь ещё не сохранил язык в `localStorage`.
+ * В Electron совпадает с локалью системы (Chromium подставляет `navigator.languages`).
+ */
+export function inferEditorLocaleFromSystem(languages?: readonly string[]): EditorLocale {
+  let list: string[];
+  if (languages !== undefined) {
+    list = [...languages];
+  } else if (typeof navigator !== 'undefined') {
+    list = [...navigator.languages];
+    if (navigator.language) {
+      list.push(navigator.language);
+    }
+    list = list.filter((x) => x.trim() !== '');
+  } else {
+    list = [];
+  }
+  for (const lang of list) {
+    const tag = primaryLanguageTag(lang);
+    if (tag === 'en') return 'en';
+    if (tag === 'ru') return 'ru';
+  }
+  return 'ru';
+}
+
+export function normalizeEditorLocale(raw: string | null | undefined): EditorLocale {
+  if (raw == null) {
+    return inferEditorLocaleFromSystem();
+  }
+  const trimmed = raw.trim();
+  if (trimmed === '') {
+    return inferEditorLocaleFromSystem();
+  }
+  const s = trimmed.toLowerCase();
+  if (s === 'en') return 'en';
+  if (s === 'ru') return 'ru';
+  return inferEditorLocaleFromSystem();
+}
+
+/** Flat message table; `{name}` placeholders supported in `translate`. */
+export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
+  ru: {
+    'common.close': 'Закрыть',
+    'common.cancel': 'Отмена',
+    'common.save': 'Сохранить',
+    'common.understood': 'Понятно',
+    'common.message': 'Сообщение',
+    'common.error': 'Ошибка',
+    'common.delete': 'Удалить',
+    'common.closeMenu': 'Закрыть меню',
+
+    'notice.campaignAudioEmpty': 'Аудио не добавлено. Проверьте формат файла.',
+
+    'license.checkingTitle': 'Проверка лицензии…',
+    'license.checkingWait': 'Подождите.',
+    'license.requiredTitle': 'Требуется лицензия',
+    'license.requiredHint':
+      'Укажите ключ в меню «Настройки» → «Указать ключ». До активации доступно только меню «Настройки».',
+    'license.tokenTitle': 'Указать ключ',
+    'license.tokenKey': 'КЛЮЧ',
+    'license.tokenPlaceholder': 'Продуктовый ключ DND-...',
+    'license.tokenSaving': 'Сохранение…',
+    'license.eulaTitle': 'Лицензионное соглашение',
+    'license.eulaReject': 'Не принимаю',
+    'license.eulaAccept': 'Принимаю условия',
+    'license.eulaNoteEn':
+      'The binding legal text below is in Russian. If you need an English summary, contact support.',
+    'license.aboutTitle': 'О лицензии',
+    'license.aboutDevSkip': 'Режим разработки: проверка лицензии отключена (DND_SKIP_LICENSE).',
+    'license.aboutStatus': 'СТАТУС',
+    'license.aboutProduct': 'ПРОДУКТ',
+    'license.aboutLicenseId': 'ID ЛИЦЕНЗИИ',
+    'license.aboutExpiry': 'ОКОНЧАНИЕ',
+    'license.aboutDevice': 'УСТРОЙСТВО',
+    'license.aboutNoData': 'Нет данных лицензии.',
+    'license.reason.ok': 'Активна',
+    'license.reason.none': 'Ключ не указан',
+    'license.reason.expired': 'Срок действия истёк',
+    'license.reason.bad_signature': 'Недействительная подпись',
+    'license.reason.bad_payload': 'Неверный формат токена',
+    'license.reason.malformed': 'Повреждённый токен',
+    'license.reason.not_yet_valid': 'Ещё не действует',
+    'license.reason.wrong_device': 'Другой привязанный компьютер',
+    'license.reason.revoked_remote': 'Отозвана на сервере',
+
+    'presentation.overlay': 'Презентация запущена',
+    'presentation.title': 'Презентация запущена',
+    'presentation.body':
+      'Редактор заблокирован. Закройте окна «Презентация» и «Панель управления», чтобы продолжить.',
+
+    'zip.progress': 'Прогресс операции',
+    'zip.importTitle': 'Импорт проекта',
+    'zip.exportTitle': 'Экспорт проекта',
+
+    'top.settings': 'Настройки',
+    'top.project': 'Проект',
+    'top.file': 'Файл',
+    'top.backToProjects': 'К списку проектов',
+    'top.appVersion': 'Версия приложения',
+    'top.run': 'Запустить',
+    'top.afterLicense': 'Доступно после активации лицензии',
+    'top.setStartScene': 'Назначьте начальную сцену на графе (ПКМ по узлу)',
+
+    'menu.enterKey': 'Указать ключ',
+    'menu.aboutLicense': 'О лицензии',
+    'menu.checkUpdates': 'Проверить обновления',
+    'menu.language': 'Язык',
+    'menu.langRu': 'Русский',
+    'menu.langEn': 'English',
+
+    'updates.dialogTitle': 'Обновления',
+    'updates.checking': 'Проверка наличия обновлений…',
+    'updates.available': 'Доступна новая версия {version}.',
+    'updates.current': 'У вас установлена актуальная версия ({version}).',
+    'updates.error': 'Не удалось проверить обновления: {message}',
+    'updates.notPackaged': 'Проверка доступна только в установленной версии приложения.',
+    'updates.noLicense': 'Нужна активная лицензия.',
+    'updates.download': 'Обновить',
+    'updates.downloading': 'Загрузка…',
+
+    'projectMenu.home': 'Начальный экран',
+    'projectMenu.import': 'Импорт',
+    'projectMenu.export': 'Экспорт',
+    'projectMenu.noProjects': 'Нет сохранённых проектов',
+
+    'fileMenu.rename': 'Переименовать проект',
+
+    'scenes.search': 'Поиск сцен…',
+    'scenes.new': '+ Новая сцена',
+    'scenes.inspectorGame': 'Свойства игры',
+    'scenes.inspectorScene': 'Свойства сцены',
+    'scenes.selectHint': 'Выберите сцену слева, чтобы редактировать её свойства.',
+    'scenes.openProjectHint': 'Откройте проект, чтобы редактировать кампанию и сцены.',
+
+    'rename.title': 'Переименовать проект',
+    'rename.projectName': 'НАЗВАНИЕ ПРОЕКТА',
+    'rename.projectPlaceholder': 'Название проекта…',
+    'rename.projectMin': 'Минимум 3 символа.',
+    'rename.projectDup': 'Проект с таким названием уже существует.',
+    'rename.fileName': 'НАЗВАНИЕ ФАЙЛА ПРОЕКТА',
+    'rename.fileInvalid': 'Минимум 3 символа, без символов <>:"/\\|?*',
+    'rename.fileDup': 'Файл проекта с таким названием уже существует.',
+    'rename.saving': 'Сохранение…',
+
+    'export.title': 'Экспорт проекта',
+    'export.project': 'ПРОЕКТ',
+    'export.hint':
+      'Далее откроется окно сохранения: укажите имя и папку для файла .dnd.zip — будет создана копия архива проекта.',
+    'export.exporting': 'Экспорт…',
+    'export.saveAs': 'Сохранить как…',
+
+    'confirmDelete.title': 'Удаление проекта',
+    'confirmDelete.body': 'Удалить проект «{name}» безвозвратно? Файл и кэш будут стёрты с диска.',
+    'confirmDelete.failedTitle': 'Не удалось удалить',
+
+    'picker.title': 'Проекты',
+    'picker.newPlaceholder': 'Название нового проекта…',
+    'picker.create': 'Создать проект',
+    'picker.existing': 'СУЩЕСТВУЮЩИЕ',
+    'picker.lockedHint':
+      'Открытие и создание — после активации лицензии. Список показывает файлы в папке приложения.',
+    'picker.empty': 'Пока нет проектов.',
+    'picker.projectMenu': 'Меню проекта',
+    'picker.openDisabled': 'Открытие проекта — после активации лицензии',
+    'picker.defaultName': 'Моя кампания',
+
+    'campaign.label': 'АУДИО ИГРЫ',
+    'campaign.noFiles': 'Файлов пока нет. Добавьте аудио.',
+    'campaign.auto': 'Авто',
+    'campaign.loop': 'Цикл',
+    'campaign.removeTitle': 'Убрать из кампании',
+    'campaign.upload': 'Загрузить',
+
+    'scene.title': 'НАЗВАНИЕ СЦЕНЫ',
+    'scene.description': 'ОПИСАНИЕ',
+    'scene.preview': 'ПРЕВЬЮ СЦЕНЫ',
+    'scene.previewHint': 'Файл изображения (PNG, JPG, WebP, GIF и т.д.).',
+    'scene.previewEmpty': 'Превью не задано',
+    'scene.previewBusy': 'Загрузка и оптимизация изображения…',
+    'scene.change': 'Изменить',
+    'scene.clear': 'Очистить',
+    'scene.autostart': 'Автостарт',
+    'scene.rotate': 'Повернуть',
+    'scene.audio': 'АУДИО СЦЕНЫ',
+    'scene.removeTitle': 'Убрать из сцены',
+    'scene.branching': 'ВЕТВЛЕНИЯ',
+    'scene.branchingHint':
+      'Перетащите сцену из списка на граф. С одной карточки можно задать несколько вариантов — по одной связи на каждую целевую сцену. Повторно к той же сцене (включая вторую карточку той же сцены на графе) подключить нельзя.',
+
+    'sceneCard.current': 'ТЕКУЩАЯ',
+    'sceneCard.menu': 'Меню сцены',
+
+    'graph.badgeStart': 'НАЧАЛО',
+    'graph.untitled': 'Без названия',
+    'graph.videoBadge': 'Видео',
+    'graph.audioBadge': 'Аудио',
+    'graph.loop': 'Цикл',
+    'graph.autoplay': 'Автостарт',
+    'graph.previewAutostart': 'Авто превью',
+    'graph.videoLoop': 'Цикл видео',
+    'graph.zoomBar': 'Масштаб графа',
+    'graph.zoomIn': 'Увеличить',
+    'graph.zoomOut': 'Уменьшить',
+    'graph.fitAll': 'Показать всё',
+    'graph.startScene': 'Начальная сцена',
+    'graph.unsetStartScene': 'Снять метку «Начальная сцена»',
+
+    'control.remoteTitle': 'ПУЛЬТ УПРАВЛЕНИЯ',
+    'control.effects': 'ЭФФЕКТЫ',
+    'control.tools': 'Инструменты',
+    'control.fieldEffects': 'Эффекты поля',
+    'control.actionEffects': 'Эффекты действий',
+    'control.eraser': 'Ластик',
+    'control.clearEffects': 'Очистить эффекты',
+    'control.fog': 'Туман',
+    'control.rain': 'Дождь',
+    'control.fire': 'Огонь',
+    'control.water': 'Вода',
+    'control.lightning': 'Молния',
+    'control.sunbeam': 'Луч света',
+    'control.freeze': 'Заморозка',
+    'control.poisonCloud': 'Облако яда',
+    'control.brushRadius': 'Радиус кисти',
+    'control.storyLine': 'СЮЖЕТНАЯ ЛИНИЯ',
+    'control.gotoScene': 'Перейти к этой сцене',
+    'control.currentSceneBadge': 'ТЕКУЩАЯ СЦЕНА',
+    'control.passed': 'Пройдено',
+    'control.noActiveScene': 'Нет активной сцены.',
+    'control.screenPreview': 'Предпросмотр экрана',
+    'control.stopPresentation': 'Выключить демонстрацию',
+    'control.videoBrushHint':
+      'Видео-превью: кисть эффектов отключена (как на экране демонстрации — оверлей только для изображения).',
+    'control.branches': 'Варианты ветвления',
+    'control.option': 'ОПЦИЯ {n}',
+    'control.unnamed': 'Без названия',
+    'control.switchScene': 'Переключить',
+    'control.noBranches': 'Нет вариантов перехода.',
+    'control.endPresentation': 'Завершить показ',
+    'control.music': 'Музыка',
+    'control.sceneMusic': 'МУЗЫКА СЦЕНЫ',
+    'control.gameMusic': 'МУЗЫКА ИГРЫ',
+    'control.noSceneAudio': 'В текущей сцене нет аудио.',
+    'control.noGameAudio': 'В игре нет аудио.',
+    'control.modeAuto': 'Авто',
+    'control.modeManual': 'Ручн.',
+    'control.once': 'Один раз',
+    'control.loop': 'Цикл',
+    'control.scrubSeek': 'Клик — перемотка',
+    'control.durationUnknown': 'Длительность неизвестна',
+    'control.pauseSceneMusic': 'Пауза (сцена)',
+    'control.pauseSceneMusicTitle': 'В сцене есть музыка',
+    'control.pauseCampaignTitle': 'Пауза: в сцене есть музыка',
+    'control.playFailed': 'Не удалось запустить.',
+    'control.audioAutoplayBlocked':
+      'Автозапуск заблокирован (нужно действие пользователя) или ошибка воспроизведения.',
+    'control.audioNoUrl': 'URL не получен',
+    'control.audioNoUrlDetail': 'Не удалось получить dnd://asset URL для аудио.',
+    'control.audioBlocked': 'Ошибка/блок',
+    'control.audioError': 'Ошибка',
+    'control.audioMediaError': 'MediaError code={code} (1=ABORTED, 2=NETWORK, 3=DECODE, 4=SRC_NOT_SUPPORTED)',
+    'control.audioLoading': 'Загрузка…',
+    'control.audioPlaying': 'Играет',
+    'control.audioPaused': 'Пауза',
+    'control.audioStopped': 'Остановлено',
+    'control.previewTrackLabel': 'Превью без субтитров',
+    'control.transportPlay': 'Воспроизведение',
+    'control.transportPause': 'Пауза',
+    'control.transportStop': 'Стоп',
+  },
+  en: {
+    'common.close': 'Close',
+    'common.cancel': 'Cancel',
+    'common.save': 'Save',
+    'common.understood': 'OK',
+    'common.message': 'Message',
+    'common.error': 'Error',
+    'common.delete': 'Delete',
+    'common.closeMenu': 'Close menu',
+
+    'notice.campaignAudioEmpty': 'No audio was added. Check the file format.',
+
+    'license.checkingTitle': 'Checking license…',
+    'license.checkingWait': 'Please wait.',
+    'license.requiredTitle': 'License required',
+    'license.requiredHint':
+      'Enter your key via Settings → Enter license key. Until activation, only Settings is available.',
+    'license.tokenTitle': 'Enter license key',
+    'license.tokenKey': 'KEY',
+    'license.tokenPlaceholder': 'DND product key…',
+    'license.tokenSaving': 'Saving…',
+    'license.eulaTitle': 'End User License Agreement',
+    'license.eulaReject': 'Decline',
+    'license.eulaAccept': 'I accept the terms',
+    'license.eulaNoteEn':
+      'The binding legal text below is in Russian. If you need an English summary, contact support.',
+    'license.aboutTitle': 'About license',
+    'license.aboutDevSkip': 'Development mode: license checks are disabled (DND_SKIP_LICENSE).',
+    'license.aboutStatus': 'STATUS',
+    'license.aboutProduct': 'PRODUCT',
+    'license.aboutLicenseId': 'LICENSE ID',
+    'license.aboutExpiry': 'EXPIRES',
+    'license.aboutDevice': 'DEVICE',
+    'license.aboutNoData': 'No license data.',
+    'license.reason.ok': 'Active',
+    'license.reason.none': 'No key provided',
+    'license.reason.expired': 'Expired',
+    'license.reason.bad_signature': 'Invalid signature',
+    'license.reason.bad_payload': 'Invalid token format',
+    'license.reason.malformed': 'Malformed token',
+    'license.reason.not_yet_valid': 'Not yet valid',
+    'license.reason.wrong_device': 'Wrong bound device',
+    'license.reason.revoked_remote': 'Revoked on server',
+
+    'presentation.overlay': 'Presentation running',
+    'presentation.title': 'Presentation running',
+    'presentation.body': 'The editor is locked. Close the Presentation and Control windows to continue.',
+
+    'zip.progress': 'Operation progress',
+    'zip.importTitle': 'Import project',
+    'zip.exportTitle': 'Export project',
+
+    'top.settings': 'Settings',
+    'top.project': 'Project',
+    'top.file': 'File',
+    'top.backToProjects': 'Back to projects',
+    'top.appVersion': 'App version',
+    'top.run': 'Run',
+    'top.afterLicense': 'Available after license activation',
+    'top.setStartScene': 'Set a start scene on the graph (right‑click a node)',
+
+    'menu.enterKey': 'Enter license key',
+    'menu.aboutLicense': 'About license',
+    'menu.checkUpdates': 'Check for updates',
+    'menu.language': 'Language',
+    'menu.langRu': 'Русский',
+    'menu.langEn': 'English',
+
+    'updates.dialogTitle': 'Updates',
+    'updates.checking': 'Checking for updates…',
+    'updates.available': 'A new version is available: {version}.',
+    'updates.current': 'You have the latest version ({version}).',
+    'updates.error': 'Could not check for updates: {message}',
+    'updates.notPackaged': 'Updates can only be checked in the installed application.',
+    'updates.noLicense': 'An active license is required.',
+    'updates.download': 'Update',
+    'updates.downloading': 'Downloading…',
+
+    'projectMenu.home': 'Home',
+    'projectMenu.import': 'Import',
+    'projectMenu.export': 'Export',
+    'projectMenu.noProjects': 'No saved projects',
+
+    'fileMenu.rename': 'Rename project',
+
+    'scenes.search': 'Search scenes…',
+    'scenes.new': '+ New scene',
+    'scenes.inspectorGame': 'Game properties',
+    'scenes.inspectorScene': 'Scene properties',
+    'scenes.selectHint': 'Select a scene on the left to edit its properties.',
+    'scenes.openProjectHint': 'Open a project to edit the campaign and scenes.',
+
+    'rename.title': 'Rename project',
+    'rename.projectName': 'PROJECT NAME',
+    'rename.projectPlaceholder': 'Project name…',
+    'rename.projectMin': 'At least 3 characters.',
+    'rename.projectDup': 'A project with this name already exists.',
+    'rename.fileName': 'PROJECT FILE NAME',
+    'rename.fileInvalid': 'At least 3 characters; forbidden characters <>:"/\\|?*',
+    'rename.fileDup': 'A project file with this name already exists.',
+    'rename.saving': 'Saving…',
+
+    'export.title': 'Export project',
+    'export.project': 'PROJECT',
+    'export.hint':
+      'A save dialog will open: choose a name and folder for the .dnd.zip file — a copy of the project archive will be created.',
+    'export.exporting': 'Exporting…',
+    'export.saveAs': 'Save as…',
+
+    'confirmDelete.title': 'Delete project',
+    'confirmDelete.body':
+      'Permanently delete project “{name}”? The file and cache will be removed from disk.',
+    'confirmDelete.failedTitle': 'Could not delete',
+
+    'picker.title': 'Projects',
+    'picker.newPlaceholder': 'New project name…',
+    'picker.create': 'Create project',
+    'picker.existing': 'EXISTING',
+    'picker.lockedHint':
+      'Opening and creating projects require an active license. The list still shows files in the app folder.',
+    'picker.empty': 'No projects yet.',
+    'picker.projectMenu': 'Project menu',
+    'picker.openDisabled': 'Open project — after license activation',
+    'picker.defaultName': 'My campaign',
+
+    'campaign.label': 'GAME AUDIO',
+    'campaign.noFiles': 'No files yet. Add audio.',
+    'campaign.auto': 'Auto',
+    'campaign.loop': 'Loop',
+    'campaign.removeTitle': 'Remove from campaign',
+    'campaign.upload': 'Upload',
+
+    'scene.title': 'SCENE TITLE',
+    'scene.description': 'DESCRIPTION',
+    'scene.preview': 'SCENE PREVIEW',
+    'scene.previewHint': 'Image file (PNG, JPG, WebP, GIF, etc.).',
+    'scene.previewEmpty': 'No preview',
+    'scene.previewBusy': 'Loading and optimizing image…',
+    'scene.change': 'Change',
+    'scene.clear': 'Clear',
+    'scene.autostart': 'Autostart',
+    'scene.rotate': 'Rotate',
+    'scene.audio': 'SCENE AUDIO',
+    'scene.removeTitle': 'Remove from scene',
+    'scene.branching': 'BRANCHING',
+    'scene.branchingHint':
+      'Drag a scene from the list onto the graph. One card can branch to several targets — one link per target scene. You cannot link twice to the same target (including a second card of the same scene).',
+
+    'sceneCard.current': 'CURRENT',
+    'sceneCard.menu': 'Scene menu',
+
+    'graph.badgeStart': 'START',
+    'graph.untitled': 'Untitled',
+    'graph.videoBadge': 'Video',
+    'graph.audioBadge': 'Audio',
+    'graph.loop': 'Loop',
+    'graph.autoplay': 'Autoplay',
+    'graph.previewAutostart': 'Preview autostart',
+    'graph.videoLoop': 'Video loop',
+    'graph.zoomBar': 'Graph zoom',
+    'graph.zoomIn': 'Zoom in',
+    'graph.zoomOut': 'Zoom out',
+    'graph.fitAll': 'Fit view',
+    'graph.startScene': 'Start scene',
+    'graph.unsetStartScene': 'Clear start scene mark',
+
+    'control.remoteTitle': 'CONTROL PANEL',
+    'control.effects': 'EFFECTS',
+    'control.tools': 'Tools',
+    'control.fieldEffects': 'Field effects',
+    'control.actionEffects': 'Action effects',
+    'control.eraser': 'Eraser',
+    'control.clearEffects': 'Clear effects',
+    'control.fog': 'Fog',
+    'control.rain': 'Rain',
+    'control.fire': 'Fire',
+    'control.water': 'Water',
+    'control.lightning': 'Lightning',
+    'control.sunbeam': 'Sunbeam',
+    'control.freeze': 'Freeze',
+    'control.poisonCloud': 'Poison cloud',
+    'control.brushRadius': 'Brush radius',
+    'control.storyLine': 'STORYLINE',
+    'control.gotoScene': 'Go to this scene',
+    'control.currentSceneBadge': 'CURRENT SCENE',
+    'control.passed': 'Visited',
+    'control.noActiveScene': 'No active scene.',
+    'control.screenPreview': 'Screen preview',
+    'control.stopPresentation': 'Stop presentation',
+    'control.videoBrushHint':
+      'Video preview: effect brush is disabled (like on the presentation screen — overlay is for images only).',
+    'control.branches': 'Branch options',
+    'control.option': 'OPTION {n}',
+    'control.unnamed': 'Untitled',
+    'control.switchScene': 'Switch',
+    'control.noBranches': 'No transitions available.',
+    'control.endPresentation': 'End presentation',
+    'control.music': 'Music',
+    'control.sceneMusic': 'SCENE MUSIC',
+    'control.gameMusic': 'GAME MUSIC',
+    'control.noSceneAudio': 'No audio in the current scene.',
+    'control.noGameAudio': 'No game audio.',
+    'control.modeAuto': 'Auto',
+    'control.modeManual': 'Manual',
+    'control.once': 'Once',
+    'control.loop': 'Loop',
+    'control.scrubSeek': 'Click to seek',
+    'control.durationUnknown': 'Duration unknown',
+    'control.pauseSceneMusic': 'Paused (scene)',
+    'control.pauseSceneMusicTitle': 'Scene has music',
+    'control.pauseCampaignTitle': 'Paused: scene has music',
+    'control.playFailed': 'Could not start playback.',
+    'control.audioAutoplayBlocked': 'Autoplay was blocked (user gesture required) or playback failed.',
+    'control.audioNoUrl': 'No URL',
+    'control.audioNoUrlDetail': 'Could not get dnd://asset URL for audio.',
+    'control.audioBlocked': 'Error / blocked',
+    'control.audioError': 'Error',
+    'control.audioMediaError': 'MediaError code={code} (1=ABORTED, 2=NETWORK, 3=DECODE, 4=SRC_NOT_SUPPORTED)',
+    'control.audioLoading': 'Loading…',
+    'control.audioPlaying': 'Playing',
+    'control.audioPaused': 'Paused',
+    'control.audioStopped': 'Stopped',
+    'control.previewTrackLabel': 'Preview (no captions)',
+    'control.transportPlay': 'Play',
+    'control.transportPause': 'Pause',
+    'control.transportStop': 'Stop',
+  },
+};
+
+export function translateEditorMessage(
+  locale: EditorLocale,
+  key: string,
+  vars?: Record<string, string | number>,
+): string {
+  let s = EDITOR_MESSAGES[locale][key] ?? EDITOR_MESSAGES.ru[key] ?? key;
+  if (vars) {
+    for (const [k, v] of Object.entries(vars)) {
+      s = s.split(`{${k}}`).join(String(v));
+    }
+  }
+  return s;
+}

app/renderer/editor/license/EditorLicenseModals.tsx

@@ -8,6 +8,7 @@ import { EULA_RU_MARKDOWN } from '../../legal/eulaRu';
 import { getDndApi } from '../../shared/dndApi';
 import { Button } from '../../shared/ui/controls';
 import styles from '../EditorApp.module.css';
+import { useEditorI18n } from '../i18n/EditorI18nContext';
 
 type LicenseTokenModalProps = {
   open: boolean;
@@ -16,6 +17,7 @@ type LicenseTokenModalProps = {
 };
 
 export function LicenseTokenModal({ open, onClose, onSaved }: LicenseTokenModalProps) {
+  const { t } = useEditorI18n();
   const [token, setToken] = useState('');
   const [saving, setSaving] = useState(false);
   const [error, setError] = useState<string | null>(null);
@@ -40,28 +42,38 @@ export function LicenseTokenModal({ open, onClose, onSaved }: LicenseTokenModalP
 
   return createPortal(
     <>
-      <button type="button" aria-label="Закрыть" onClick={onClose} className={styles.modalBackdrop} />
+      <button
+        type="button"
+        aria-label={t('common.close')}
+        onClick={onClose}
+        className={styles.modalBackdrop}
+      />
       <div role="dialog" aria-modal="true" className={styles.modalDialog}>
         <div className={styles.modalHeader}>
-          <div className={styles.modalTitle}>Указать ключ</div>
+          <div className={styles.modalTitle}>{t('license.tokenTitle')}</div>
-          <button type="button" aria-label="Закрыть" onClick={onClose} className={styles.modalClose}>
+          <button
+            type="button"
+            aria-label={t('common.close')}
+            onClick={onClose}
+            className={styles.modalClose}
+          >
             ×
           </button>
         </div>
         <div className={styles.fieldGrid}>
-          <div className={styles.fieldLabel}>КЛЮЧ</div>
+          <div className={styles.fieldLabel}>{t('license.tokenKey')}</div>
           <textarea
             className={styles.licenseTextarea}
             value={token}
             onChange={(e) => setToken(e.target.value)}
-            placeholder="Продуктовый ключ DND-..."
+            placeholder={t('license.tokenPlaceholder')}
             spellCheck={false}
           />
         </div>
         {error ? <div className={styles.fieldError}>{error}</div> : null}
         <div className={styles.modalFooter}>
           <Button onClick={onClose} disabled={saving}>
-            Отмена
+            {t('common.cancel')}
           </Button>
           <Button
             variant="primary"
@@ -82,7 +94,7 @@ export function LicenseTokenModal({ open, onClose, onSaved }: LicenseTokenModalP
               })();
             }}
           >
-            Сохранить
+            {t('common.save')}
           </Button>
         </div>
       </div>
@@ -98,6 +110,7 @@ type EulaModalProps = {
 };
 
 export function EulaModal({ open, onClose, onAccepted }: EulaModalProps) {
+  const { t, locale } = useEditorI18n();
   const [saving, setSaving] = useState(false);
 
   useEffect(() => {
@@ -113,18 +126,29 @@ export function EulaModal({ open, onClose, onAccepted }: EulaModalProps) {
 
   return createPortal(
     <>
-      <button type="button" aria-label="Закрыть" onClick={onClose} className={styles.modalBackdrop} />
+      <button
+        type="button"
+        aria-label={t('common.close')}
+        onClick={onClose}
+        className={styles.modalBackdrop}
+      />
       <div role="dialog" aria-modal="true" className={styles.modalDialog}>
         <div className={styles.modalHeader}>
-          <div className={styles.modalTitle}>Лицензионное соглашение</div>
+          <div className={styles.modalTitle}>{t('license.eulaTitle')}</div>
-          <button type="button" aria-label="Закрыть" onClick={onClose} className={styles.modalClose}>
+          <button
+            type="button"
+            aria-label={t('common.close')}
+            onClick={onClose}
+            className={styles.modalClose}
+          >
             ×
           </button>
         </div>
+        {locale === 'en' ? <div className={styles.muted}>{t('license.eulaNoteEn')}</div> : null}
         <div className={styles.eulaScroll}>{EULA_RU_MARKDOWN}</div>
         <div className={styles.modalFooter}>
           <Button onClick={onClose} disabled={saving}>
-            Не принимаю
+            {t('license.eulaReject')}
           </Button>
           <Button
             variant="primary"
@@ -144,7 +168,7 @@ export function EulaModal({ open, onClose, onAccepted }: EulaModalProps) {
               })();
             }}
           >
-            Принимаю условия
+            {t('license.eulaAccept')}
           </Button>
         </div>
       </div>
@@ -159,32 +183,16 @@ type LicenseAboutModalProps = {
   snapshot: LicenseSnapshot | null;
 };
 
-function reasonLabel(reason: LicenseSnapshot['reason']): string {
+function licenseReasonLabel(t: (key: string) => string, reason: LicenseSnapshot['reason']): string {
-  switch (reason) {
+  const key = `license.reason.${reason}`;
-    case 'ok':
+  const label = t(key);
-      return 'Активна';
+  return label === key ? reason : label;
-    case 'none':
-      return 'Ключ не указан';
-    case 'expired':
-      return 'Срок действия истёк';
-    case 'bad_signature':
-      return 'Недействительная подпись';
-    case 'bad_payload':
-      return 'Неверный формат токена';
-    case 'malformed':
-      return 'Повреждённый токен';
-    case 'not_yet_valid':
-      return 'Ещё не действует';
-    case 'wrong_device':
-      return 'Другой привязанный компьютер';
-    case 'revoked_remote':
-      return 'Отозвана на сервере';
-    default:
-      return reason;
-  }
 }
 
 export function LicenseAboutModal({ open, onClose, snapshot }: LicenseAboutModalProps) {
+  const { t, locale } = useEditorI18n();
+  const dateLocale = locale === 'en' ? 'en-US' : 'ru-RU';
+
   useEffect(() => {
     if (!open) return;
     const onKey = (e: KeyboardEvent) => {
@@ -198,7 +206,7 @@ export function LicenseAboutModal({ open, onClose, snapshot }: LicenseAboutModal
 
   const expText =
     snapshot?.summary?.exp != null
-      ? new Date(snapshot.summary.exp * 1000).toLocaleString('ru-RU', {
+      ? new Date(snapshot.summary.exp * 1000).toLocaleString(dateLocale, {
           dateStyle: 'long',
           timeStyle: 'short',
         })
@@ -206,48 +214,54 @@ export function LicenseAboutModal({ open, onClose, snapshot }: LicenseAboutModal
 
   return createPortal(
     <>
-      <button type="button" aria-label="Закрыть" onClick={onClose} className={styles.modalBackdrop} />
+      <button
+        type="button"
+        aria-label={t('common.close')}
+        onClick={onClose}
+        className={styles.modalBackdrop}
+      />
       <div role="dialog" aria-modal="true" className={styles.modalDialog}>
         <div className={styles.modalHeader}>
-          <div className={styles.modalTitle}>О лицензии</div>
+          <div className={styles.modalTitle}>{t('license.aboutTitle')}</div>
-          <button type="button" aria-label="Закрыть" onClick={onClose} className={styles.modalClose}>
+          <button
+            type="button"
+            aria-label={t('common.close')}
+            onClick={onClose}
+            className={styles.modalClose}
+          >
             ×
           </button>
         </div>
-        {snapshot?.devSkip ? (
+        {snapshot?.devSkip ? <div className={styles.fieldError}>{t('license.aboutDevSkip')}</div> : null}
-          <div className={styles.fieldError}>
-            Режим разработки: проверка лицензии отключена (DND_SKIP_LICENSE).
-          </div>
-        ) : null}
         <div className={styles.fieldGrid}>
-          <div className={styles.fieldLabel}>СТАТУС</div>
+          <div className={styles.fieldLabel}>{t('license.aboutStatus')}</div>
-          <div>{snapshot ? reasonLabel(snapshot.reason) : '—'}</div>
+          <div>{snapshot ? licenseReasonLabel(t, snapshot.reason) : '—'}</div>
         </div>
         {snapshot?.summary ? (
           <>
             <div className={styles.fieldGrid}>
-              <div className={styles.fieldLabel}>ПРОДУКТ</div>
+              <div className={styles.fieldLabel}>{t('license.aboutProduct')}</div>
               <div>{snapshot.summary.pid}</div>
             </div>
             <div className={styles.fieldGrid}>
-              <div className={styles.fieldLabel}>ID ЛИЦЕНЗИИ</div>
+              <div className={styles.fieldLabel}>{t('license.aboutLicenseId')}</div>
               <div style={{ wordBreak: 'break-all' }}>{snapshot.summary.sub}</div>
             </div>
             <div className={styles.fieldGrid}>
-              <div className={styles.fieldLabel}>ОКОНЧАНИЕ</div>
+              <div className={styles.fieldLabel}>{t('license.aboutExpiry')}</div>
               <div>{expText}</div>
             </div>
             <div className={styles.fieldGrid}>
-              <div className={styles.fieldLabel}>УСТРОЙСТВО</div>
+              <div className={styles.fieldLabel}>{t('license.aboutDevice')}</div>
               <div style={{ wordBreak: 'break-all' }}>{snapshot.deviceId}</div>
             </div>
           </>
         ) : (
-          <div className={styles.muted}>Нет данных лицензии.</div>
+          <div className={styles.muted}>{t('license.aboutNoData')}</div>
         )}
         <div className={styles.modalFooter}>
           <Button variant="primary" onClick={onClose}>
-            Закрыть
+            {t('common.close')}
           </Button>
         </div>
       </div>

app/renderer/editor/main.tsx

@@ -3,6 +3,7 @@ import { createRoot } from 'react-dom/client';
 
 import '../shared/ui/globals.css';
 import { EditorApp } from './EditorApp';
+import { EditorI18nProvider } from './i18n/EditorI18nContext';
 
 const rootEl = document.getElementById('root');
 if (!rootEl) {
@@ -11,6 +12,8 @@ if (!rootEl) {
 
 createRoot(rootEl).render(
   <React.StrictMode>
-    <EditorApp />
+    <EditorI18nProvider>
+      <EditorApp />
+    </EditorI18nProvider>
   </React.StrictMode>,
 );

app/renderer/editor/state/projectState.ts

@@ -58,8 +58,18 @@ function randomId(prefix: string): string {
   return `${prefix}_${Math.random().toString(16).slice(2)}_${Date.now().toString(16)}`;
 }
 
-export function useProjectState(licenseActive: boolean): readonly [State, Actions] {
+export type ProjectNoticeCode = 'campaign_audio_empty';
+
+export type ProjectStateOpts = {
+  onNotice?: (code: ProjectNoticeCode) => void;
+};
+
+export function useProjectState(licenseActive: boolean, opts?: ProjectStateOpts): readonly [State, Actions] {
   const api = getDndApi();
+  const onNoticeRef = useRef(opts?.onNotice);
+  useEffect(() => {
+    onNoticeRef.current = opts?.onNotice;
+  }, [opts?.onNotice]);
   const [state, setState] = useState<State>({
     projects: [],
     project: null,
@@ -180,7 +190,7 @@ export function useProjectState(licenseActive: boolean): readonly [State, Action
       const res = await api.invoke(ipcChannels.project.importCampaignAudio, {});
       if (res.canceled) return;
       if (res.imported.length === 0) {
-        window.alert('Аудио не добавлено. Проверьте формат файла.');
+        onNoticeRef.current?.('campaign_audio_empty');
       }
       setState((s) => ({ ...s, project: res.project }));
       await refreshProjects();

app/shared/ipc/contracts.ts

@@ -18,6 +18,10 @@ export const ipcChannels = {
     quit: 'app.quit',
     getVersion: 'app.getVersion',
   },
+  updater: {
+    check: 'updater.check',
+    downloadAndRestart: 'updater.downloadAndRestart',
+  },
   project: {
     list: 'project.list',
     create: 'project.create',
@@ -84,6 +88,15 @@ export type ZipProgressEvent = {
   detail?: string;
 };
 
+export type UpdaterCheckResponse =
+  | { outcome: 'not_packaged' }
+  | { outcome: 'no_license' }
+  | { outcome: 'current'; currentVersion: string }
+  | { outcome: 'available'; version: string }
+  | { outcome: 'error'; message: string };
+
+export type UpdaterDownloadResponse = { ok: true } | { ok: false; message: string };
+
 export type IpcEventMap = {
   [ipcChannels.session.stateChanged]: { state: SessionState };
   [ipcChannels.effects.stateChanged]: { state: EffectsState };
@@ -101,7 +114,15 @@ export type IpcInvokeMap = {
   };
   [ipcChannels.app.getVersion]: {
     req: Record<string, never>;
-    res: { version: string; buildNumber: string | null };
+    res: { version: string; buildNumber: string | null; packaged: boolean };
+  };
+  [ipcChannels.updater.check]: {
+    req: Record<string, never>;
+    res: UpdaterCheckResponse;
+  };
+  [ipcChannels.updater.downloadAndRestart]: {
+    req: Record<string, never>;
+    res: UpdaterDownloadResponse;
   };
   [ipcChannels.project.list]: {
     req: Record<string, never>;

app/shared/package.build.test.ts

@@ -6,13 +6,16 @@ import { fileURLToPath } from 'node:url';
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
 
-void test('package.json: конфиг electron-builder (mac/win)', () => {
+void test('package.json: конфиг electron-builder (mac/win/linux)', () => {
   const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as {
     build: {
       appId: string;
       asar: boolean;
       asarUnpack: string[];
+      extraResources: { from: string; to: string }[];
       mac: { target: unknown };
+      linux: { target: unknown };
+      appImage?: { artifactName?: string };
       files: string[];
     };
   };
@@ -21,6 +24,22 @@ void test('package.json: конфиг electron-builder (mac/win)', () => {
   assert.equal(pkg.build.asar, true, 'релизный артефакт: app.asar без «голого» дерева dist в .app/.exe');
   assert.ok(Array.isArray(pkg.build.asarUnpack));
   assert.ok(pkg.build.asarUnpack.some((p) => p.includes('preload')));
+  assert.ok(Array.isArray(pkg.build.extraResources));
+  assert.ok(
+    pkg.build.extraResources.some(
+      (e: unknown) =>
+        typeof e === 'object' &&
+        e !== null &&
+        'to' in e &&
+        typeof (e as { to: unknown }).to === 'string' &&
+        (e as { to: string }).to.includes('branding'),
+    ),
+  );
   assert.ok(Array.isArray(pkg.build.mac.target));
+  assert.ok(Array.isArray(pkg.build.linux.target));
+  const linuxTargets = pkg.build.linux.target as { target: string; arch: string[] }[];
+  assert.ok(linuxTargets.some((t) => t.target === 'AppImage'));
+  assert.ok(linuxTargets.some((t) => t.arch.includes('x64') && t.arch.includes('arm64')));
+  assert.ok(pkg.build.appImage?.artifactName?.includes('${arch}'));
   assert.ok(pkg.build.files.includes('dist/**/*'));
 });

docs/GITEA_AUTO_UPDATE.md

@@ -0,0 +1,482 @@
+# Автообновление через Gitea (приватный код + публичный feed)
+
+Исходники остаются в **закрытом** репозитории с игрой. Файлы обновлений (`latest.yml`, установщики) лежат в **отдельном публичном** репозитории — по HTTPS их скачивает `electron-updater`.
+
+## Твой публичный репозиторий (уже есть)
+
+- Клон: `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git`
+- Владелец/репо для секретов: **`ifontosh/DndGamePlayerUpdates`**
+- Базовый URL feed (вшивается в сборку и должен совпадать с secret **`DND_UPDATE_FEED_URL`**):
+
+  **`https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/`**
+
+  Обрати внимание: слово **`branch`** в пути — это часть URL Gitea, не имя ветки. Имя ветки — в конце: **`updates`**.
+
+В `package.json` уже указан этот же `build.publish.url` (для локального `npm run pack` и метаданных electron-builder).
+
+---
+
+## Шаг 0 — репозиторий сейчас пустой (важно)
+
+На странице репо написано, что **контента нет**. Пока нет **ни одного коммита**, CI не сможет сделать `git clone`.
+
+Сделай так (любой способ):
+
+1. На сайте открой `ifontosh/DndGamePlayerUpdates` → кнопка вроде **«Инициализировать репозиторий»** / **«Добавить файл»** → создай файл `README.md` с парой строк и закоммить **в ветку по умолчанию** (часто `main`).
+2. Либо с компьютера:
+
+```bash
+git clone https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git
+cd DndGamePlayerUpdates
+echo "# DndGamePlayer updates feed" > README.md
+git add README.md
+git commit -m "init"
+git push origin main
+```
+
+(Если ветка по умолчанию у тебя `master` — подставь её вместо `main`.)
+
+После этого репозиторий **не пустой** — workflow сможет клонировать и создать ветку **`updates`**.
+
+---
+
+## Шаг 1 — токен для записи в публичный репозиторий
+
+Нужен **персональный токен** (PAT), с которым CI сможет **пушить** в `DndGamePlayerUpdates`.
+
+В Gitea на русском обычно так (названия могут чуть отличаться в твоей теме):
+
+1. Вверху справа **аватар** → **Настройки** (или «Параметры»).
+2. Слева найди раздел вроде **«Приложения»** / **«Токены доступа»** / **«Токены»** (в англ. интерфейсе: **Settings → Applications → Generate New Token**).
+3. Создай новый токен:
+   - имя: например `dnd-release-ci`;
+   - права: достаточно доступа к репозиторию с **записью** (для пуша в `DndGamePlayerUpdates`). Если есть галочки — включи что-то вроде **«Запись в репозиторий»** / **write:repository** / полный доступ к репо.
+4. **Скопируй токен один раз** и сохрани в менеджере паролей — потом Gitea его не покажет.
+
+Этот токен пойдёт в secret **`DND_UPDATES_PUSH_TOKEN`** (см. ниже). **Не вставляй токен в код и не коммить его.**
+
+> На **git.mailib.ru** имена секретов **не могут начинаться с `GITEA_`** (зарезервировано). Поэтому в workflow используются `DND_UPDATES_*`, а не `GITEA_*`.
+
+---
+
+## Шаг 2 — секреты в приватном репозитории с кодом (`dnd_player`)
+
+Открой **приватный** репозиторий, где лежит исходник игры (не `DndGamePlayerUpdates`).
+
+Дальше (русский Gitea 1.26, ориентир по меню):
+
+1. Вкладка **«Настройки»** репозитория (вверху рядом с «Код», «Задачи» — иногда шестерёнка **«Настройки»**).
+2. Слева раздел **«Секреты»** / **«Действия»** → **«Секреты»** (в англ. UI: **Settings → Actions → Secrets**). Если видишь **«Переменные»** — секреты обычно рядом; нам нужны именно **секреты** (скрытые значения).
+
+Добавь **четыре** секрета (имя **точно** как в таблице — workflow их читает):
+
+| Имя секрета              | Что вписать в значение                                                                                   |
+| ------------------------ | -------------------------------------------------------------------------------------------------------- |
+| `DND_UPDATE_FEED_URL`    | `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/` (обязательно **слэш в конце**) |
+| `DND_UPDATES_SERVER`     | `https://git.mailib.ru` (**без** слэша в конце)                                                          |
+| `UPDATES_REPO`           | `ifontosh/DndGamePlayerUpdates`                                                                          |
+| `DND_UPDATES_PUSH_TOKEN` | токен из шага 1 (одна длинная строка)                                                                    |
+
+Сохрани каждый секрет кнопкой вроде **«Сохранить»** / **«Добавить»**.
+
+Если раньше создавал секреты `GITEA_SERVER` / `GITEA_TOKEN` — их workflow **не читает**; удали или оставь, но **обязательно** заведи новые имена из таблицы.
+
+---
+
+## Раннер act_runner — без этого «Всего: 0» и сборки не будет
+
+Gitea **не запускает** workflow на своём процессе: нужна **отдельная машина** (VPS, сервер или **WSL2 Ubuntu** на твоём ПК), на которой крутится **[act_runner](https://docs.gitea.com/usage/actions/act-runner)** и которая видит `git.mailib.ru` по сети.
+
+Пока в **«Настройки» → «Действия» → «Раннеры»** написано **«Всего: 0»**, workflow **висит в ожидании** — нечему выполнять шаги.
+
+### Важно: это не тот токен, что для пуша в `DndGamePlayerUpdates`
+
+| Токен                                               | Где взять                                                                  | Зачем                                                                         |
+| --------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| **Регистрация раннера** (короткая случайная строка) | **Настройки репо** → **Действия** → **Раннеры** → **Создать новый раннер** | Только для команды **`act_runner register`** (один раз на каталог с раннером) |
+| **`DND_UPDATES_PUSH_TOKEN`** (PAT)                  | **Аватар** → **Настройки пользователя** → токены доступа                   | Для CI: пуш в публичный репо обновлений (см. шаг 1 выше)                      |
+
+Если Gitea показала **только длинную строку** — это почти наверняка **токен регистрации раннера**. URL инстанса ты знаешь сам: **`https://git.mailib.ru`** (без пути к репозиторию).
+
+### Требования к машине под наш `release.yml`
+
+В workflow для job **`ubuntu-22.04`** идут **`sudo apt-get`** (пакеты **`nsis`**, **`wine64`**) на **Linux**. Multiarch **i386** намеренно не включается — на Debian с репозиториями только под amd64 (nginx, sury и т.п.) установка **wine32** часто падает с «unmet dependencies». После установки **`wine64`** в CI создаётся скрипт **`/usr/local/bin/wine`** с **`exec` по полному пути** к **`wine64`** (в job у act_runner иногда пустой/урезанный `PATH`, тогда имя `wine64` без пути не находится). electron-builder проверяет именно команду **`wine`** в `PATH`. Поэтому:
+
+- Нужен **Linux x86_64** (идеально **Ubuntu 22.04**), либо **WSL2** с Ubuntu 22.04 на Windows.
+- Запускать раннер на «голом» Windows с меткой `ubuntu-22.04` **бессмысленно** — шаги с `apt` не выполнятся.
+
+### Шаг A — получить токен регистрации в Gitea
+
+1. Открой репозиторий с кодом (**DndGamePlayer** или как он у тебя называется).
+2. **Настройки** → **Действия** → **Раннеры** → **Создать новый раннер**.
+3. Выбери тип **репозитория** (repository runner), ОС **Linux**.
+4. **Скопируй токен** (и при желании подсказку с URL инстанса, если она есть). Команду из мастера можно **не копировать**, если ниже удобнее готовая.
+
+### Шаг B — скачать act_runner (бинарник)
+
+Официальные сборки: **[релизы act_runner на gitea.com](https://gitea.com/gitea/act_runner/releases)**.
+
+1. Открой страницу релизов и посмотри **последний стабильный** тег, например **`v1.0.2`**.
+2. В списке файлов скачай **`gitea-runner-ВЕРСИЯ-linux-amd64`** — это один исполняемый файл **без** расширения `.zip` (не путай с `darwin` / `arm64`, если у тебя обычный ПК/сервер Intel/AMD).
+
+**Прямая ссылка (подставь свою версию из релиза):**
+
+`https://gitea.com/gitea/act_runner/releases/download/v1.0.2/gitea-runner-1.0.2-linux-amd64`
+
+В URL после `download/` идёт тег с **`v`**, в имени файла версия **без `v`**.
+
+**Скачать с Linux/WSL одной командой** (замени `1.0.2` на актуальную версию с сайта):
+
+```bash
+mkdir -p ~/gitea-act-runner && cd ~/gitea-act-runner
+VERSION="1.0.2"
+curl -fL -o act_runner "https://gitea.com/gitea/act_runner/releases/download/v${VERSION}/gitea-runner-${VERSION}-linux-amd64"
+chmod +x act_runner
+./act_runner --version
+```
+
+Если `curl` ругается на сертификат — обнови CA или скачай тот же файл через браузер и положи в папку, затем `chmod +x`.
+
+### Шаг C — регистрация (подставь свой токен)
+
+В каталоге, где лежит `act_runner`, выполни **одну** команду (токен — тот, что выдала Gitea при создании раннера):
+
+```bash
+cd ~/gitea-act-runner
+
+./act_runner register --no-interactive \
+  --instance "https://git.mailib.ru" \
+  --token "ВСТАВЬ_СЮДА_ТОКЕН_ИЗ_МАСТЕРА_GITEA" \
+  --name "dnd-release-runner" \
+  --labels "ubuntu-22.04:host"
+```
+
+Пояснения:
+
+- **`--instance`** — корень твоего Gitea (**без** `/ifontosh/...`).
+- **`--labels "ubuntu-22.04:host"`** — job в **`.gitea/workflows/release.yml`** имеет `runs-on: ubuntu-22.04`, а **`:host`** означает выполнение **на самой машине**, с настоящим `apt` и Wine (см. [документацию по меткам](https://docs.gitea.com/usage/actions/act-runner#labels)). Если при регистрации оставить **дефолтные** метки с **`docker://`**, шаги тоже могут сработать, но образ другой; для предсказуемости лучше **`ubuntu-22.04:host`** на чистой Ubuntu 22.04.
+- После успешной регистрации в этой папке появится файл **`.runner`** — его не удаляй и не коммить.
+
+Если Gitea пишет ошибку регистрации — часто неверный **токен** (устарел после «сброса» в UI) или выбран не тот уровень (инстанс/организация/репозиторий). Создай раннера заново и возьми **новый** токен.
+
+### Шаг D — запуск вручную (для проверки)
+
+В той же папке:
+
+```bash
+./act_runner daemon
+```
+
+Окно терминала должно остаться **открытым**. Остановка — `Ctrl+C`. Когда убедишься, что в Gitea раннер **online**, лучше перейти на **systemd** (шаг ниже).
+
+### Шаг D1 — systemd: автозапуск после перезагрузки (подробно)
+
+Идея: **systemd** сам поднимает `act_runner daemon` при загрузке системы и перезапускает процесс при падении. Рабочая директория должна быть **та же**, где лежат **`act_runner`** и зарегистрированный файл **`.runner`** (обычно `~/gitea-act-runner`).
+
+#### 0) Подготовка
+
+1. Регистрация (**шаг C**) уже выполнена, в каталоге есть **`.runner`**.
+2. Узнай **точный путь** к каталогу (systemd не понимает `~`):
+
+```bash
+cd ~/gitea-act-runner && pwd
+```
+
+Запомни вывод, например **`/home/ivan/gitea-act-runner`**. Имя пользователя Linux:
+
+```bash
+whoami
+```
+
+Дальше в примерах: **`/home/ivan/gitea-act-runner`** и пользователь **`ivan`** — замени на свои.
+
+#### 1) Останови ручной запуск
+
+Если где-то в терминале уже крутится `./act_runner daemon` — заверши **Ctrl+C**, иначе два процесса будут мешать друг другу.
+
+#### 2) Создай unit-файл службы
+
+На **VPS / обычной Ubuntu** с правами root:
+
+```bash
+sudo nano /etc/systemd/system/gitea-act-runner.service
+```
+
+Вставь текст **целиком** (подставь свои `User`, `Group`, `WorkingDirectory`, `ExecStart`):
+
+```ini
+[Unit]
+Description=Gitea Actions act_runner
+Documentation=https://docs.gitea.com/usage/actions/act-runner
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=ivan
+Group=ivan
+WorkingDirectory=/home/ivan/gitea-act-runner
+ExecStart=/home/ivan/gitea-act-runner/act_runner daemon
+Restart=always
+RestartSec=10
+
+# Логи в journald (см. ниже как читать)
+StandardOutput=journal
+StandardError=journal
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Сохрани файл: в **nano** — **Ctrl+O**, Enter, **Ctrl+X**.
+
+Пояснения:
+
+- **`User` / `Group`** — под этим пользователем ты делал `register` и владеешь папкой (проверка: `ls -la ~/gitea-act-runner` — владелец должен совпадать).
+- **`WorkingDirectory`** — каталог с **`.runner`**; без него раннер может не найти регистрацию.
+- **`ExecStart`** — полный путь к бинарнику **`act_runner`** (тот, что скачал и сделал `chmod +x`).
+- Блок **`After=network-online.target`** — старт после сети (удобно для `git`/`npm` в CI). Если вдруг зависнет старт из‑за сетевого таргета, можно временно заменить на **`After=network.target`**.
+
+Официальный пример с отдельным пользователем `act_runner` и `config.yaml`: [Start the runner with Systemd](https://docs.gitea.com/usage/actions/act-runner#start-the-runner-with-systemd) — у нас проще: один пользователь и без отдельного `config.yaml`, пока дефолты устраивают.
+
+#### 3) Включи и запусти службу
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable gitea-act-runner.service
+sudo systemctl start gitea-act-runner.service
+sudo systemctl status gitea-act-runner.service
+```
+
+В **`status`** должно быть **`active (running)`** зелёным. Если **`failed`** — смотри лог (шаг 5).
+
+Полезные команды:
+
+| Действие              | Команда                                                       |
+| --------------------- | ------------------------------------------------------------- |
+| Остановить            | `sudo systemctl stop gitea-act-runner`                        |
+| Запустить снова       | `sudo systemctl start gitea-act-runner`                       |
+| Перезапуск            | `sudo systemctl restart gitea-act-runner`                     |
+| Выключить автозапуск  | `sudo systemctl disable gitea-act-runner`                     |
+| Проверка после ребута | перезагрузи машину, затем `systemctl status gitea-act-runner` |
+
+#### 4) Проверка в Gitea
+
+Как в **шаге E**: раннер снова **online** (иногда 10–30 секунд после `start`).
+
+#### 5) Логи, если что-то не так
+
+```bash
+sudo journalctl -u gitea-act-runner -e --no-pager
+```
+
+В реальном времени:
+
+```bash
+sudo journalctl -u gitea-act-runner -f
+```
+
+Типичные ошибки: неверный **`User`** (нет прав на каталог), **`WorkingDirectory`** не тот (нет **`.runner`**), бинарник не исполняемый (`chmod +x`), или старый процесс `act_runner` ещё запущен вручную.
+
+#### WSL2 (Ubuntu в Windows)
+
+Если раннер стоит **внутри WSL2**:
+
+1. На современных WSL **systemd уже может быть включён**. Проверка: `systemctl status` — без ошибки «running in chroot».
+2. Если `systemctl` недоступен: в файле **`/etc/wsl.conf`** внутри дистрибутива добавь блок **`[boot]`** с **`systemd=true`**, затем из **PowerShell** Windows выполни **`wsl --shutdown`**, снова зайди в Ubuntu и повтори шаги 2–3. Подробнее: [документация Microsoft про systemd в WSL](https://learn.microsoft.com/en-us/windows/wsl/systemd).
+
+После **`wsl --shutdown`** раннер на WSL не работает, пока ты снова не откроешь WSL (это нормально для «домашнего» CI).
+
+### Шаг E — проверка в веб-интерфейсе
+
+Обнови **Настройки → Действия → Раннеры**: должен быть **1** раннер, статус **online**. У него в метках должно быть что-то вроде **`ubuntu-22.04`** (в связке с **host**).
+
+### Если у тебя только Windows
+
+Установи **WSL2** и дистрибутив **Ubuntu 22.04**, открой терминал Ubuntu и выполни шаги B–D **там** (это уже Linux). Файловую систему Windows из WSL видно как `/mnt/d/...`, но проще держать каталог раннера в домашнем каталоге Linux (`~/gitea-act-runner`).
+
+Официальная документация: [Gitea — Act Runner](https://docs.gitea.com/usage/actions/act-runner).
+
+Если раннер заводит **админ инстанса** — логика та же: раннер должен быть **online** и иметь метку, подходящую под **`runs-on`** в `release.yml` (сейчас **`ubuntu-22.04`**; при **`ubuntu-22.04:host`** в Gitea это сопоставляется с `runs-on: ubuntu-22.04`).
+
+---
+
+## Шаг 3 — включить Actions (если ещё не включены)
+
+1. В том же **приватном** репозитории: **«Настройки»**.
+2. Раздел **«Действия»** / **«Actions»** — включи использование Actions для этого репозитория, если Gitea это спрашивает.
+3. Убедись, что в корне репозитория есть файл **`.gitea/workflows/release.yml`** (он уже в проекте `dnd_player`).
+
+Бегунки Gitea должны иметь доступ в интернет (для `npm ci`, `actions/checkout` и т.д.) — это настраивает админ сервера.
+
+### Метки `runs-on` (если раннер уже есть, но job не берётся)
+
+- В списке раннеров посмотри **метки** у online-раннера.
+- В **`.gitea/workflows/release.yml`** в `runs-on:` должна совпадать **именно метка `ubuntu-22.04`** (Gitea сопоставляет её и с **`ubuntu-22.04:host`**, и с **`ubuntu-22.04:docker://...`** — см. [Labels](https://docs.gitea.com/usage/actions/act-runner#labels) в документации act_runner).
+- Если при регистрации указал только **`self-hosted`** — добавь **`ubuntu-22.04:host`** (или поменяй `runs-on` в workflow на твои метки и закоммить).
+
+Сборка **Windows (NSIS)** и **Linux (AppImage x64 + arm64)** в CI идёт **на одном** `ubuntu-22.04`: NSIS + `wine64` для Win, `qemu-user-static` для кросс-сборки arm64 AppImage на amd64 (см. `release.yml`). **macOS** в этом job не собирается (ручная выкладка или отдельный раннер — см. `docs/MANUAL_MAC_UPDATE_UPLOAD.md`).
+
+---
+
+## Linux: AppImage и автообновление
+
+- В ветке **`updates`** рядом с Windows лежат **`latest-linux.yml`** и файлы **`*.AppImage`** (x64 и arm64). Скрипт **`scripts/sync-update-feed.mjs`** делает **merge-копирование**: файлы других ОС в репозитории **не удаляются**, обновляются только имена, пришедшие из текущего CI-прогона.
+- **Базовый дистрибутив для бинарников:** сборка на **Ubuntu 22.04 (glibc 2.35)** — совместимость с «максимумом» настольных дистрибутивов с glibc не старее целевого; **Alpine/musl** без отдельной сборки не гарантируется.
+- **Запуск AppImage:** на части систем нужен **FUSE** (например `libfuse2` для старых форматов / документация дистрибутива). Подпись пакетов в первом варианте **не** используется (как договорённость по проекту).
+- Правила **electron-updater** в приложении те же: упакованная сборка и **активная лицензия** (`installAutoUpdater.ts`).
+
+---
+
+## Шаг 4 — выпуск версии
+
+1. В `package.json` версия должна совпасть с тегом (workflow при пуше тега делает `npm version` из имени тега — удобно).
+2. Закоммить все изменения в **приватный** репо, затем:
+
+```bash
+git tag v1.0.1
+git push origin main
+git push origin v1.0.1
+```
+
+(ветка может быть не `main` — подставь свою.)
+
+3. Открой в Gitea **«Действия»** у приватного репо — должен появиться запуск **Release**. Дождись успеха job **`release`** (после появления раннера, см. раздел выше).
+
+4. После успеха открой **публичный** `DndGamePlayerUpdates` → ветка **`updates`** — в корне должны появиться `latest.yml`, установщики и т.д.
+
+---
+
+## Контрольный чеклист
+
+1. **`package.json` → `build.publish.url`** =  
+   `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/`  
+   Совпадает с **`DND_UPDATE_FEED_URL`** (со слэшем в конце).
+2. В **DndGamePlayerUpdates** есть хотя бы один коммит (не пустой репо).
+3. В приватном репо заданы **все четыре** секрета из таблицы шага 2 (имена **не** начинаются с `GITEA_`).
+4. В репо с кодом есть **`.gitea/workflows/release.yml`**.
+5. Релиз: пуш тега `v*` → в Actions job **`release`**: сборка **Windows** + **Linux AppImage** и push feed; в публичном репо ветка **`updates`** содержит `latest.yml`, `latest-linux.yml`, установщики Windows и **`.AppImage`** для Linux (нужен online-раннер `ubuntu-22.04`, см. раздел про act_runner). Скрипт sync **не затирает** артефакты других платформ при обновлении.
+6. В приложении: обновления только **`app.isPackaged`** и при **активной лицензии** (см. `app/main/update/installAutoUpdater.ts`).
+
+---
+
+## Если `git push` в `updates` падает: `remote end hung up` / таймаут
+
+Один коммит с **Windows + два AppImage** может быть **сотни МБ** — HTTPS-push иногда рвётся из‑за лимита буфера Git или таймаута **nginx / reverse proxy** перед Gitea.
+
+**В репозитории с кодом** скрипт `scripts/sync-update-feed.mjs` уже выставляет в клоне feed-репо:
+
+- `http.postBuffer` **2 GiB**;
+- отключение «медленной передачи» (`http.lowSpeedLimit` / `http.lowSpeedTime`);
+- до **3** повторов `git push` с паузой 20 с (переменная **`DND_GIT_PUSH_RETRIES`**, максимум 5).
+
+Если ошибка сохраняется — на **сервере** (nginx и т.п.) проверьте, например:
+
+- `client_max_body_size` — не меньше размера push (или `0` для безлимита, если политика безопасности позволяет);
+- `proxy_read_timeout` / `proxy_send_timeout` — **несколько минут** и больше для больших загрузок;
+- лимиты самого **Gitea** (`[repository.upload]`, `APP_MAX_FILE_SIZE` в зависимости от версии) — в документации вашей сборки Gitea.
+
+---
+
+## Линейная история в `UPDATES_REPO` (например DndGamePlayerUpdates)
+
+Переписывается **только** публичный репозиторий из секрета **`UPDATES_REPO`**, ветка **`updates`**. Репозиторий с исходниками игры (**DndGamePlayer**) и его теги **не меняются**.
+
+В workflow задано **`DND_UPDATES_SQUASH_HISTORY=1`**: после merge и подкладки артефактов скрипт делает **`git checkout --orphan`** → один корневой коммит → push с **`--force-with-lease`**, если локально уже есть **`refs/remotes/origin/updates`** (ветка на сервере была); иначе — обычный первый **`git push -u origin updates`**. Так на каждом релизе в истории остаётся **один** коммит с актуальным набором файлов — меньше трафик и диск при `clone`/`fetch` на раннере.
+
+На **сервере Gitea** старые объекты коммитов остаются «висячими», пока не отработает **сборка мусора** репозитория (настройки сервера / ручной `git gc` в bare-репо). Для пользователей приложения важны только URL **`latest*.yml`** и установщиков — они не меняются по смыслу.
+
+Не запускайте **два релиза**, которые одновременно пушат feed, — возможна гонка и отказ **`--force-with-lease`**.
+
+---
+
+## Если push отклонён: `(fetch first)` / `rejected`
+
+Пока job собирает артефакты, в **`updates`** мог успеть попасть **другой** коммит (второй релиз, ручная выкладка). Скрипт `sync-update-feed.mjs` перед push (в режиме **без** squash) делает **`git fetch` + `git merge origin/updates`** (и после клона — то же в начале), плюс shallow **глубина** (`DND_UPDATES_CLONE_DEPTH`: по умолчанию **40**, при **`DND_UPDATES_SQUASH_HISTORY=1`** в скрипте по умолчанию **8**). В режиме **squash** перед push merge **не** выполняется — уже смерженное дерево сжимается в один коммит и отправляется force-with-lease. Не запускайте **два релиза одного и того же репо одновременно** по двум тегам — возможны конфликты merge.
+
+---
+
+## ENOSPC / «no space left on device» при sync
+
+Частая причина: **дублирование** артефактов (`release/` → `_linux`/`_win` → временный клон в **`/tmp`**) на раннере с маленьким root. Сейчас CI **не копирует** в `_win`/`_linux`: `ARTIFACT_WIN` и `ARTIFACT_LINUX` указывают на **`release/`**, а временный клон feed создаётся под **`DND_FEED_TMP_ROOT`** (в workflow — `${{ github.workspace }}/.dnd-feed-tmp`). Скрипт по возможности делает **`rename`** файлов в клон (без второй полной копии на том же диске).
+
+Если ошибка остаётся — на машине раннера нужно **освободить место** или увеличить диск / вынести workspace на больший том.
+
+Перед `git clone` скрипт проверяет **свободное место на томе**, где лежит `DND_FEED_TMP_ROOT` (оценка: артефакты × 2.5 + ~1 GiB запас, минимум ~2 GiB). Если проверка мешает (редкий ложный срабатывание), можно задать **`DND_FEED_SKIP_DISK_CHECK=1`** (лучше всё же поправить диск).
+
+Несколько **неудачных** `git fetch` подряд (обрыв TLS) могли раньше забивать диск частично распакованными pack-файлами; между попытками вызывается **`git gc --prune=now`**.
+
+---
+
+## Сбой fetch: `GnuTLS recv error` / `early EOF`
+
+Сеть или TLS к серверу Gitea. Скрипт делает **несколько повторов** `git fetch` (`DND_GIT_FETCH_RETRIES`, по умолчанию **6**), между попытками — **`git gc --prune=now`**, для clone/fetch задано **`http.version=HTTP/1.1`** (иногда стабильнее за прокси). Если ветки **`updates` на сервере ещё нет**, merge **намеренно** пропускается (первый push feed); при **любой другой** ошибке fetch job **завершится ошибкой** — не будет «тихого» продолжения с последующим `ENOSPC` на `git add`.
+
+При стабильных обрывах проверьте прокси/MTU/антивирус на раннере и лимиты прокси к Gitea.
+
+---
+
+## Поведение приложения
+
+- Проверка только в **собранной** установке (`app.isPackaged`).
+- Только если **лицензия активна**.
+- Первый запрос примерно через **12 с** после старта; при смене лицензии — снова (не чаще **30 с**).
+- Для отладки можно задать переменную окружения **`DND_UPDATE_FEED_URL`** при запуске приложения (Windows / Linux / macOS) — переопределит feed.
+
+Подпись кода в CI отключена: `CSC_IDENTITY_AUTO_DISCOVERY=false` (в т.ч. Linux AppImage без репозитория подписи).
+
+---
+
+## Локальная отладка feed
+
+Запуск установленного приложения с другим URL (без пересборки): задать **`DND_UPDATE_FEED_URL`** в ярлыке или системных переменных окружения.
+
+---
+
+## Как сделать так, чтобы ассистент в Cursor мог «выпустить релиз»
+
+У ассистента **нет своего аккаунта** на `git.mailib.ru`. Релиз = **появление тега `v*`** на нужном коммите в **приватном** репозитории с кодом → Gitea Actions собирает и пушит feed. Ниже два рабочих варианта.
+
+### Вариант A — Gitea MCP (удобно из чата)
+
+У тебя уже подключён MCP **user-gitea-mailib** с инструментом **`create_tag`**: по API создаётся тег на сервере (аналог `git tag` + `git push` тега).
+
+**Что сделать один раз:**
+
+1. В Cursor MCP для Gitea должен быть **включён и залогинен** под учёткой, у которой есть право **создавать теги** в приватном репо с `dnd_player`.
+2. Знать **`owner`** и **`repo`** этого репозитория (как в URL: `https://git.mailib.ru/OWNER/REPO`).
+
+**Как просить в чате:**  
+«Создай тег `v1.0.2` в репозитории `OWNER/REPO` с целевой веткой `main`» (или укажи SHA коммита). Перед этим **весь код релиза уже должен быть запушен** в эту ветку — тег вешается на последний коммит (или на явный `target`).
+
+После создания тега зайди в **Действия** репозитория и проверь workflow **Release**.
+
+_(Отдельно: `create_release` в MCP создаёт **запись релиза** на Gitea; сборку у тебя запускает именно **тег** и `release.yml`.)_
+
+### Вариант B — команды `git` в терминале Cursor
+
+Ассистент может выполнить у тебя локально:
+
+```bash
+git fetch origin
+git tag v1.0.2 origin/main   # или другая ветка / коммит
+git push origin v1.0.2
+```
+
+**Что сделать один раз:**
+
+1. Чтобы `git push` **не спрашивал пароль** каждый раз: настроить **учётные данные** (Windows: диспетчер учётных данных / `git credential-manager`; либо **SSH-ключ** и remote `git@git.mailib.ru:...`).
+2. Убедиться, что из того же окружения, где работает Cursor, `git push` в приватный репо уже проходил успешно.
+
+Тогда в чате можно написать: «Поставь тег `v1.0.2` на `origin/main` и запушь тег» — ассистент выполнит команды в `dnd_player`.
+
+### Ограничения
+
+- Ассистент **не видит** твои пароли и не обходит Gitea: всё упирается в **MCP-токен** или **твои локальные git credentials**.
+- Если MCP отключён и git без настроенного доступа — релиз тегом придётся пушить **тебе** вручную (как в шаге 4 выше).
+
+---
+
+## Про коммит и пуш кода (не тег)
+
+Закоммитить и запушить **изменения в файлах** ассистент может через те же механизмы: либо ты делаешь `git push` после правок, либо настроенный **git** / отдельный скрипт. Без доступа к remote ассистент только правит файлы в рабочей копии.

docs/MANUAL_MAC_UPDATE_UPLOAD.md

@@ -0,0 +1,159 @@
+# Ручная выкладка macOS-обновлений в публичный feed
+
+Инструкция для случая, когда **сборка делается на вашем Mac вручную**, а файлы для `electron-updater` нужно **вручную** положить в публичный репозиторий обновлений.
+
+Общая схема проекта: приватный репозиторий с кодом, публичный **`DndGamePlayerUpdates`**, ветка **`updates`**, URL feed как в `package.json`:
+
+`https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/`
+
+---
+
+## 1. Что собрать на Mac
+
+В каталоге проекта `dnd_player`:
+
+```bash
+cd /путь/к/dnd_player
+npm ci
+npm run build
+```
+
+Сборка установщиков только под macOS (без публикации в сеть, только файлы в `release/`):
+
+```bash
+npx electron-builder --mac --publish never \
+  --config.publish.provider=generic \
+  --config.publish.url="https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/"
+```
+
+**Важно:** значение `--config.publish.url=...` должно совпадать с `package.json` → `build.publish.url` (**со слэшем в конце**). Так внутри приложения и в `latest-mac.yml` будет корректный базовый URL для скачивания.
+
+После сборки откройте папку **`release/`** в корне проекта. Там должны быть, среди прочего:
+
+- **`latest-mac.yml`** — обязателен для `electron-updater` на Mac;
+- **`.dmg`** и/или **`.zip`** — то, на что ссылается `latest-mac.yml`;
+- при необходимости **`.blockmap`** (если electron-builder их создал) — заливайте с теми же именами, что указаны в `latest-mac.yml`.
+
+Имена файлов зависят от версии и архитектур (в конфиге dmg и zip для **x64** и **arm64**). На Apple Silicon без дополнительных шагов часто получается только **arm64**; для отдельного Intel-сборщика нужна своя машина или параметры arch — ориентируйтесь на фактический список файлов в `release/`.
+
+---
+
+## 2. Куда заливать
+
+Файлы должны оказаться в **публичном** репозитории:
+
+| Параметр     | Значение                                                                  |
+| ------------ | ------------------------------------------------------------------------- |
+| Репозиторий  | `ifontosh/DndGamePlayerUpdates` (подставьте свой owner/repo, если другой) |
+| Ветка        | `updates`                                                                 |
+| Расположение | **корень ветки** (не подпапка)                                            |
+
+Проверка: в браузере должен открываться, например:
+
+`https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/latest-mac.yml`
+
+Файлы Windows (`latest.yml`, `.exe`, …), которые кладёт CI, должны **остаться** в том же корне. Вы **добавляете или обновляете** только macOS-артефакты и **`latest-mac.yml`**, не удаляя артефакты Windows (если не делаете осознанную зачистку старых версий).
+
+---
+
+## 3. Способ A — через `git` (удобно для больших dmg)
+
+### 3.1. Клон и ветка `updates`
+
+```bash
+cd ~/где-удобно
+git clone https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git
+cd DndGamePlayerUpdates
+git fetch origin
+git checkout updates
+```
+
+Если ветки `updates` ещё нет:
+
+```bash
+git checkout main
+git pull
+git checkout -b updates
+git push -u origin updates
+```
+
+Дальше для каждой выкладки работайте в ветке **`updates`**.
+
+### 3.2. Актуализировать локальную копию
+
+```bash
+git checkout updates
+git pull origin updates
+```
+
+### 3.3. Скопировать файлы из `release/` в корень клона
+
+```bash
+cp /путь/к/dnd_player/release/latest-mac.yml .
+cp /путь/к/dnd_player/release/*.dmg .
+cp /путь/к/dnd_player/release/*.zip .
+# blockmap, если есть:
+cp /путь/к/dnd_player/release/*.blockmap . 2>/dev/null || true
+```
+
+Проверка, что Windows-файлы на месте:
+
+```bash
+ls -la
+```
+
+### 3.4. Коммит и push
+
+```bash
+git add latest-mac.yml *.dmg *.zip
+git add *.blockmap 2>/dev/null || true
+git status
+git commit -m "mac: DNDGamePlayer vX.Y.Z (ручная выкладка)"
+git push origin updates
+```
+
+Для HTTPS обычно используют **персональный токен (PAT)** Gitea вместо пароля, либо настроенный **SSH** (`git@git.mailib.ru:ifontosh/DndGamePlayerUpdates.git`).
+
+### 3.5. Проверка
+
+- Откройте `latest-mac.yml` по raw-URL (см. выше).
+- Откройте в браузере прямую ссылку на один из `.dmg` из этого YAML — не должно быть 404.
+
+---
+
+## 4. Способ B — через веб-интерфейс Gitea
+
+Подходит для редких правок; для больших **dmg** удобнее git.
+
+1. Репозиторий `DndGamePlayerUpdates` → ветка **`updates`**.
+2. Загрузить или изменить **`latest-mac.yml`** и бинарники (**имена как в `release/`**).
+3. Не удалять при этом файлы Windows в корне, если они нужны для PC-обновлений.
+
+---
+
+## 5. Версии и Windows
+
+- В **`latest-mac.yml`** и в именах файлов должна быть та **версия приложения**, которую вы отдаёте пользователям Mac (как в `package.json` на момент сборки).
+- **`latest.yml`** (Windows) и **`latest-mac.yml`** (Mac) — разные файлы; версии на платформах могут совпадать или нет. Каждая ОС читает свой YAML.
+
+---
+
+## 6. Подпись кода (кратко)
+
+Без **Developer ID** и при необходимости **нотаризации** macOS может ограничивать запуск после скачивания. На процедуру «залить файлы в репо» это не влияет, но влияет на UX после автообновления. Для продакшена имеет смысл позже настроить `CSC_LINK`, `CSC_KEY_PASSWORD` и нотаризацию по [документации electron-builder](https://www.electron.build/).
+
+---
+
+## 7. Чеклист
+
+1. Локально собрали Mac с `--publish never` и верным `publish.url`.
+2. В `release/` есть **`latest-mac.yml`** и все объекты, на которые он ссылается.
+3. В ветке **`updates`** в корне репозитория обновили/добавили эти файлы, не снеся Windows-артефакты без необходимости.
+4. Проверили raw-URL **`latest-mac.yml`** и ссылку на dmg.
+5. В **упакованном** приложении с **активной лицензией** сработает существующий `electron-updater` (задержка первой проверки и cooldown — см. `app/main/update/installAutoUpdater.ts`).
+
+---
+
+## Связанные документы
+
+- Общая схема Gitea, секреты, раннер: [GITEA_AUTO_UPDATE.md](./GITEA_AUTO_UPDATE.md).

package.json

@@ -1,6 +1,6 @@
 {
   "name": "DndGamePlayer",
-  "version": "1.0.0",
+  "version": "1.0.11",
   "description": "DNDGamePlayer — редактор и проигрыватель игр",
   "main": "dist/main/index.cjs",
   "scripts": {
@@ -10,14 +10,16 @@
     "build:obfuscate": "node scripts/build.mjs --production --obfuscate",
     "lint": "eslint . --max-warnings 0",
     "typecheck": "tsc -p tsconfig.eslint.json --noEmit",
-    "test": "tsx --test app/renderer/shared/ui/controls.tooltip.test.ts app/renderer/editor/state/projectState.race.test.ts app/renderer/editor/graph/sceneCardById.test.ts app/shared/ipc/contracts.mediaRemoval.test.ts app/shared/effectEraserHitTest.test.ts app/renderer/control/controlApp.effectsPanel.test.ts app/renderer/shared/effects/PxiEffectsOverlay.pointer.test.ts app/main/windows/createWindows.editorClose.test.ts app/main/windows/bootWindow.test.ts app/main/effects/effectsStore.test.ts app/main/project/assetPrune.test.ts app/main/project/optimizeImageImport.test.ts app/main/project/scenePreviewThumbnail.test.ts app/main/project/fsRetry.test.ts app/main/project/zipRead.test.ts app/main/project/replaceFileAtomic.test.ts app/main/project/zipStore.legacyContract.test.ts app/shared/package.build.test.ts app/shared/license/canonicalJson.test.ts app/shared/license/productKey.test.ts app/shared/license/licenseService.networkRegression.test.ts app/shared/video/videoPlaybackPerf.networkRegression.test.ts app/shared/video/videoPlaybackLoop.networkRegression.test.ts app/main/license/verifyLicenseToken.test.ts && node --test scripts/build-env.test.mjs scripts/obfuscate-main.test.mjs",
+    "test": "tsx --test app/renderer/shared/ui/controls.tooltip.test.ts app/renderer/editor/state/projectState.race.test.ts app/renderer/editor/graph/sceneCardById.test.ts app/renderer/editor/i18n/editorMessages.locale.test.ts app/shared/ipc/contracts.mediaRemoval.test.ts app/shared/effectEraserHitTest.test.ts app/renderer/control/controlApp.effectsPanel.test.ts app/renderer/shared/effects/PxiEffectsOverlay.pointer.test.ts app/main/windows/createWindows.editorClose.test.ts app/main/windows/bootWindow.test.ts app/main/effects/effectsStore.test.ts app/main/project/assetPrune.test.ts app/main/project/optimizeImageImport.test.ts app/main/project/scenePreviewThumbnail.test.ts app/main/project/fsRetry.test.ts app/main/project/zipRead.test.ts app/main/project/replaceFileAtomic.test.ts app/main/project/zipStore.legacyContract.test.ts app/shared/package.build.test.ts app/shared/license/canonicalJson.test.ts app/shared/license/productKey.test.ts app/shared/license/licenseService.networkRegression.test.ts app/shared/video/videoPlaybackPerf.networkRegression.test.ts app/shared/video/videoPlaybackLoop.networkRegression.test.ts app/main/license/verifyLicenseToken.test.ts && node --test scripts/build-env.test.mjs scripts/obfuscate-main.test.mjs",
     "format": "prettier . --check",
     "format:write": "prettier . --write",
+    "postinstall": "patch-package",
     "release:info": "node scripts/print-release-info.mjs",
     "pack": "npm run build && node scripts/release-win-prep.mjs && electron-builder",
     "pack:dir": "npm run build && node scripts/release-win-prep.mjs && electron-builder --dir",
     "pack:mac": "npm run build && electron-builder --mac",
-    "pack:win": "npm run build && node scripts/release-win-prep.mjs && electron-builder --win"
+    "pack:win": "npm run build && node scripts/release-win-prep.mjs && electron-builder --win",
+    "pack:linux": "npm run build && electron-builder --linux"
   },
   "keywords": [],
   "author": "",
@@ -25,6 +27,7 @@
   "type": "module",
   "dependencies": {
     "@fontsource/inter": "^5.2.8",
+    "electron-updater": "^6.6.2",
     "ffmpeg-static": "^5.3.0",
     "pixi.js": "^8.18.1",
     "react": "^19.2.5",
@@ -56,7 +59,9 @@
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-unicorn": "^64.0.0",
     "javascript-obfuscator": "^4.2.2",
+    "patch-package": "^8.0.1",
     "prettier": "^3.8.3",
+    "to-ico": "^1.1.2",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.2",
@@ -72,6 +77,12 @@
       "output": "release",
       "buildResources": "build"
     },
+    "extraResources": [
+      {
+        "from": "build/icon.ico",
+        "to": "branding/icon.ico"
+      }
+    ],
     "files": [
       "dist/**/*",
       "package.json"
@@ -79,6 +90,8 @@
     "asar": true,
     "asarUnpack": [
       "dist/preload/**",
+      "dist/renderer/app-pack-icon.png",
+      "dist/renderer/app-window-icon.png",
       "node_modules/sharp/**",
       "node_modules/@img/**",
       "node_modules/ffmpeg-static/**"
@@ -118,12 +131,35 @@
           ]
         }
       ],
+      "icon": "build/icon.ico"
+    },
+    "linux": {
+      "target": [
+        {
+          "target": "AppImage",
+          "arch": [
+            "x64",
+            "arm64"
+          ]
+        }
+      ],
+      "category": "Game",
+      "maintainer": "DNDGamePlayer",
+      "synopsis": "DNDGamePlayer — редактор и проигрыватель игр",
       "icon": "build/icon.png"
     },
+    "appImage": {
+      "artifactName": "${productName}-${version}-${arch}.${ext}"
+    },
     "nsis": {
       "oneClick": false,
       "allowToChangeInstallationDirectory": true,
-      "deleteAppDataOnUninstall": false
+      "deleteAppDataOnUninstall": false,
+      "artifactName": "${productName}-Setup-${version}.${ext}"
+    },
+    "publish": {
+      "provider": "generic",
+      "url": "https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/"
     }
   }
 }

patches/app-builder-lib+26.8.1.patch

@@ -0,0 +1,18 @@
+diff --git a/node_modules/app-builder-lib/out/targets/nsis/NsisTarget.js b/node_modules/app-builder-lib/out/targets/nsis/NsisTarget.js
+index 1e4ef94..5f64a59 100644
+--- a/node_modules/app-builder-lib/out/targets/nsis/NsisTarget.js
++++ b/node_modules/app-builder-lib/out/targets/nsis/NsisTarget.js
+@@ -367,7 +367,12 @@ class NsisTarget extends core_1.Target {
+             }
+         }
+         else {
+-            await (0, wine_1.execWine)(installerPath, null, [], { env: { __COMPAT_LAYER: "RunAsInvoker" } });
++            try {
++                await nsisUtil_1.UninstallerReader.exec(installerPath, uninstallerPath);
++            }
++            catch (_error) {
++                await (0, wine_1.execWine)(installerPath, null, [], { env: { __COMPAT_LAYER: "RunAsInvoker" } });
++            }
+         }
+         await packager.signIf(uninstallerPath);
+         delete defines.BUILD_UNINSTALLER;

scripts/build.mjs

@@ -62,7 +62,7 @@ async function buildNodeTargets() {
     bundle: true,
     minify: isProd,
     sourcemap: !isProd,
-    external: ['electron', 'sharp', 'ffmpeg-static'],
+    external: ['electron', 'electron-updater', 'sharp', 'ffmpeg-static'],
     define,
     drop: isProd ? ['console', 'debugger'] : [],
   };

scripts/gen-window-icon.mjs

@@ -1,5 +1,6 @@
 /**
  * Растеризует app-logo.svg в app-window-icon.png для nativeImage (Windows).
+ * Пишет build/icon.png (macOS / fallback) и build/icon.ico — для exe/NSIS и «Программы и компоненты».
  * Запуск: node scripts/gen-window-icon.mjs
  */
 import fs from 'node:fs';
@@ -7,6 +8,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { Resvg } from '@resvg/resvg-js';
+import toIco from 'to-ico';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const root = path.join(__dirname, '..');
@@ -29,4 +31,18 @@ const resvg512 = new Resvg(svg, {
 });
 const packOut = resvg512.render();
 fs.writeFileSync(packIconPath, packOut.asPng());
-console.log('wrote', packIconPath, packOut.width, 'x', packOut.height, '(electron-builder)');
+console.log('wrote', packIconPath, packOut.width, 'x', packOut.height, '(electron-builder mac / fallback)');
+
+function renderPngForWidth(width) {
+  const r = new Resvg(svg, {
+    fitTo: { mode: 'width', value: width },
+  });
+  return Buffer.from(r.render().asPng());
+}
+
+const icoSizes = [16, 24, 32, 48, 64, 128, 256];
+const icoPngs = icoSizes.map((w) => renderPngForWidth(w));
+const icoBuf = await toIco(icoPngs);
+const icoPath = path.join(buildDir, 'icon.ico');
+fs.writeFileSync(icoPath, icoBuf);
+console.log('wrote', icoPath, '(electron-builder win)');

scripts/sync-update-feed.mjs

@@ -0,0 +1,362 @@
+/**
+ * Складывает артефакты electron-builder (win + mac + linux) в публичный репозиторий,
+ * ветка `updates`, чтобы generic URL …/raw/branch/updates/ указывал на актуальные latest*.yml и установщики.
+ *
+ * Копирование **merge**: существующие файлы в ветке (другие ОС) не удаляются — обновляются только
+ * те имена, которые пришли из переданных каталогов артефактов.
+ *
+ * Переменные окружения:
+ *   DND_UPDATES_SERVER       — https://git.example.com (без слэша в конце)
+ *   UPDATES_REPO             — owner/repo (публичный репозиторий)
+ *   DND_UPDATES_PUSH_TOKEN   — PAT с правом push в UPDATES_REPO
+ *   ARTIFACT_WIN    — каталог с файлами Windows (можно пустой / отсутствует — пропуск)
+ *   ARTIFACT_MAC    — каталог с файлами macOS
+ *   ARTIFACT_LINUX  — каталог с файлами Linux (AppImage и т.д.)
+ *   GIT_COMMIT_TAG  — опционально, для сообщения коммита
+ *   DND_GIT_PUSH_RETRIES — опционально, число попыток git push (1–5, по умолчанию 3)
+ *   DND_UPDATES_CLONE_DEPTH — опционально, глубина shallow clone (2–200, по умолчанию 40), чтобы merge с remote был надёжнее
+ *   DND_FEED_TMP_ROOT — каталог для временного клона feed (по умолчанию GITHUB_WORKSPACE / TMPDIR / os.tmpdir); не используйте узкий /tmp на раннере
+ *   DND_GIT_FETCH_RETRIES — число попыток git fetch (1–6, по умолчанию 6); между попытками — git gc --prune=now (освобождение после обрыва TLS/unpack)
+ *   DND_FEED_SKIP_DISK_CHECK — если "1", не проверять свободное место на томе DND_FEED_TMP_ROOT перед clone
+ *   DND_UPDATES_SQUASH_HISTORY — если "1", после каждого релиза ветка updates в UPDATES_REPO — один корневой коммит (orphan + force-with-lease push), история не копится (меньше места на раннере и на сервере после GC)
+ */
+import { execFileSync, spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const ALLOWED_EXT = new Set(['.yml', '.yaml', '.exe', '.blockmap', '.zip', '.dmg', '.pkg', '.appimage']);
+
+/** Нет ветки updates на сервере — не путать с обрывом TLS. */
+const GIT_FETCH_MISSING_UPDATES_REF_RE = /couldn't find remote ref updates\b/i;
+
+/** Одинаковые флаги для clone (до появления .git/config) и согласованы с configureGitHttp. */
+function gitHttpInlineFlags() {
+  return [
+    '-c',
+    'http.version=HTTP/1.1',
+    '-c',
+    'http.postBuffer=2147483648',
+    '-c',
+    'http.lowSpeedLimit=0',
+    '-c',
+    'http.lowSpeedTime=0',
+  ];
+}
+
+function estimateArtifactBytes(winDir, macDir, linuxDir) {
+  const dirs = [...new Set([winDir, macDir, linuxDir].filter(Boolean))];
+  let total = 0;
+  for (const fromDir of dirs) {
+    if (!fromDir || !fs.existsSync(fromDir)) continue;
+    for (const name of fs.readdirSync(fromDir)) {
+      const p = path.join(fromDir, name);
+      if (!fs.statSync(p).isFile()) continue;
+      const ext = path.extname(name).toLowerCase();
+      if (!ALLOWED_EXT.has(ext)) continue;
+      total += fs.statSync(p).size;
+    }
+  }
+  return total;
+}
+
+/** Свободные байты на томе, где лежит tmpRoot; при ошибке — «достаточно». */
+function freeBytesOnVolume(tmpRoot) {
+  try {
+    const s = fs.statfsSync(tmpRoot);
+    const bavail = typeof s.bavail === 'bigint' ? Number(s.bavail) : s.bavail;
+    const bsize = typeof s.bsize === 'bigint' ? Number(s.bsize) : s.bsize;
+    if (!Number.isFinite(bavail) || !Number.isFinite(bsize)) return Number.MAX_SAFE_INTEGER;
+    return bavail * bsize;
+  } catch {
+    return Number.MAX_SAFE_INTEGER;
+  }
+}
+
+function assertFeedDiskHeadroom(tmpRoot, artifactBytes) {
+  if (process.env.DND_FEED_SKIP_DISK_CHECK?.trim() === '1') return;
+  const avail = freeBytesOnVolume(tmpRoot);
+  const minBytes = Math.max(2_000_000_000, Math.round(artifactBytes * 2.5) + 1_000_000_000);
+  if (avail < minBytes) {
+    throw new Error(
+      `[sync-update-feed] мало места на томе «${tmpRoot}»: свободно ~${(avail / 1e9).toFixed(2)} GiB, ` +
+        `нужно примерно ≥ ${(minBytes / 1e9).toFixed(2)} GiB (артефакты ~${(artifactBytes / 1e9).toFixed(2)} GiB + shallow clone/pack + git add). ` +
+        `Освободите диск на раннере, увеличьте том или задайте DND_FEED_TMP_ROOT на другой диск. Либо DND_FEED_SKIP_DISK_CHECK=1 (не рекомендуется).`,
+    );
+  }
+}
+
+function tryGitGcPrune(work) {
+  try {
+    execFileSync('git', ['gc', '--prune=now'], { cwd: work, stdio: 'ignore' });
+  } catch {
+    /* после оборванного fetch часть pack/tmp остаётся — gc освобождает; игнорируем сбой gc */
+  }
+}
+
+function mustEnv(name) {
+  const v = process.env[name]?.trim();
+  if (!v) throw new Error(`Missing env ${name}`);
+  return v;
+}
+
+function optionalDir(name) {
+  const v = process.env[name]?.trim();
+  return v && v.length > 0 ? v : '';
+}
+
+/** Куда класть временный клон: workspace раннера предпочтительнее, чем /tmp (место под AppImage). */
+function feedTempRoot() {
+  const a =
+    process.env.DND_FEED_TMP_ROOT?.trim() ||
+    process.env.GITHUB_WORKSPACE?.trim() ||
+    process.env.GITEA_WORKSPACE?.trim() ||
+    process.env.TMPDIR?.trim() ||
+    os.tmpdir();
+  return a;
+}
+
+/** Перенос (rename) без дублирования байтов на одном томе; иначе copy + unlink исходника (освобождение места). */
+function moveOrCopyArtifactFile(src, dest) {
+  if (fs.existsSync(dest)) {
+    fs.unlinkSync(dest);
+  }
+  try {
+    fs.renameSync(src, dest);
+    return;
+  } catch (e) {
+    const code = /** @type {NodeJS.ErrnoException} */ (e).code;
+    if (code !== 'EXDEV' && code !== 'EINVAL') throw e;
+  }
+  fs.copyFileSync(src, dest);
+  fs.unlinkSync(src);
+}
+
+function moveOrCopyFlatReleaseFiles(fromDir, toDir) {
+  if (!fromDir || !fs.existsSync(fromDir)) {
+    console.warn(`[sync-update-feed] skip missing dir: ${fromDir || '(empty)'}`);
+    return 0;
+  }
+  let n = 0;
+  for (const name of fs.readdirSync(fromDir)) {
+    const src = path.join(fromDir, name);
+    if (!fs.statSync(src).isFile()) continue;
+    const ext = path.extname(name).toLowerCase();
+    if (!ALLOWED_EXT.has(ext)) continue;
+    moveOrCopyArtifactFile(src, path.join(toDir, name));
+    n += 1;
+  }
+  return n;
+}
+
+function runGit(args, cwd) {
+  execFileSync('git', args, { cwd, stdio: 'inherit' });
+}
+
+/** Большие AppImage + exe в одном push: без этого Git по умолчанию может оборвать HTTPS (postBuffer / stall). */
+function configureGitHttpForLargePush(cwd) {
+  // 2 GiB — достаточно для пачки артефактов; на старых Git при необходимости поднять на сервере лимиты nginx/Gitea.
+  runGit(['config', 'http.version', 'HTTP/1.1'], cwd);
+  runGit(['config', 'http.postBuffer', '2147483648'], cwd);
+  runGit(['config', 'http.lowSpeedLimit', '0'], cwd);
+  runGit(['config', 'http.lowSpeedTime', '0'], cwd);
+}
+
+function sleepSyncSeconds(seconds) {
+  try {
+    execFileSync('sleep', [String(seconds)], { stdio: 'ignore' });
+  } catch {
+    const end = Date.now() + seconds * 1000;
+    while (Date.now() < end) {
+      /* fallback без утилиты sleep */
+    }
+  }
+}
+
+function feedSquashSingleCommitEnabled() {
+  return process.env.DND_UPDATES_SQUASH_HISTORY?.trim() === '1';
+}
+
+/** После merge и add: одна линия без истории (только репо UPDATES_REPO / ветка updates). */
+function squashUpdatesBranchToSingleCommit(work, message) {
+  const orphan = 'dnd-feed-squash-tmp';
+  runGit(['checkout', '--orphan', orphan], work);
+  runGit(['add', '-A'], work);
+  runGit(['commit', '-m', message], work);
+  runGit(['branch', '-D', 'updates'], work);
+  runGit(['branch', '-m', 'updates'], work);
+}
+
+function hadOriginUpdatesRemoteRef(work) {
+  try {
+    execFileSync('git', ['show-ref', '--verify', '--quiet', 'refs/remotes/origin/updates'], {
+      cwd: work,
+      stdio: 'ignore',
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** После squash не делаем merge перед push — вернёт старую историю с remote. */
+function pushUpdatesBranchAfterSquash(work) {
+  const retries = Math.max(1, Math.min(5, Number.parseInt(process.env.DND_GIT_PUSH_RETRIES || '3', 10) || 3));
+  const args = hadOriginUpdatesRemoteRef(work)
+    ? ['push', '--force-with-lease', '-u', 'origin', 'updates']
+    : ['push', '-u', 'origin', 'updates'];
+  let lastError;
+  for (let attempt = 1; attempt <= retries; attempt += 1) {
+    try {
+      console.log(`[sync-update-feed] push updates (squash, attempt ${attempt}/${retries})`);
+      execFileSync('git', args, { cwd: work, stdio: 'inherit' });
+      return;
+    } catch (err) {
+      lastError = err;
+      console.warn(`[sync-update-feed] push failed (attempt ${attempt}/${retries})`);
+      if (attempt < retries) {
+        sleepSyncSeconds(20);
+      }
+    }
+  }
+  throw lastError;
+}
+
+function mergeOriginUpdates(work) {
+  const fetchRetries = Math.max(
+    1,
+    Math.min(8, Number.parseInt(process.env.DND_GIT_FETCH_RETRIES || '6', 10) || 6),
+  );
+  let fetchOk = false;
+  /** @type {Error | undefined} */
+  let lastFetchErr;
+  for (let i = 0; i < fetchRetries; i += 1) {
+    const r = spawnSync('git', ['fetch', 'origin', 'updates'], {
+      cwd: work,
+      encoding: 'utf8',
+      maxBuffer: 64 * 1024 * 1024,
+    });
+    if (r.status === 0) {
+      fetchOk = true;
+      break;
+    }
+    const errText = `${r.stderr || ''}\n${r.stdout || ''}`;
+    if (GIT_FETCH_MISSING_UPDATES_REF_RE.test(errText)) {
+      console.warn('[sync-update-feed] ветки updates нет на remote — пропуск merge (первый push feed)');
+      return;
+    }
+    lastFetchErr = new Error(errText.trim() || `git fetch exited with status ${String(r.status)}`);
+    console.warn(`[sync-update-feed] git fetch failed (attempt ${i + 1}/${fetchRetries})`);
+    if (r.stderr?.trim()) {
+      console.warn(r.stderr.trim());
+    }
+    tryGitGcPrune(work);
+    if (i < fetchRetries - 1) {
+      sleepSyncSeconds(18);
+    }
+  }
+  if (!fetchOk) {
+    throw lastFetchErr ?? new Error('git fetch origin updates failed');
+  }
+  runGit(['merge', '--no-edit', 'origin/updates'], work);
+}
+
+function pushUpdatesBranch(work) {
+  const retries = Math.max(1, Math.min(5, Number.parseInt(process.env.DND_GIT_PUSH_RETRIES || '3', 10) || 3));
+  let lastError;
+  for (let attempt = 1; attempt <= retries; attempt += 1) {
+    try {
+      console.log(`[sync-update-feed] merge origin/updates before push (attempt ${attempt}/${retries})`);
+      mergeOriginUpdates(work);
+      runGit(['push', '-u', 'origin', 'updates'], work);
+      return;
+    } catch (err) {
+      lastError = err;
+      console.warn(`[sync-update-feed] merge/push failed (attempt ${attempt}/${retries})`);
+      if (attempt < retries) {
+        sleepSyncSeconds(20);
+      }
+    }
+  }
+  throw lastError;
+}
+
+function main() {
+  const server = mustEnv('DND_UPDATES_SERVER').replace(/\/+$/u, '');
+  const updatesRepo = mustEnv('UPDATES_REPO');
+  const token = mustEnv('DND_UPDATES_PUSH_TOKEN');
+  const winDir = optionalDir('ARTIFACT_WIN');
+  const macDir = optionalDir('ARTIFACT_MAC');
+  const linuxDir = optionalDir('ARTIFACT_LINUX');
+
+  const u = new URL(server);
+  const host = u.host;
+  const cloneUrl = `https://oauth2:${encodeURIComponent(token)}@${host}/${updatesRepo}.git`;
+
+  const tmpRoot = feedTempRoot();
+  fs.mkdirSync(tmpRoot, { recursive: true });
+  assertFeedDiskHeadroom(tmpRoot, estimateArtifactBytes(winDir, macDir, linuxDir));
+  const tmp = fs.mkdtempSync(path.join(tmpRoot, 'dnd-feed-'));
+  const work = path.join(tmp, 'repo');
+
+  const squash = feedSquashSingleCommitEnabled();
+  const cloneDepth = squash
+    ? Math.max(1, Math.min(200, Number.parseInt(process.env.DND_UPDATES_CLONE_DEPTH || '8', 10) || 8))
+    : Math.max(2, Math.min(200, Number.parseInt(process.env.DND_UPDATES_CLONE_DEPTH || '40', 10) || 40));
+
+  const gh = gitHttpInlineFlags();
+  try {
+    execFileSync('git', [...gh, 'clone', `--depth=${String(cloneDepth)}`, '-b', 'updates', cloneUrl, work], {
+      stdio: 'inherit',
+    });
+  } catch {
+    execFileSync('git', [...gh, 'clone', `--depth=${String(cloneDepth)}`, cloneUrl, work], {
+      stdio: 'inherit',
+    });
+    runGit(['checkout', '-B', 'updates'], work);
+  }
+
+  runGit(['config', 'user.email', 'ci@gitea-actions.local'], work);
+  runGit(['config', 'user.name', 'gitea-actions'], work);
+  configureGitHttpForLargePush(work);
+
+  mergeOriginUpdates(work);
+
+  const artifactDirs = [...new Set([winDir, macDir, linuxDir].filter(Boolean))];
+  let copied = 0;
+  for (const d of artifactDirs) {
+    copied += moveOrCopyFlatReleaseFiles(d, work);
+  }
+  if (copied === 0) {
+    throw new Error(
+      '[sync-update-feed] no release files copied (check ARTIFACT_WIN / ARTIFACT_MAC / ARTIFACT_LINUX)',
+    );
+  }
+
+  const tag = process.env.GIT_COMMIT_TAG?.trim() || 'ci';
+  runGit(['add', '-A'], work);
+  const st = execFileSync('git', ['status', '--porcelain'], { cwd: work }).toString().trim();
+  if (st) {
+    const msg = `update feed ${tag}`;
+    if (squash) {
+      console.warn(
+        '[sync-update-feed] DND_UPDATES_SQUASH_HISTORY=1: одна линия в UPDATES_REPO (orphan + force-with-lease при наличии origin/updates)',
+      );
+      squashUpdatesBranchToSingleCommit(work, msg);
+      pushUpdatesBranchAfterSquash(work);
+    } else {
+      runGit(['commit', '-m', msg], work);
+      pushUpdatesBranch(work);
+    }
+  } else {
+    console.warn('[sync-update-feed] nothing to commit (identical artifacts?)');
+  }
+
+  fs.rmSync(tmp, { recursive: true, force: true });
+  console.log(`[sync-update-feed] done (${String(copied)} file(s) into feed repo)`);
+}
+
+main();