fiz mac build

Set build.publish.url to the production HTTPS feed, bump version to 1.0.16, add publish-to-updates.ps1 for VPS upload, and normalize Linux AppImage names from x86_64 to x64 after pack:linux.

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

.gitattributes

@@ -0,0 +1 @@
+*.sh text eol=lf

.gitea/workflows/release.yml

@@ -1,118 +0,0 @@
-# Сборка по тегу v* и выкладка в публичный репо (ветка updates).
-#
-# Метки runs-on = labels твоих act_runner (Админка Gitea → Действия → Раннеры).
-# Не используем windows-latest/macos-latest — это только GitHub-hosted.
-# По умолчанию: одна Linux-сборка Win+NSIS (Wine). macOS — когда будет раннер (см. комментарий в build-macos).
-#
-# Один 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
-
-      - 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}"
-
-      - name: Каталог артефактов для feed (_win)
-        shell: bash
-        run: |
-          mkdir -p _win
-          shopt -s nullglob || true
-          for f in release/*; do
-            [[ -f "$f" ]] || continue
-            base=$(basename "$f")
-            case "$base" in
-              *.yml|*.yaml|*.exe|*.blockmap|*.zip) cp -v "$f" _win/ ;;
-            esac
-          done
-          ls -la _win
-
-      - name: Пустой каталог mac (пока нет сборки mac в CI)
-        run: mkdir -p _mac
-
-      - name: Push в публичный репозиторий updates
-        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 }}/_win
-          ARTIFACT_MAC: ${{ github.workspace }}/_mac
-          GIT_COMMIT_TAG: ${{ github.ref_name }}
-        run: node scripts/sync-update-feed.mjs
-
-  # Когда появится macOS-раннер: отдельный job build-macos, копирование eb-mac в _mac перед sync
-  # или расширить шаг «Каталог артефактов»; сейчас всё в одном job `release`.
-  #
-  # build-macos:
-  #   runs-on: macos-14
-  #   steps: ...

.nvmrc

@@ -0,0 +1 @@
+22.22.3

app/main/index.ts

@@ -1,6 +1,14 @@
 import { app, BrowserWindow, dialog, Menu, protocol } from 'electron';
 
 import { ipcChannels, type SessionState } from '../shared/ipc/contracts';
+import {
+  PROJECT_ZIP_OPEN_DIALOG_FILTER,
+  PROJECT_ZIP_SAVE_DIALOG_FILTER,
+  isProjectZipFileName,
+  normalizeSaveProjectZipPath,
+  projectZipFileNameFromBase,
+  stripProjectZipExtension,
+} from '../shared/project/projectZipExtension';
 
 import { EffectsStore } from './effects/effectsStore';
 import { installIpcRouter, registerHandler, setLicenseAssert } from './ipc/router';
@@ -52,7 +60,7 @@ if (process.platform === 'win32' && app.isPackaged && process.env.DND_DISABLE_GP
 }
 
 if (process.platform === 'win32') {
-  app.setAppUserModelId('com.dndplayer.app');
+  app.setAppUserModelId('com.ttrpgplayer.app');
 }
 // Не вызывать app.setName() с другим именем: на Windows/macOS меняется каталог userData,
 // и проекты в …/userData/projects «пропадают» из списка (остаются в старой папке).
@@ -252,6 +260,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));
@@ -446,7 +455,7 @@ async function main() {
   registerHandler(ipcChannels.project.importZip, async () => {
     const { canceled, filePaths } = await dialog.showOpenDialog({
       properties: ['openFile'],
-      filters: [{ name: 'Проект DND (*.dnd.zip)', extensions: ['dnd.zip'] }],
+      filters: [PROJECT_ZIP_OPEN_DIALOG_FILTER],
     });
     if (canceled || !filePaths[0]) {
       return { canceled: true as const };
@@ -472,21 +481,19 @@ async function main() {
     if (!entry) {
       throw new Error('Проект не найден');
     }
-    const defaultName = entry.fileName.toLowerCase().endsWith('.dnd.zip')
+    const defaultName = isProjectZipFileName(entry.fileName)
-      ? entry.fileName
+      ? entry.fileName.toLowerCase().endsWith('.ttrpg.zip')
-      : `${entry.fileName}.dnd.zip`;
+        ? entry.fileName
+        : projectZipFileNameFromBase(stripProjectZipExtension(entry.fileName))
+      : projectZipFileNameFromBase(stripProjectZipExtension(entry.fileName));
     const { canceled, filePath } = await dialog.showSaveDialog({
       defaultPath: defaultName,
-      filters: [{ name: 'Проект DND (*.dnd.zip)', extensions: ['dnd.zip'] }],
+      filters: [PROJECT_ZIP_SAVE_DIALOG_FILTER],
     });
     if (canceled || !filePath) {
       return { canceled: true as const };
     }
-    let dest = filePath;
+    const dest = normalizeSaveProjectZipPath(filePath);
-    const lower = dest.toLowerCase();
-    if (!lower.endsWith('.dnd.zip')) {
-      dest = lower.endsWith('.zip') ? dest.replace(/\.zip$/iu, '.dnd.zip') : `${dest}.dnd.zip`;
-    }
     emitZipProgress({ kind: 'export', stage: 'copy', percent: 0, detail: 'Экспорт…' });
     await projectStore.exportProjectZipToPath(projectId, dest, (p) => {
       emitZipProgress({
@@ -526,9 +533,9 @@ async function main() {
     return { ok: true };
   });
 
+  installAutoUpdater(licenseService, registerHandler);
   installIpcRouter();
   applyDockIconIfNeeded();
-  installAutoUpdater(licenseService);
   await runStartupAfterHandlers(licenseService);
 
   app.on('activate', () => {

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

@@ -1,3 +1,4 @@
+import crypto from 'node:crypto';
 import fs from 'node:fs';
 
 import { BrowserWindow, safeStorage } from 'electron';
@@ -6,11 +7,11 @@ import { ipcChannels } from '../../shared/ipc/contracts';
 import { EULA_CURRENT_VERSION } from '../../shared/license/eulaVersion';
 import type { LicenseSnapshot } from '../../shared/license/licenseSnapshot';
 import type { LicensePayloadV1 } from '../../shared/license/payloadV1';
-import { isDndProductKey } from '../../shared/license/productKey';
+import { isProductKey } from '../../shared/license/productKey';
 import { normalizeLicenseTokenInput } from '../../shared/license/tokenFormat';
 
 import { getOrCreateDeviceId } from './deviceId';
-import { licenseEncryptedPath, preferencesPath } from './paths';
+import { licenseEncryptedPath, licenseFallbackSealedPath, preferencesPath } from './paths';
 import { verifyLicenseToken } from './verifyLicenseToken';
 
 type Preferences = {
@@ -19,6 +20,8 @@ type Preferences = {
 
 type LicenseChangeListener = () => void;
 
+const FALLBACK_MAGIC = Buffer.from('DNDLF1', 'ascii');
+
 const licenseChangeListeners = new Set<LicenseChangeListener>();
 
 /** Слушатели вызываются после смены состояния лицензии (сохранённый токен, EULA, отзыв). */
@@ -75,23 +78,93 @@ export class LicenseService {
     return process.env.DND_SKIP_LICENSE === '1' || process.env.DND_SKIP_LICENSE === 'true';
   }
 
-  private readSealedToken(): string | null {
+  /** Только для окружений без OS keychain (WSL и т.п.); слабее safeStorage — см. licensing-spec. */
-    const p = licenseEncryptedPath(this.userData);
+  private isInsecureFileStorageAllowed(): boolean {
-    if (!fs.existsSync(p)) return null;
+    const v = process.env.DND_LICENSE_INSECURE_FILE_STORAGE?.trim().toLowerCase();
-    if (!safeStorage.isEncryptionAvailable()) {
+    return v === '1' || v === 'true' || v === 'yes';
-      throw new Error('safeStorage недоступен: нельзя расшифровать лицензию на этой системе');
+  }
-    }
+
+  private deriveFallbackKey(): Buffer {
+    return crypto
+      .createHash('sha256')
+      .update('TTRPGPlayer.license.fallback.v1\0', 'utf8')
+      .update(this.deviceId, 'utf8')
+      .digest();
+  }
+
+  private readFallbackSealedToken(): string {
+    const p = licenseFallbackSealedPath(this.userData);
     const buf = fs.readFileSync(p);
-    return safeStorage.decryptString(buf);
+    if (buf.length < FALLBACK_MAGIC.length + 12 + 16 + 1) {
+      throw new Error('license.fallback: файл повреждён или слишком короткий');
+    }
+    if (!buf.subarray(0, FALLBACK_MAGIC.length).equals(FALLBACK_MAGIC)) {
+      throw new Error('license.fallback: неверный формат');
+    }
+    const iv = buf.subarray(FALLBACK_MAGIC.length, FALLBACK_MAGIC.length + 12);
+    const tag = buf.subarray(FALLBACK_MAGIC.length + 12, FALLBACK_MAGIC.length + 12 + 16);
+    const data = buf.subarray(FALLBACK_MAGIC.length + 12 + 16);
+    const key = this.deriveFallbackKey();
+    const decipher = crypto.createDecipheriv('aes-256-gcm', key, iv);
+    decipher.setAuthTag(tag);
+    return Buffer.concat([decipher.update(data), decipher.final()]).toString('utf8');
+  }
+
+  private writeFallbackSealedToken(token: string): void {
+    const key = this.deriveFallbackKey();
+    const iv = crypto.randomBytes(12);
+    const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
+    const enc = Buffer.concat([cipher.update(token, 'utf8'), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    const payload = Buffer.concat([FALLBACK_MAGIC, iv, tag, enc]);
+    fs.writeFileSync(licenseFallbackSealedPath(this.userData), payload, { mode: 0o600 });
+  }
+
+  private readSealedToken(): string | null {
+    const sealedPath = licenseEncryptedPath(this.userData);
+    const fallbackPath = licenseFallbackSealedPath(this.userData);
+
+    if (fs.existsSync(sealedPath)) {
+      if (!safeStorage.isEncryptionAvailable()) {
+        throw new Error(
+          'safeStorage недоступен: есть license.sealed, но расшифровать нельзя (часто перенос профиля или WSL без keyring). Удалите файл лицензии в настройках приложения или используйте DND_LICENSE_INSECURE_FILE_STORAGE=1 и активируйте заново.',
+        );
+      }
+      const buf = fs.readFileSync(sealedPath);
+      return safeStorage.decryptString(buf);
+    }
+
+    if (fs.existsSync(fallbackPath)) {
+      return this.readFallbackSealedToken();
+    }
+
+    return null;
   }
 
   private writeSealedToken(token: string): void {
-    if (!safeStorage.isEncryptionAvailable()) {
-      throw new Error('safeStorage недоступен: нельзя сохранить лицензию на этой системе');
-    }
     fs.mkdirSync(this.userData, { recursive: true });
-    const enc = safeStorage.encryptString(token);
+    if (safeStorage.isEncryptionAvailable()) {
-    fs.writeFileSync(licenseEncryptedPath(this.userData), enc);
+      const enc = safeStorage.encryptString(token);
+      fs.writeFileSync(licenseEncryptedPath(this.userData), enc);
+      try {
+        fs.unlinkSync(licenseFallbackSealedPath(this.userData));
+      } catch {
+        /* ok */
+      }
+      return;
+    }
+    if (this.isInsecureFileStorageAllowed()) {
+      this.writeFallbackSealedToken(token);
+      try {
+        fs.unlinkSync(licenseEncryptedPath(this.userData));
+      } catch {
+        /* ok */
+      }
+      return;
+    }
+    throw new Error(
+      'safeStorage недоступен: нельзя сохранить лицензию на этой системе (типично WSL без gnome-keyring). Запустите с переменной DND_LICENSE_INSECURE_FILE_STORAGE=1 — токен будет сохранён в зашифрованном файле (слабее OS-хранилища); либо настройте Secret Service / gnome-keyring.',
+    );
   }
 
   private clearSealedTokenFile(): void {
@@ -100,6 +173,11 @@ export class LicenseService {
     } catch {
       /* ok */
     }
+    try {
+      fs.unlinkSync(licenseFallbackSealedPath(this.userData));
+    } catch {
+      /* ok */
+    }
   }
 
   /** База для `POST /v1/activate` (и при желании совпадает с сервером отзыва). */
@@ -264,7 +342,7 @@ export class LicenseService {
       return this.getStatusSync();
     }
     let trimmed = normalizeLicenseTokenInput(token);
-    if (isDndProductKey(trimmed)) {
+    if (isProductKey(trimmed)) {
       trimmed = await this.activateWithProductKey(trimmed);
     }
     const nowSec = Math.floor(Date.now() / 1000);

app/main/license/paths.ts

@@ -4,6 +4,11 @@ export function licenseEncryptedPath(userData: string): string {
   return path.join(userData, 'license.sealed');
 }
 
+/** Fallback, если нет OS keychain (WSL без gnome-keyring и т.п.); только при DND_LICENSE_INSECURE_FILE_STORAGE=1. */
+export function licenseFallbackSealedPath(userData: string): string {
+  return path.join(userData, 'license.sealed.fallback');
+}
+
 export function deviceIdPath(userData: string): string {
   return path.join(userData, 'device.id');
 }

app/main/project/atomicReplace.ts

@@ -2,10 +2,16 @@ import crypto from 'node:crypto';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
+import {
+  PROJECT_ZIP_EXTENSION,
+  PROJECT_ZIP_EXTENSION_LEGACY,
+  isProjectZipFileName,
+} from '../../shared/project/projectZipExtension';
+
 import { readProjectJsonFromZip } from './yauzlProjectZip';
 
 /**
- * Подменяет файл `finalPath` готовым `completedSrc` (обычно `*.dnd.zip.tmp`).
+ * Подменяет файл `finalPath` готовым `completedSrc` (обычно `*.ttrpg.zip.tmp` / `*.dnd.zip.tmp`).
  * Нельзя сначала удалять `finalPath`: при сбое rename после rm проект теряется (Windows/антивирус).
  */
 export async function replaceFileAtomic(completedSrc: string, finalPath: string): Promise<void> {
@@ -50,8 +56,10 @@ export async function replaceFileAtomic(completedSrc: string, finalPath: string)
   await fs.unlink(backupPath).catch(() => undefined);
 }
 
-/** Если сохранение оборвалось, остаётся только `*.dnd.zip.tmp` — восстанавливаем в `*.dnd.zip`. */
+const ZIP_TMP_SUFFIXES = [`${PROJECT_ZIP_EXTENSION}.tmp`, `${PROJECT_ZIP_EXTENSION_LEGACY}.tmp`] as const;
-export async function recoverOrphanDndZipTmpInRoot(root: string): Promise<void> {
+
+/** Если сохранение оборвалось, остаётся `*.ttrpg.zip.tmp` / `*.dnd.zip.tmp` — восстанавливаем финальный архив. */
+export async function recoverOrphanProjectZipTmpInRoot(root: string): Promise<void> {
   let names: string[];
   try {
     names = await fs.readdir(root);
@@ -59,10 +67,11 @@ export async function recoverOrphanDndZipTmpInRoot(root: string): Promise<void>
     return;
   }
   for (const name of names) {
-    if (!name.endsWith('.dnd.zip.tmp')) continue;
+    const matchedSuffix = ZIP_TMP_SUFFIXES.find((s) => name.endsWith(s));
+    if (!matchedSuffix) continue;
     const tmpPath = path.join(root, name);
     const finalName = name.slice(0, -'.tmp'.length);
-    if (!finalName.endsWith('.dnd.zip')) continue;
+    if (!isProjectZipFileName(finalName)) continue;
     const finalPath = path.join(root, finalName);
     try {
       await fs.access(finalPath);
@@ -80,3 +89,6 @@ export async function recoverOrphanDndZipTmpInRoot(root: string): Promise<void>
     }
   }
 }
+
+/** @deprecated Используйте {@link recoverOrphanProjectZipTmpInRoot}. */
+export const recoverOrphanDndZipTmpInRoot = recoverOrphanProjectZipTmpInRoot;

app/main/project/paths.ts

@@ -17,7 +17,14 @@ export function getProjectsCacheRootDir(): string {
 export function getLegacyProjectsRootDirs(): string[] {
   const cur = getProjectsRootDir();
   const parent = path.dirname(app.getPath('userData'));
-  const siblingNames = ['DnD Player', 'dnd-player', 'DNDGamePlayer', 'dnd_player'];
+  const siblingNames = [
+    'TTRPG Player',
+    'TTRPGPlayer',
+    'DnD Player',
+    'dnd-player',
+    'DNDGamePlayer',
+    'dnd_player',
+  ];
   const out: string[] = [];
   for (const n of siblingNames) {
     const p = path.join(parent, n, 'projects');

app/main/project/zipRead.test.ts

@@ -13,7 +13,7 @@ import { readProjectJsonFromZip } from './yauzlProjectZip';
 
 void test('readProjectJsonFromZip: sequential reads close yauzl (no EMFILE)', async () => {
   const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'dnd-zip-read-'));
-  const zipPath = path.join(tmp, 'test.dnd.zip');
+  const zipPath = path.join(tmp, 'test.ttrpg.zip');
   const minimal = {
     id: 'p1',
     meta: {
@@ -54,7 +54,7 @@ void test('readProjectJsonFromZip: sequential reads close yauzl (no EMFILE)', as
 
 void test('readProjectJsonFromZip: campaignAudios round-trips inside project.json', async () => {
   const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'dnd-zip-campaign-'));
-  const zipPath = path.join(tmp, 'test.dnd.zip');
+  const zipPath = path.join(tmp, 'test.ttrpg.zip');
   const assetId = 'audio_asset_1';
   const minimal = {
     id: 'p1',

app/main/project/zipStore.legacyContract.test.ts

@@ -58,7 +58,7 @@ void test('atomicReplace: replaceFileAtomic must not rm destination before succe
   const src = fs.readFileSync(path.join(here, 'atomicReplace.ts'), 'utf8');
   const i = src.indexOf('export async function replaceFileAtomic');
   assert.ok(i >= 0);
-  const j = src.indexOf('export async function recoverOrphanDndZipTmpInRoot', i);
+  const j = src.indexOf('export async function recoverOrphanProjectZipTmpInRoot', i);
   assert.ok(j > i);
   const block = src.slice(i, j);
   assert.match(block, /rename\(finalPath, backupPath\)/);

app/main/project/zipStore.ts

@@ -8,6 +8,11 @@ import { ZipFile } from 'yazl';
 
 import { isSceneGraphEdgeRejected } from '../../shared/graph/sceneGraphEdgeRules';
 import type { ScenePatch } from '../../shared/ipc/contracts';
+import {
+  isProjectZipFileName,
+  projectZipFileNameFromBase,
+  stripProjectZipExtension,
+} from '../../shared/project/projectZipExtension';
 import type {
   MediaAsset,
   MediaAssetType,
@@ -24,7 +29,7 @@ import { asAssetId, asGraphNodeId, asProjectId } from '../../shared/types/ids';
 import { getAppSemanticVersion } from '../versionInfo';
 
 import { reconcileAssetFiles } from './assetPrune';
-import { recoverOrphanDndZipTmpInRoot, replaceFileAtomic } from './atomicReplace';
+import { recoverOrphanProjectZipTmpInRoot, replaceFileAtomic } from './atomicReplace';
 import { rmWithRetries } from './fsRetry';
 import { optimizeImageBufferVisuallyLossless } from './optimizeImageImport.lib.mjs';
 import { getLegacyProjectsRootDirs, getProjectsCacheRootDir, getProjectsRootDir } from './paths';
@@ -76,10 +81,10 @@ export class ZipProjectStore {
     await fs.mkdir(getProjectsRootDir(), { recursive: true });
     await fs.mkdir(getProjectsCacheRootDir(), { recursive: true });
     await this.migrateLegacyProjectZipsIfNeeded();
-    await recoverOrphanDndZipTmpInRoot(getProjectsRootDir());
+    await recoverOrphanProjectZipTmpInRoot(getProjectsRootDir());
   }
 
-  /** Копирует .dnd.zip из каталогов с «чужим» app name, если в текущем каталоге такого файла ещё нет. */
+  /** Копирует архивы проектов из каталогов с «чужим» app name, если в текущем каталоге такого файла ещё нет. */
   private async migrateLegacyProjectZipsIfNeeded(): Promise<void> {
     const dest = getProjectsRootDir();
     let destNames: string[];
@@ -88,7 +93,7 @@ export class ZipProjectStore {
     } catch {
       return;
     }
-    const destZips = new Set(destNames.filter((n) => n.endsWith('.dnd.zip')));
+    const destZips = new Set(destNames.filter((n) => isProjectZipFileName(n)));
     for (const legacyRoot of getLegacyProjectsRootDirs()) {
       let legacyNames: string[];
       try {
@@ -97,7 +102,7 @@ export class ZipProjectStore {
         continue;
       }
       for (const name of legacyNames) {
-        if (!name.endsWith('.dnd.zip')) continue;
+        if (!isProjectZipFileName(name)) continue;
         if (destZips.has(name)) continue;
         const from = path.join(legacyRoot, name);
         const to = path.join(dest, name);
@@ -132,7 +137,7 @@ export class ZipProjectStore {
     const root = getProjectsRootDir();
     const entries = await fs.readdir(root, { withFileTypes: true });
     const files = entries
-      .filter((e) => e.isFile() && e.name.endsWith('.dnd.zip'))
+      .filter((e) => e.isFile() && isProjectZipFileName(e.name))
       .map((e) => path.join(root, e.name));
 
     const out: ProjectIndexEntry[] = [];
@@ -180,7 +185,7 @@ export class ZipProjectStore {
       sceneGraphEdges: [],
     };
 
-    const zipPath = path.join(getProjectsRootDir(), `${fileBaseName}.dnd.zip`);
+    const zipPath = path.join(getProjectsRootDir(), projectZipFileNameFromBase(fileBaseName));
     const cacheDir = path.join(getProjectsCacheRootDir(), id);
     const projectPath = path.join(cacheDir, 'project.json');
     this.openProject = { id, zipPath, cacheDir, projectPath, project };
@@ -778,7 +783,7 @@ export class ZipProjectStore {
     const list = await this.listProjects();
 
     const oldBase = open.project.meta.fileBaseName;
-    const nextFileName = `${sanitizedBase}.dnd.zip`;
+    const nextFileName = projectZipFileNameFromBase(sanitizedBase);
 
     const nameClash = list.some(
       (p) => p.id !== open.id && p.name.trim().toLowerCase() === nextName.toLowerCase(),
@@ -897,8 +902,8 @@ export class ZipProjectStore {
     if (!st?.isFile()) {
       throw new Error('Файл проекта не найден');
     }
-    if (!resolved.toLowerCase().endsWith('.dnd.zip')) {
+    if (!isProjectZipFileName(resolved)) {
-      throw new Error('Ожидается файл с расширением .dnd.zip');
+      throw new Error('Ожидается файл проекта с расширением .ttrpg.zip или .dnd.zip');
     }
 
     const root = getProjectsRootDir();
@@ -909,11 +914,11 @@ export class ZipProjectStore {
     let destPath: string;
     let destFileName: string;
 
-    if (dirNorm === rootNorm && baseName.toLowerCase().endsWith('.dnd.zip')) {
+    if (dirNorm === rootNorm && isProjectZipFileName(baseName)) {
       destPath = resolved;
       destFileName = baseName;
     } else {
-      destFileName = await uniqueDndZipFileName(root, baseName);
+      destFileName = await uniqueProjectZipFileNameInRoot(root, baseName);
       destPath = path.join(root, destFileName);
       if (onProgress) onProgress({ stage: 'copy', percent: 1, detail: 'Копирование…' });
       await copyFileWithProgress(resolved, destPath, (pct) => {
@@ -930,7 +935,7 @@ export class ZipProjectStore {
     const othersWithSameId = entries.filter((e) => e.id === project.id && e.fileName !== destFileName);
     if (othersWithSameId.length > 0) {
       const newId = asProjectId(this.randomId());
-      const stem = destFileName.replace(/\.dnd\.zip$/iu, '');
+      const stem = stripProjectZipExtension(destFileName);
       project = {
         ...project,
         id: newId,
@@ -1217,20 +1222,15 @@ function sanitizeFileName(name: string): string {
   return safe.length > 0 ? safe : 'Untitled';
 }
 
-async function uniqueDndZipFileName(root: string, preferredBaseFileName: string): Promise<string> {
+async function uniqueProjectZipFileNameInRoot(root: string, preferredBaseFileName: string): Promise<string> {
-  let base = preferredBaseFileName;
+  const stem = sanitizeFileName(stripProjectZipExtension(path.basename(preferredBaseFileName)) || 'project');
-  if (!base.toLowerCase().endsWith('.dnd.zip')) {
+  let candidate = projectZipFileNameFromBase(stem);
-    const stem = sanitizeFileName(path.basename(base, path.extname(base)) || 'project');
-    base = `${stem}.dnd.zip`;
-  }
-  const stem = base.replace(/\.dnd\.zip$/iu, '');
-  let candidate = base;
   let n = 0;
   for (;;) {
     try {
       await fs.access(path.join(root, candidate));
       n += 1;
-      candidate = `${stem}_${String(n)}.dnd.zip`;
+      candidate = projectZipFileNameFromBase(`${stem}_${String(n)}`);
     } catch {
       return candidate;
     }

app/main/update/installAutoUpdater.ts

@@ -1,6 +1,13 @@
 import { app, dialog } from 'electron';
 import { autoUpdater } from 'electron-updater';
 
+import { appDisplayNameForLocale } from '../../shared/appBranding';
+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';
 
@@ -9,6 +16,10 @@ const STARTUP_CHECK_DELAY_MS = 12_000;
 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();
@@ -24,11 +35,54 @@ function maybeCheckForUpdates(licenseService: LicenseService, ignoreCooldown: bo
   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` внутри установки).
+ * Дифференциальное скачивание (HTTP Range / blockmap) по умолчанию **выключено**: за nginx у Gitea raw часто **400** на multi-Range, updater всё равно уходит в полный файл. Включить снова: **`DND_UPDATE_ENABLE_DIFFERENTIAL=1`** (имеет смысл только если на сервере починили Range).
  */
-export function installAutoUpdater(licenseService: LicenseService): void {
+export function installAutoUpdater(licenseService: LicenseService, register: RegisterFn): void {
+  registerUpdaterHandlers(register, licenseService);
+
   if (!app.isPackaged) return;
 
   const feedOverride = process.env.DND_UPDATE_FEED_URL?.trim();
@@ -37,14 +91,27 @@ export function installAutoUpdater(licenseService: LicenseService): void {
     autoUpdater.setFeedURL({ provider: 'generic', url });
   }
 
+  // Дифференциальное обновление (multi-Range по blockmap) часто ломается на Gitea raw за nginx (HTTP 400);
+  // electron-updater тогда и так падает на полный файл — отключаем лишний шум и лишний round-trip.
+  const enableDiff = process.env.DND_UPDATE_ENABLE_DIFFERENTIAL?.trim().toLowerCase();
+  autoUpdater.disableDifferentialDownload = !(
+    enableDiff === '1' ||
+    enableDiff === 'true' ||
+    enableDiff === 'yes'
+  );
+
   autoUpdater.autoDownload = true;
   autoUpdater.autoInstallOnAppQuit = true;
 
   autoUpdater.on('update-downloaded', (info) => {
+    if (suppressAutoInstallDialog) {
+      suppressAutoInstallDialog = false;
+      return;
+    }
     void dialog
       .showMessageBox({
         type: 'info',
-        title: 'DNDGamePlayer',
+        title: appDisplayNameForLocale(app.getLocale()),
         message: `Доступна новая версия ${info.version}. Установить и перезапустить?`,
         buttons: ['Перезапустить сейчас', 'Позже'],
         defaultId: 0,

app/main/windows/bootWindow.ts

@@ -2,8 +2,11 @@ import path from 'node:path';
 
 import { app, BrowserWindow } from 'electron';
 
+import { appDisplayNameForLocale } from '../../shared/appBranding';
 import { getAppSemanticVersion } from '../versionInfo';
 
+import { loadBrandingWindowIcon } from './brandingIcon';
+
 let bootSplashRef: BrowserWindow | null = null;
 
 export function getBootSplashWindow(): BrowserWindow | null {
@@ -37,6 +40,7 @@ function bootWebPreferences(): Electron.WebPreferences {
  * Показывать после `waitForBootWindowReady`.
  */
 export function createBootWindow(): BrowserWindow {
+  const icon = loadBrandingWindowIcon();
   const win = new BrowserWindow({
     width: 440,
     height: 420,
@@ -50,8 +54,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', () => {
@@ -82,7 +94,7 @@ export function setBootWindowStatus(win: BrowserWindow, text: string): void {
 
 export function applyBootWindowBranding(win: BrowserWindow): void {
   if (win.isDestroyed()) return;
-  const name = app.getName();
+  const name = appDisplayNameForLocale(app.getLocale());
   const version = getAppSemanticVersion();
   const versionLabel = version.trim().length > 0 ? `v${version.trim()}` : '';
   void win.webContents.executeJavaScript(

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';
 
@@ -69,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 */
-    }
   }
 }
 
@@ -180,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,
@@ -199,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);

app/renderer/boot.html

@@ -113,7 +113,7 @@
     <div class="wrap">
       <div class="card">
         <img class="logo" src="./app-window-icon.png" width="72" height="72" alt="" />
-        <h1 class="title" data-boot-title>DNDGamePlayer</h1>
+        <h1 class="title" data-boot-title>TTRPG Player</h1>
         <p class="subtitle">редактор и проигрыватель</p>
         <p class="version" data-boot-version></p>
         <p class="status" id="boot-status">Запуск…</p>

app/renderer/editor/EditorApp.tsx

@@ -1,9 +1,10 @@
-import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import React, { startTransition, useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
 
-import { ipcChannels } from '../../shared/ipc/contracts';
+import { ipcChannels, type UpdaterCheckResponse } from '../../shared/ipc/contracts';
 import { EULA_CURRENT_VERSION } from '../../shared/license/eulaVersion';
 import type { LicenseSnapshot } from '../../shared/license/licenseSnapshot';
+import { PROJECT_ZIP_EXTENSION } from '../../shared/project/projectZipExtension';
 import type { AssetId, MediaAsset, Project, ProjectId, SceneAudioRef, SceneId } from '../../shared/types';
 import { AppLogo } from '../shared/branding/AppLogo';
 import { getDndApi } from '../shared/dndApi';
@@ -76,6 +77,8 @@ export function EditorApp() {
   const [previewBusy, setPreviewBusy] = useState(false);
   const [presentationOpen, setPresentationOpen] = useState(false);
   const [licenseSnap, setLicenseSnap] = useState<LicenseSnapshot | null>(null);
+  const [checkUpdatesOpen, setCheckUpdatesOpen] = useState(false);
+  const [appPackaged, setAppPackaged] = useState(false);
   const [licenseKeyModalOpen, setLicenseKeyModalOpen] = useState(false);
   const [eulaModalOpen, setEulaModalOpen] = useState(false);
   const [aboutLicenseOpen, setAboutLicenseOpen] = useState(false);
@@ -305,6 +308,7 @@ export function EditorApp() {
         const r = await getDndApi().invoke(ipcChannels.app.getVersion, {});
         const label = r.buildNumber ? `v${r.version} · ${r.buildNumber}` : `v${r.version}`;
         setAppVersionText(label);
+        setAppPackaged(r.packaged);
       } catch {
         setAppVersionText(null);
       }
@@ -374,7 +378,7 @@ export function EditorApp() {
               title={t('top.backToProjects')}
             >
               <AppLogo className={styles.brandLogo} size={26} />
-              <div className={styles.brandTitle}>DNDGamePlayer</div>
+              <div className={styles.brandTitle}>{t('app.brandTitle')}</div>
             </button>
             <div className={styles.fileToolbar}>
               <button
@@ -647,6 +651,20 @@ export function EditorApp() {
               >
                 {t('menu.aboutLicense')}
               </button>
+              {licenseActive && appPackaged ? (
+                <button
+                  type="button"
+                  role="menuitem"
+                  className={styles.fileMenuItem}
+                  onClick={() => {
+                    setSettingsMenuOpen(false);
+                    setSettingsLangSubOpen(false);
+                    setCheckUpdatesOpen(true);
+                  }}
+                >
+                  {t('menu.checkUpdates')}
+                </button>
+              ) : null}
               <div className={styles.fileMenuSubHost} role="presentation">
                 <button
                   type="button"
@@ -819,6 +837,7 @@ export function EditorApp() {
           await actions.exportProject(projectId);
         }}
       />
+      <CheckUpdatesModal open={checkUpdatesOpen} onClose={() => setCheckUpdatesOpen(false)} />
       <SimpleMessageModal
         open={appNotice !== null}
         title={appNotice?.title ?? t('common.message')}
@@ -941,6 +960,136 @@ function ExportProjectModal({
   );
 }
 
+type CheckUpdatesModalProps = {
+  open: boolean;
+  onClose: () => void;
+};
+
+function CheckUpdatesModal({ open, onClose }: CheckUpdatesModalProps) {
+  const { t } = useEditorI18n();
+  const [phase, setPhase] = useState<'idle' | 'checking' | 'done'>('idle');
+  const [res, setRes] = useState<UpdaterCheckResponse | null>(null);
+  const [downloadBusy, setDownloadBusy] = useState(false);
+
+  useEffect(() => {
+    if (!open) return;
+    startTransition(() => {
+      setPhase('checking');
+      setRes(null);
+    });
+    void getDndApi()
+      .invoke(ipcChannels.updater.check, {})
+      .then((r) => {
+        setRes(r);
+        setPhase('done');
+      })
+      .catch((e: unknown) => {
+        const message = e instanceof Error ? e.message : String(e);
+        setRes({ outcome: 'error', message });
+        setPhase('done');
+      });
+  }, [open]);
+
+  useEffect(() => {
+    if (!open) return;
+    const onKey = (e: KeyboardEvent) => {
+      if (e.key === 'Escape' && !downloadBusy) onClose();
+    };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [downloadBusy, onClose, open]);
+
+  if (!open) return null;
+
+  const body =
+    phase === 'checking' || res === null ? (
+      <div className={styles.muted}>{t('updates.checking')}</div>
+    ) : res.outcome === 'available' ? (
+      <div className={styles.muted}>{t('updates.available', { version: res.version })}</div>
+    ) : res.outcome === 'current' ? (
+      <div className={styles.muted}>{t('updates.current', { version: res.currentVersion })}</div>
+    ) : res.outcome === 'error' ? (
+      <div className={styles.muted}>{t('updates.error', { message: res.message })}</div>
+    ) : res.outcome === 'not_packaged' ? (
+      <div className={styles.muted}>{t('updates.notPackaged')}</div>
+    ) : (
+      <div className={styles.muted}>{t('updates.noLicense')}</div>
+    );
+
+  const showUpdateIdle = phase === 'done' && res !== null && res.outcome === 'available' && !downloadBusy;
+  const showUpdateBusy = phase === 'done' && res !== null && res.outcome === 'available' && downloadBusy;
+
+  return createPortal(
+    <>
+      <button
+        type="button"
+        aria-label={t('common.close')}
+        onClick={() => {
+          if (!downloadBusy) onClose();
+        }}
+        className={styles.modalBackdrop}
+      />
+      <div role="dialog" aria-modal="true" className={styles.modalDialog}>
+        <div className={styles.modalHeader}>
+          <div className={styles.modalTitle}>{t('updates.dialogTitle')}</div>
+          <button
+            type="button"
+            aria-label={t('common.close')}
+            disabled={downloadBusy}
+            onClick={onClose}
+            className={styles.modalClose}
+          >
+            ×
+          </button>
+        </div>
+        <div className={styles.fieldGrid}>{body}</div>
+        <div className={styles.modalFooter}>
+          {showUpdateIdle ? (
+            <>
+              <Button variant="ghost" disabled={downloadBusy} onClick={onClose}>
+                {t('common.close')}
+              </Button>
+              <Button
+                variant="primary"
+                disabled={downloadBusy}
+                onClick={() => {
+                  setDownloadBusy(true);
+                  void getDndApi()
+                    .invoke(ipcChannels.updater.downloadAndRestart, {})
+                    .then((r) => {
+                      if (!r.ok) {
+                        setDownloadBusy(false);
+                        setRes({ outcome: 'error', message: r.message });
+                      }
+                    })
+                    .catch((e: unknown) => {
+                      setDownloadBusy(false);
+                      setRes({
+                        outcome: 'error',
+                        message: e instanceof Error ? e.message : String(e),
+                      });
+                    });
+                }}
+              >
+                {t('updates.download')}
+              </Button>
+            </>
+          ) : showUpdateBusy ? (
+            <Button variant="primary" disabled>
+              {t('updates.downloading')}
+            </Button>
+          ) : (
+            <Button variant="primary" disabled={downloadBusy} onClick={onClose}>
+              {t('common.close')}
+            </Button>
+          )}
+        </div>
+      </div>
+    </>,
+    document.body,
+  );
+}
+
 type SimpleMessageModalProps = {
   open: boolean;
   title?: string;
@@ -1171,7 +1320,7 @@ function RenameProjectModal({
             <div className={styles.flex1}>
               <Input value={fileBaseName} onChange={setFileBaseName} placeholder="my_campaign" />
             </div>
-            <div className={styles.fileSuffix}>.dnd.zip</div>
+            <div className={styles.fileSuffix}>{PROJECT_ZIP_EXTENSION}</div>
           </div>
           {!fileNameOk ? <div className={styles.fieldError}>{t('rename.fileInvalid')}</div> : null}
           {fileNameDup ? <div className={styles.fieldError}>{t('rename.fileDup')}</div> : null}

app/renderer/editor/i18n/editorMessages.ts

@@ -60,6 +60,8 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'common.delete': 'Удалить',
     'common.closeMenu': 'Закрыть меню',
 
+    'app.brandTitle': 'НРИ Плеер',
+
     'notice.campaignAudioEmpty': 'Аудио не добавлено. Проверьте формат файла.',
 
     'license.checkingTitle': 'Проверка лицензии…',
@@ -69,7 +71,7 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
       'Укажите ключ в меню «Настройки» → «Указать ключ». До активации доступно только меню «Настройки».',
     'license.tokenTitle': 'Указать ключ',
     'license.tokenKey': 'КЛЮЧ',
-    'license.tokenPlaceholder': 'Продуктовый ключ DND-...',
+    'license.tokenPlaceholder': 'Продуктовый ключ TTRPG-... или DND-...',
     'license.tokenSaving': 'Сохранение…',
     'license.eulaTitle': 'Лицензионное соглашение',
     'license.eulaReject': 'Не принимаю',
@@ -114,10 +116,21 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
 
     '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': 'Экспорт',
@@ -145,7 +158,7 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'export.title': 'Экспорт проекта',
     'export.project': 'ПРОЕКТ',
     'export.hint':
-      'Далее откроется окно сохранения: укажите имя и папку для файла .dnd.zip — будет создана копия архива проекта.',
+      'Далее откроется окно сохранения: укажите имя и папку для файла .ttrpg.zip — будет создана копия архива проекта.',
     'export.exporting': 'Экспорт…',
     'export.saveAs': 'Сохранить как…',
 
@@ -277,6 +290,8 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'common.delete': 'Delete',
     'common.closeMenu': 'Close menu',
 
+    'app.brandTitle': 'TTRPG Player',
+
     'notice.campaignAudioEmpty': 'No audio was added. Check the file format.',
 
     'license.checkingTitle': 'Checking license…',
@@ -286,7 +301,7 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
       '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.tokenPlaceholder': 'TTRPG- or DND- product key…',
     'license.tokenSaving': 'Saving…',
     'license.eulaTitle': 'End User License Agreement',
     'license.eulaReject': 'Decline',
@@ -330,10 +345,21 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
 
     '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',
@@ -361,7 +387,7 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     '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.',
+      'A save dialog will open: choose a name and folder for the .ttrpg.zip file — a copy of the project archive will be created.',
     'export.exporting': 'Exporting…',
     'export.saveAs': 'Save as…',
 

app/renderer/legal/eulaRu.ts

@@ -2,7 +2,7 @@
 export const EULA_RU_MARKDOWN = `
 # Лицензионное соглашение с конечным пользователем (EULA)
 
-Используя DNDGamePlayer («Программу»), вы соглашаетесь с условиями ниже.
+Используя НРИ Плеер («Программу»), вы соглашаетесь с условиями ниже.
 
 ## 1. Предоставление прав
 Правообладатель предоставляет вам неисключическую, непередаваемую лицензию на использование Программы в пределах приобретённой лицензии (активации).

app/shared/appBranding.ts

@@ -0,0 +1,13 @@
+/** Отображаемое имя продукта (с пробелом), не путать с `productName` сборки (`TTRPGPlayer`). */
+export const APP_DISPLAY_NAME_EN = 'TTRPG Player';
+export const APP_DISPLAY_NAME_RU = 'НРИ Плеер';
+
+/** Системный идентификатор приложения (exe, AppImage, appId). */
+export const APP_PRODUCT_NAME = 'TTRPGPlayer';
+export const APP_BUNDLE_ID = 'com.ttrpgplayer.app';
+
+export function appDisplayNameForLocale(localeTag: string): string {
+  const tag = localeTag.trim().toLowerCase();
+  if (tag.startsWith('ru')) return APP_DISPLAY_NAME_RU;
+  return APP_DISPLAY_NAME_EN;
+}

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/license/productKey.test.ts

@@ -1,16 +1,20 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 
-import { isDndProductKey } from './productKey';
+import { isProductKey } from './productKey';
 
-void test('isDndProductKey: пример пользователя', () => {
+void test('isProductKey: legacy DND prefix', () => {
-  assert.equal(isDndProductKey('DND-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD'), true);
+  assert.equal(isProductKey('DND-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD'), true);
 });
 
-void test('isDndProductKey: токен с точкой — нет', () => {
+void test('isProductKey: TTRPG prefix', () => {
-  assert.equal(isDndProductKey('eyJ.xxx'), false);
+  assert.equal(isProductKey('TTRPG-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD'), true);
 });
 
-void test('isDndProductKey: пробелы по краям', () => {
+void test('isProductKey: token with dot — no', () => {
-  assert.equal(isDndProductKey('  DND-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD  '), true);
+  assert.equal(isProductKey('eyJ.xxx'), false);
+});
+
+void test('isProductKey: trimmed', () => {
+  assert.equal(isProductKey('  TTRPG-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD  '), true);
 });

app/shared/license/productKey.ts

@@ -1,6 +1,13 @@
 /** Продуктовый ключ активации (не путать с лицензионным токеном `base64.base64`). */
+const TTRPG_PRODUCT_KEY_RE = /^TTRPG-[0-9A-F]{8}-(?:[0-9A-F]{4}-){3}[0-9A-F]{12}$/iu;
 const DND_PRODUCT_KEY_RE = /^DND-[0-9A-F]{8}-(?:[0-9A-F]{4}-){3}[0-9A-F]{12}$/iu;
 
-export function isDndProductKey(s: string): boolean {
+export function isProductKey(s: string): boolean {
-  return DND_PRODUCT_KEY_RE.test(s.trim());
+  const t = s.trim();
+  return TTRPG_PRODUCT_KEY_RE.test(t) || DND_PRODUCT_KEY_RE.test(t);
+}
+
+/** @deprecated Используйте {@link isProductKey}. */
+export function isDndProductKey(s: string): boolean {
+  return isProductKey(s);
 }

app/shared/package.build.test.ts

@@ -6,21 +6,61 @@ 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[];
-      mac: { target: unknown };
+      extraResources: { from: string; to: string }[];
+      mac: { target: unknown; artifactName?: string };
+      linux: { target: unknown };
+      appImage?: { artifactName?: string };
+      nsis?: { artifactName?: string };
+      dmg?: { artifactName?: string };
       files: string[];
+      toolsets?: { appimage?: string };
     };
   };
   assert.ok(pkg.build);
-  assert.equal(pkg.build.appId, 'com.dndplayer.app');
+  assert.equal(pkg.build.appId, 'com.ttrpgplayer.app');
   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.equal(pkg.build.mac.artifactName, '${productName}-${arch}.${ext}');
+  assert.ok(!pkg.build.mac.artifactName?.includes('version'));
+  assert.equal(pkg.build.toolsets?.appimage, '1.0.2');
+  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.equal(pkg.build.appImage?.artifactName, '${productName}-${arch}.${ext}');
+  assert.equal(pkg.build.nsis?.artifactName, '${productName}-Setup.${ext}');
+  assert.equal(pkg.build.dmg?.artifactName, '${productName}-${arch}.${ext}');
+  assert.ok(!pkg.build.appImage?.artifactName?.includes('version'));
+  assert.ok(!pkg.build.nsis?.artifactName?.includes('version'));
   assert.ok(pkg.build.files.includes('dist/**/*'));
+  assert.ok(
+    pkg.build.asarUnpack.some((p) => p.includes('@img')),
+    'sharp native binaries live under node_modules/@img',
+  );
+});
+
+void test('package.json: pack:mac runs release-mac-prep before electron-builder', () => {
+  const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as {
+    scripts: { 'pack:mac': string };
+  };
+  assert.match(pkg.scripts['pack:mac'], /release-mac-prep\.mjs/);
 });

app/shared/project/projectZipExtension.ts

@@ -0,0 +1,52 @@
+/** Текущий формат архива проекта (новые сохранения). */
+export const PROJECT_ZIP_EXTENSION = '.ttrpg.zip';
+
+/** Устаревший формат — только открытие / импорт (вариант B). */
+export const PROJECT_ZIP_EXTENSION_LEGACY = '.dnd.zip';
+
+export function isProjectZipFileName(fileName: string): boolean {
+  const lower = fileName.toLowerCase();
+  return lower.endsWith(PROJECT_ZIP_EXTENSION) || lower.endsWith(PROJECT_ZIP_EXTENSION_LEGACY);
+}
+
+export function isLegacyProjectZipFileName(fileName: string): boolean {
+  return fileName.toLowerCase().endsWith(PROJECT_ZIP_EXTENSION_LEGACY);
+}
+
+export function projectZipFileNameFromBase(stem: string): string {
+  return `${stem}${PROJECT_ZIP_EXTENSION}`;
+}
+
+/** Имя файла для сохранения/экспорта — всегда `.ttrpg.zip`. */
+export function normalizeSaveProjectZipPath(filePath: string): string {
+  const lower = filePath.toLowerCase();
+  if (lower.endsWith(PROJECT_ZIP_EXTENSION)) return filePath;
+  if (lower.endsWith(PROJECT_ZIP_EXTENSION_LEGACY)) {
+    return filePath.slice(0, -PROJECT_ZIP_EXTENSION_LEGACY.length) + PROJECT_ZIP_EXTENSION;
+  }
+  if (lower.endsWith('.zip')) {
+    return filePath.replace(/\.zip$/iu, PROJECT_ZIP_EXTENSION);
+  }
+  return `${filePath}${PROJECT_ZIP_EXTENSION}`;
+}
+
+export function stripProjectZipExtension(fileName: string): string {
+  const lower = fileName.toLowerCase();
+  if (lower.endsWith(PROJECT_ZIP_EXTENSION)) {
+    return fileName.slice(0, -PROJECT_ZIP_EXTENSION.length);
+  }
+  if (lower.endsWith(PROJECT_ZIP_EXTENSION_LEGACY)) {
+    return fileName.slice(0, -PROJECT_ZIP_EXTENSION_LEGACY.length);
+  }
+  return fileName;
+}
+
+export const PROJECT_ZIP_OPEN_DIALOG_FILTER: Electron.FileFilter = {
+  name: 'Проект TTRPG (*.ttrpg.zip, *.dnd.zip)',
+  extensions: ['ttrpg.zip', 'dnd.zip'],
+};
+
+export const PROJECT_ZIP_SAVE_DIALOG_FILTER: Electron.FileFilter = {
+  name: 'Проект TTRPG (*.ttrpg.zip)',
+  extensions: ['ttrpg.zip'],
+};

app/shared/types/domain.ts

@@ -98,7 +98,7 @@ export type Scene = {
 
 export type ProjectMeta = {
   name: string;
-  /** Имя файла проекта без суффикса `.dnd.zip` (то, что пользователь редактирует). */
+  /** Имя файла проекта без суффикса `.ttrpg.zip` (то, что пользователь редактирует). */
   fileBaseName: string;
   createdAt: IsoDateTimeString;
   updatedAt: IsoDateTimeString;

docs/GITEA_AUTO_UPDATE.md

@@ -1,417 +1,53 @@
-# Автообновление через Gitea (приватный код + публичный feed)
+# Автообновления TTRPG Player
 
-Исходники остаются в **закрытом** репозитории с игрой. Файлы обновлений (`latest.yml`, установщики) лежат в **отдельном публичном** репозитории — по HTTPS их скачивает `electron-updater`.
+## Сборка и публикация
 
-## Твой публичный репозиторий (уже есть)
+- Релизы собираются **локально** (CI отключён).
+- Артефакты кладутся в `D:\TTRPG-Release\` (или копируются из `release\` после сборки).
+- Подготовка релиза: **`D:\TTRPG-Release\prepare-release.cmd`** (версия, git, сборка Win/Linux, копирование в папку).
+- Публикация на VPS: **`D:\TTRPG-Release\publish.cmd`** (проверка + `scp`). Копия в репо: `scripts/ttrpg-release/`
+- **Имена файлов без версии** — версия только в `latest*.yml`.
 
-- Клон: `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git`
+## Feed URL
-- Владелец/репо для секретов: **`ifontosh/DndGamePlayerUpdates`**
-- Базовый URL feed (вшивается в сборку и должен совпадать с secret **`DND_UPDATE_FEED_URL`**):
 
-  **`https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/`**
+В `package.json` → `build.publish.url`:
 
-  Обрати внимание: слово **`branch`** в пути — это часть URL Gitea, не имя ветки. Имя ветки — в конце: **`updates`**.
+`https://updates.mailib.ru/`
 
-В `package.json` уже указан этот же `build.publish.url` (для локального `npm run pack` и метаданных electron-builder).
+Обязателен **слэш в конце**. URL вшивается в установщик при `npm run pack:win`.
 
----
+## Фиксированные имена артефактов
 
-## Шаг 0 — репозиторий сейчас пустой (важно)
+| Платформа | Файлы |
+|-----------|--------|
+| Windows | `latest.yml`, `TTRPGPlayer-Setup.exe`, `TTRPGPlayer-Setup.exe.blockmap` |
+| Linux | `latest-linux.yml`, `TTRPGPlayer-x64.AppImage`, `TTRPGPlayer-arm64.AppImage` |
+| macOS | `latest-mac.yml`, `TTRPGPlayer-x64.dmg`, `TTRPGPlayer-arm64.dmg` |
 
-На странице репо написано, что **контента нет**. Пока нет **ни одного коммита**, CI не сможет сделать `git clone`.
+## Локальная сборка
-
-Сделай так (любой способ):
-
-1. На сайте открой `ifontosh/DndGamePlayerUpdates` → кнопка вроде **«Инициализировать репозиторий»** / **«Добавить файл»** → создай файл `README.md` с парой строк и закоммить **в ветку по умолчанию** (часто `main`).
-2. Либо с компьютера:
 
 ```bash
-git clone https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git
+npm ci
-cd DndGamePlayerUpdates
+npm run build
-echo "# DndGamePlayer updates feed" > README.md
+npm run release:info
-git add README.md
-git commit -m "init"
-git push origin main
 ```
 
-(Если ветка по умолчанию у тебя `master` — подставь её вместо `main`.)
+| Команда | Где | Результат |
+|---------|-----|-----------|
+| `npm run pack:win` | Windows | `release\` — Win + `latest.yml` |
+| `npm run pack:linux` | Linux / WSL | AppImage + `latest-linux*.yml` |
+| `npm run pack:mac` | macOS | dmg + `latest-mac.yml` |
 
-После этого репозиторий **не пустой** — workflow сможет клонировать и создать ветку **`updates`**.
+Linux из PowerShell напрямую не собирается — только WSL/Linux (`scripts/release-linux-pack.mjs`).
 
----
+После `pack:win` скопируйте из `release\` в `D:\TTRPG-Release\` файлы из таблицы выше.
 
-## Шаг 1 — токен для записи в публичный репозиторий
+## Сервер
 
-Нужен **персональный токен** (PAT), с которым CI сможет **пушить** в `DndGamePlayerUpdates`.
+- Домен: `https://updates.mailib.ru/`
+- nginx `root`: `/var/www/updates_mailib_ru`
+- Проверка: `curl https://updates.mailib.ru/latest.yml`
 
-В Gitea на русском обычно так (названия могут чуть отличаться в твоей теме):
+## Лицензия
 
-1. Вверху справа **аватар** → **Настройки** (или «Параметры»).
+Обновления доступны при активной лицензии. Ключи: `TTRPG-…` и устаревшие `DND-…`.
-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)** в CI идёт **на Linux**: нативный **`nsis`** (`makensis`) + **`wine64`** и обёртка **`wine`→`wine64`** (без **wine32**/i386 — см. `release.yml`). Отдельная **macOS**-сборка в workflow отключена, пока нет Mac-раннера (см. комментарии в `release.yml`).
-
----
-
-## Шаг 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`** (сборка Win + push feed в одном job, без GitHub `upload-artifact`); в публичном репо появляется ветка **`updates`** с `latest.yml` и установщиками (нужен online-раннер, см. раздел про act_runner).
-6. В приложении: обновления только **`app.isPackaged`** и при **активной лицензии** (см. `app/main/update/installAutoUpdater.ts`).
-
----
-
-## Поведение приложения
-
-- Проверка только в **собранной** установке (`app.isPackaged`).
-- Только если **лицензия активна**.
-- Первый запрос примерно через **12 с** после старта; при смене лицензии — снова (не чаще **30 с**).
-- Для отладки можно задать переменную окружения **`DND_UPDATE_FEED_URL`** при запуске `.exe` — переопределит feed.
-
-Подпись кода в CI отключена: `CSC_IDENTITY_AUTO_DISCOVERY=false`.
-
----
-
-## Локальная отладка 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,22 @@
+# macOS: сборка и выкладка обновлений
+
+## Сборка на Mac
+
+```bash
+npm ci
+npm run pack:mac
+```
+
+`pack:mac` сам вызывает `build` и `scripts/release-mac-prep.mjs` — подтягивает **оба** набора нативных бинарников sharp (x64 и arm64). Без этого x64-сборка с Apple Silicon падает при старте с ошибкой `Could not load the "sharp" module using the darwin-x64 runtime`.
+
+В `release/` (имена **без версии**):
+
+- `latest-mac.yml` — сгенерирован electron-builder, не копируйте старый с Windows
+- `TTRPGPlayer-x64.zip` и `TTRPGPlayer-arm64.zip` — **нужны для автообновления** (поле `path` в yml)
+- `TTRPGPlayer-x64.dmg`, `TTRPGPlayer-arm64.dmg` — опционально, для ручной установки
+
+Скопируйте эти файлы на Windows в общую папку релиза (вместе с Win/Linux) и залейте на VPS вместе с остальными.
+
+## Проверка после выкладки
+
+`https://updates.mailib.ru/latest-mac.yml` (подставьте свой feed URL)

docs/licensing-spec.md

@@ -1,4 +1,4 @@
-# Спецификация лицензирования DNDGamePlayer (этап D1)
+# Спецификация лицензирования TTRPG Player (этап D1)
 
 Документ фиксирует модель **D1**: онлайн-активация, срок, число устройств, отзыв, и как это согласуется с клиентом и сервером лицензий.
 
@@ -6,7 +6,7 @@
 
 ## Модель
 
-1. **Продуктовый ключ** — секрет покупателя, известен только ему и серверу. Обменивается на **лицензионный токен** через `POST /v1/activate` (онлайн-активация). В поле «Указать ключ» приложение принимает **продуктовый ключ** `DND-…` (клиент сам вызывает `POST /v1/activate` с `deviceId`) или уже готовый **токен** (две части base64url через одну точку).
+1. **Продуктовый ключ** — секрет покупателя, известен только ему и серверу. Обменивается на **лицензионный токен** через `POST /v1/activate` (онлайн-активация). В поле «Указать ключ» приложение принимает **продуктовый ключ** `TTRPG-…` или устаревший `DND-…` (клиент сам вызывает `POST /v1/activate` с `deviceId`) или уже готовый **токен** (две части base64url через одну точку). Новые ключи на сервере — только `TTRPG-…` (см. репозиторий лицензий).
 2. **Лицензионный токен** — публичная полезная нагрузка (`sub`, `pid`, `iat`, `exp`, `did`) + подпись **Ed25519**. Клиент хранит только токен и **публичный** ключ (вшит в приложение); подделать валидный токен без приватного ключа сервера невозможно.
 3. **Срок** — поле `exp` (unix секунды). Клиент отклоняет истёкший токен без сети.
 4. **Устройства** — поле `did` в токене: при активации сервер привязывает токен к `deviceId` клиента и ведёт учёт списка устройств на `sub` в `data.json` (`maxDevices`).
@@ -20,6 +20,18 @@
 
 Токен не хранится открытым текстом в JSON userData: используется **Electron `safeStorage`** (на macOS — связка с Keychain, на Windows — DPAPI). Идентификатор устройства — отдельный файл `device.id` (не секрет). Принятие EULA — `preferences.json` (версия текста).
 
+### Linux / WSL без keyring
+
+На Linux `safeStorage` обычно требует **Secret Service** (например `gnome-keyring` + D-Bus). В **WSL** без keyring `safeStorage.isEncryptionAvailable()` часто **false**, и сохранить токен нельзя.
+
+Явный обход (только если осознанно нужен запуск без OS-хранилища): переменная окружения **`DND_LICENSE_INSECURE_FILE_STORAGE=1`**. Тогда токен пишется в файл **`license.sealed.fallback`** (AES-256-GCM, ключ от `deviceId` + константа приложения). Это **слабее**, чем связка с ОС: при копировании `userData` + знании формата теоретически проще атаковать офлайн. Для обычного десктопа Linux с рабочим сеансом переменную не задавайте.
+
+Пример запуска AppImage:
+
+```bash
+DND_LICENSE_INSECURE_FILE_STORAGE=1 ./TTRPGPlayer-1.0.12-x64.AppImage --no-sandbox --appimage-extract-and-run
+```
+
 ## Юридическое (D9)
 
 Текст EULA в приложении (`app/renderer/legal/eulaRu.ts`) и формулировки про активацию/отзыв/устройства. Перед первым вводом ключа пользователь принимает EULA (версия `EULA_CURRENT_VERSION` в `app/shared/license/eulaVersion.ts`).

package.json

@@ -1,7 +1,7 @@
 {
-  "name": "DndGamePlayer",
+  "name": "TTRPGPlayer",
-  "version": "1.0.1",
+  "version": "1.0.18",
-  "description": "DNDGamePlayer — редактор и проигрыватель игр",
+  "description": "TTRPG Player — редактор и проигрыватель НРИ",
   "main": "dist/main/index.cjs",
   "scripts": {
     "dev": "node scripts/dev.mjs",
@@ -10,15 +10,20 @@
     "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/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",
+    "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 scripts/release-mac-prep.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:mac": "npm run build && node scripts/release-mac-prep.mjs && 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": "node scripts/release-linux-pack.mjs",
+    "release": "powershell -ExecutionPolicy Bypass -File scripts/ttrpg-release/release.ps1",
+    "release:all": "powershell -ExecutionPolicy Bypass -File scripts/ttrpg-release/release-all.ps1",
+    "prepare:release": "powershell -ExecutionPolicy Bypass -File scripts/ttrpg-release/prepare-release.ps1",
+    "publish:updates": "powershell -ExecutionPolicy Bypass -File scripts/ttrpg-release/publish.ps1"
   },
   "keywords": [],
   "author": "",
@@ -60,6 +65,7 @@
     "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",
@@ -68,13 +74,19 @@
     "yazl": "^3.3.1"
   },
   "build": {
-    "appId": "com.dndplayer.app",
+    "appId": "com.ttrpgplayer.app",
-    "productName": "DNDGamePlayer",
+    "productName": "TTRPGPlayer",
-    "copyright": "Copyright © DNDGamePlayer",
+    "copyright": "Copyright © TTRPGPlayer",
     "directories": {
       "output": "release",
       "buildResources": "build"
     },
+    "extraResources": [
+      {
+        "from": "build/icon.ico",
+        "to": "branding/icon.ico"
+      }
+    ],
     "files": [
       "dist/**/*",
       "package.json"
@@ -82,12 +94,18 @@
     "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/**"
     ],
+    "toolsets": {
+      "appimage": "1.0.2"
+    },
     "mac": {
       "category": "public.app-category.games",
+      "artifactName": "${productName}-${arch}.${ext}",
       "target": [
         {
           "target": "dmg",
@@ -121,17 +139,38 @@
           ]
         }
       ],
+      "icon": "build/icon.ico"
+    },
+    "linux": {
+      "target": [
+        {
+          "target": "AppImage",
+          "arch": [
+            "x64",
+            "arm64"
+          ]
+        }
+      ],
+      "category": "Game",
+      "maintainer": "TTRPGPlayer",
+      "synopsis": "TTRPG Player — tabletop RPG editor and player",
       "icon": "build/icon.png"
     },
+    "appImage": {
+      "artifactName": "${productName}-${arch}.${ext}"
+    },
+    "dmg": {
+      "artifactName": "${productName}-${arch}.${ext}"
+    },
     "nsis": {
       "oneClick": false,
       "allowToChangeInstallationDirectory": true,
       "deleteAppDataOnUninstall": false,
-      "artifactName": "${productName}-Setup-${version}.${ext}"
+      "artifactName": "${productName}-Setup.${ext}"
     },
     "publish": {
       "provider": "generic",
-      "url": "https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/"
+      "url": "https://updates.mailib.ru/"
     }
   }
 }

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/generate-release-docx.py

@@ -0,0 +1,188 @@
+# -*- coding: utf-8 -*-
+"""Generate TTRPG-Release-Instructions.docx (run: python scripts/generate-release-docx.py)."""
+from __future__ import annotations
+
+from pathlib import Path
+
+from docx import Document
+from docx.enum.text import WD_ALIGN_PARAGRAPH
+from docx.shared import Pt
+
+ROOT = Path(__file__).resolve().parents[1]
+OUT_PATHS = [
+    ROOT / "docs" / "TTRPG-Release-Instructions.docx",
+    Path(r"D:\TTRPG-Release\TTRPG-Release-Instructions.docx"),
+]
+
+
+def add_bullet(doc: Document, text: str, level: int = 0) -> None:
+    style = "List Bullet" if level == 0 else "List Bullet 2"
+    doc.add_paragraph(text, style=style)
+
+
+def add_step(doc: Document, title: str, body: str) -> None:
+    p = doc.add_paragraph()
+    p.add_run(f"{title}. ").bold = True
+    p.add_run(body)
+
+
+def build_document() -> Document:
+    doc = Document()
+    normal = doc.styles["Normal"]
+    normal.font.name = "Calibri"
+    normal.font.size = Pt(11)
+
+    title = doc.add_heading("TTRPG Player — сборка и публикация обновлений", level=0)
+    title.alignment = WD_ALIGN_PARAGRAPH.CENTER
+
+    doc.add_paragraph(
+        "Одна версия на все платформы. Сначала вручную поднимается версия и собирается macOS; "
+        "затем на Windows скрипт собирает Win/Linux без повторного bump и выкладывает на "
+        "https://updates.mailib.ru/"
+    )
+
+    doc.add_heading("Рекомендуемый порядок", level=1)
+
+    add_step(
+        doc,
+        "Шаг 1. Поднять версию",
+        "В каталоге проекта dnd_player: bump-version.cmd (D:\\TTRPG-Release) "
+        "или npm version patch --no-git-tag-version. "
+        "Закоммитить package.json при необходимости до сборки на Mac.",
+    )
+    add_step(
+        doc,
+        "Шаг 2. Собрать macOS (только на Mac)",
+        "npm ci && npm run build && npm run pack:mac",
+    )
+    add_step(
+        doc,
+        "Шаг 3. Скопировать Mac-артефакты в D:\\TTRPG-Release",
+        "latest-mac.yml (только свежий с Mac), TTRPGPlayer-x64.zip, TTRPGPlayer-arm64.zip; "
+        "опционально TTRPGPlayer-x64.dmg, TTRPGPlayer-arm64.dmg. "
+        "Версия в latest-mac.yml должна совпадать с package.json.",
+    )
+    add_step(
+        doc,
+        "Шаг 4. Сборка Win/Linux и публикация (Windows)",
+        "release-all.cmd — по умолчанию режим -AfterMac: без bump, проверка Mac-файлов, "
+        "сборка Windows и Linux (WSL), копирование в D:\\TTRPG-Release, upload на сервер.",
+    )
+
+    doc.add_heading("Скрипты (D:\\TTRPG-Release)", level=1)
+    table = doc.add_table(rows=7, cols=2)
+    table.style = "Table Grid"
+    table.rows[0].cells[0].text = "Команда"
+    table.rows[0].cells[1].text = "Назначение"
+    rows = [
+        ("bump-version.cmd", "Только patch в package.json (шаг 1)"),
+        ("release-all.cmd", "Шаг 4: Win/Linux + publish, без bump (-AfterMac)"),
+        ("prepare-release.cmd -AfterMac", "Только сборка Win/Linux и копирование"),
+        ("publish.cmd", "Только проверка и upload на VPS"),
+        ("publish.cmd -SkipMac", "Выложить Win/Linux, если Mac ещё не готов"),
+        ("release-all-bump.cmd", "Устаревший режим: bump в скрипте, Mac потом"),
+    ]
+    for i, (cmd, desc) in enumerate(rows, start=1):
+        table.rows[i].cells[0].text = cmd
+        table.rows[i].cells[1].text = desc
+
+    doc.add_heading("Флаги prepare-release", level=2)
+    for line in [
+        "-AfterMac — не менять версию; требовать Mac-файлы в папке релиза (по умолчанию в release-all)",
+        "-Bump — поднять patch и собрать (старый порядок)",
+        "-SkipGit, -SkipLinux, -NoBump, -Version X.Y.Z, -Minor",
+    ]:
+        add_bullet(doc, line)
+
+    doc.add_heading("Флаги publish", level=2)
+    add_bullet(doc, "-CheckOnly — проверить файлы, без upload")
+    add_bullet(doc, "-SkipMac — не проверять и не заливать macOS")
+
+    doc.add_heading("Артефакты (имена без версии)", level=1)
+    art = doc.add_table(rows=4, cols=2)
+    art.style = "Table Grid"
+    art.rows[0].cells[0].text = "Платформа"
+    art.rows[0].cells[1].text = "Файлы"
+    artifacts = [
+        (
+            "Windows",
+            "latest.yml, TTRPGPlayer-Setup.exe, TTRPGPlayer-Setup.exe.blockmap",
+        ),
+        (
+            "Linux",
+            "latest-linux.yml, latest-linux-arm64.yml, "
+            "TTRPGPlayer-x64.AppImage, TTRPGPlayer-arm64.AppImage",
+        ),
+        (
+            "macOS",
+            "latest-mac.yml, TTRPGPlayer-x64.zip, TTRPGPlayer-arm64.zip "
+            "(zip — автообновление; dmg — опционально, вручную)",
+        ),
+    ]
+    for i, (plat, files) in enumerate(artifacts, start=1):
+        art.rows[i].cells[0].text = plat
+        art.rows[i].cells[1].text = files
+
+    doc.add_heading("Требования", level=1)
+    for line in [
+        "Windows: Node.js 20.19+ (или 22.12+), git, OpenSSH, WSL2 с nvm (Node 22, .nvmrc в проекте)",
+        "Проект: D:\\Work\\my_projects\\dnd_project\\dnd_player",
+        "Папка релиза: D:\\TTRPG-Release",
+        "SSH: %USERPROFILE%\\.ssh\\ttrpg_updates_root → root@185.173.94.234",
+        "Mac: Node 20+, сборка только на macOS",
+    ]:
+        add_bullet(doc, line)
+
+    doc.add_heading("Проверка после выкладки", level=1)
+    for url in [
+        "https://updates.mailib.ru/latest.yml",
+        "https://updates.mailib.ru/latest-linux.yml",
+        "https://updates.mailib.ru/latest-mac.yml",
+    ]:
+        add_bullet(doc, url)
+
+    doc.add_heading("Частые проблемы", level=1)
+    problems = [
+        (
+            "Win/Linux на версию выше Mac",
+            "Не использовать release-all-bump.cmd. Сначала bump + Mac, потом release-all.cmd.",
+        ),
+        (
+            "macOS: missing TTRPGPlayer-1.0.xx-mac.zip",
+            "Устаревший latest-mac.yml — пересобрать на Mac или publish.cmd -SkipMac.",
+        ),
+        (
+            "git push Failed to authenticate",
+            "Скрипт повторит push с токеном Gitea; или настроить credentials для git.mailib.ru.",
+        ),
+        (
+            "WSL Linux build / Node 18",
+            "Нужен nvm и Node 22 (scripts/wsl-pack-linux.sh).",
+        ),
+        (
+            "AfterMac: version mismatch",
+            "Версии в package.json и latest-mac.yml должны совпадать до запуска release-all.",
+        ),
+    ]
+    for prob, fix in problems:
+        p = doc.add_paragraph()
+        p.add_run(f"{prob}. ").bold = True
+        p.add_run(fix)
+
+    p = doc.add_paragraph()
+    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    p.add_run("Конфиг: release-config.json, publish-config.json в D:\\TTRPG-Release").italic = True
+
+    return doc
+
+
+def main() -> None:
+    doc = build_document()
+    for path in OUT_PATHS:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        doc.save(str(path))
+        print(f"Wrote {path}")
+
+
+if __name__ == "__main__":
+    main()

scripts/release-linux-pack.mjs

@@ -0,0 +1,67 @@
+/**
+ * Build Linux release artifacts.
+ *
+ * AppImage packaging uses Linux tooling (mksquashfs). Running it from
+ * Windows PowerShell reaches linux-unpacked, then fails while creating
+ * the AppImage. Build from Linux/WSL instead.
+ */
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+
+function run(command, args) {
+  const result = spawnSync(command, args, {
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+/** electron-builder для AppImage x64 часто даёт `x86_64` в имени — выравниваем под feed. */
+function normalizeLinuxReleaseNames() {
+  const releaseDir = path.resolve('release');
+  if (!fs.existsSync(releaseDir)) return;
+
+  for (const name of fs.readdirSync(releaseDir)) {
+    if (!name.includes('x86_64')) continue;
+    const from = path.join(releaseDir, name);
+    const to = path.join(releaseDir, name.replaceAll('x86_64', 'x64'));
+    if (from !== to && !fs.existsSync(to)) {
+      fs.renameSync(from, to);
+      console.log(`[pack:linux] renamed ${name} -> ${path.basename(to)}`);
+    }
+  }
+
+  for (const ymlName of fs.readdirSync(releaseDir)) {
+    if (!ymlName.startsWith('latest-linux') || !ymlName.endsWith('.yml')) continue;
+    const ymlPath = path.join(releaseDir, ymlName);
+    const text = fs.readFileSync(ymlPath, 'utf8');
+    const next = text.replaceAll('x86_64', 'x64');
+    if (next !== text) {
+      fs.writeFileSync(ymlPath, next);
+      console.log(`[pack:linux] patched ${ymlName} (x86_64 -> x64)`);
+    }
+  }
+}
+
+if (process.platform === 'win32') {
+  console.error(
+    [
+      '[pack:linux] AppImage нельзя собрать напрямую из Windows PowerShell.',
+      'Запустите команду внутри Linux/WSL из папки проекта:',
+      '',
+      '  cd /mnt/d/Work/my_projects/dnd_project/dnd_player',
+      '  npm ci',
+      '  npm run pack:linux',
+    ].join('\n'),
+  );
+  process.exit(1);
+}
+
+run('npm', ['run', 'build']);
+run('electron-builder', ['--linux']);
+normalizeLinuxReleaseNames();

scripts/release-mac-prep.mjs

@@ -0,0 +1,74 @@
+/**
+ * Перед `electron-builder --mac`: npm ставит sharp только под CPU хоста.
+ * В release идут x64 и arm64 — в .app должны быть оба набора @img/sharp-darwin-*.
+ */
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const MAC_SHARP_IMG_PACKAGES = [
+  '@img/sharp-darwin-arm64',
+  '@img/sharp-libvips-darwin-arm64',
+  '@img/sharp-darwin-x64',
+  '@img/sharp-libvips-darwin-x64',
+];
+
+/**
+ * @param {string} root
+ * @returns {string[]} entries like `@img/sharp-darwin-x64@0.34.5` missing under node_modules
+ */
+export function macSharpImgPackagesToInstall(root) {
+  const sharpPkgPath = path.join(root, 'node_modules', 'sharp', 'package.json');
+  if (!fs.existsSync(sharpPkgPath)) {
+    throw new Error('[release-mac-prep] sharp is not installed — run npm ci first');
+  }
+
+  const sharpPkg = JSON.parse(fs.readFileSync(sharpPkgPath, 'utf8'));
+  const versions = sharpPkg.optionalDependencies ?? {};
+  const missing = [];
+
+  for (const name of MAC_SHARP_IMG_PACKAGES) {
+    const version = versions[name];
+    if (!version) {
+      throw new Error(`[release-mac-prep] sharp optionalDependency missing: ${name}`);
+    }
+    if (!fs.existsSync(path.join(root, 'node_modules', name))) {
+      missing.push(`${name}@${version}`);
+    }
+  }
+
+  return missing;
+}
+
+/**
+ * @param {string} root
+ * @param {{ runInstall?: boolean }} [opts]
+ */
+export function ensureMacSharpBinaries(root, opts = {}) {
+  const { runInstall = true } = opts;
+  const toInstall = macSharpImgPackagesToInstall(root);
+
+  if (toInstall.length === 0) {
+    console.log('[release-mac-prep] all macOS sharp binaries present');
+    return;
+  }
+
+  console.log('[release-mac-prep] installing', toInstall.join(', '));
+  if (!runInstall) return;
+
+  execFileSync('npm', ['install', '--no-save', '--force', ...toInstall], {
+    cwd: root,
+    stdio: 'inherit',
+  });
+}
+
+const isMain = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+if (isMain) {
+  const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+  if (process.platform !== 'darwin') {
+    console.warn('[release-mac-prep] skipped: not macOS (no dual-arch sharp prep needed here)');
+    process.exit(0);
+  }
+  ensureMacSharpBinaries(root);
+}

scripts/release-mac-prep.test.mjs

@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+import { macSharpImgPackagesToInstall } from './release-mac-prep.mjs';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+void test('macSharpImgPackagesToInstall: empty when all four @img darwin packages exist', () => {
+  const missing = macSharpImgPackagesToInstall(root);
+  assert.deepEqual(missing, []);
+});
+
+void test('macSharpImgPackagesToInstall: lists missing darwin-x64 on arm64-only tree', () => {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'mac-sharp-prep-'));
+  try {
+    const sharpOpt = {
+      '@img/sharp-darwin-arm64': '0.34.5',
+      '@img/sharp-libvips-darwin-arm64': '1.2.4',
+      '@img/sharp-darwin-x64': '0.34.5',
+      '@img/sharp-libvips-darwin-x64': '1.2.4',
+    };
+    fs.mkdirSync(path.join(tmp, 'node_modules', 'sharp'), { recursive: true });
+    fs.writeFileSync(
+      path.join(tmp, 'node_modules', 'sharp', 'package.json'),
+      JSON.stringify({ optionalDependencies: sharpOpt }),
+    );
+    for (const name of ['@img/sharp-darwin-arm64', '@img/sharp-libvips-darwin-arm64']) {
+      const dir = path.join(tmp, 'node_modules', name);
+      fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(path.join(dir, 'package.json'), '{}');
+    }
+
+    const missing = macSharpImgPackagesToInstall(tmp);
+    assert.deepEqual(missing, ['@img/sharp-darwin-x64@0.34.5', '@img/sharp-libvips-darwin-x64@1.2.4']);
+  } finally {
+    fs.rmSync(tmp, { recursive: true, force: true });
+  }
+});

scripts/release-win-prep.mjs

@@ -17,7 +17,7 @@ function sleep(ms) {
 function tryKillDndPlayer() {
   if (process.platform !== 'win32') return;
   try {
-    execFileSync('taskkill', ['/F', '/IM', 'DNDGamePlayer.exe', '/T'], {
+    execFileSync('taskkill', ['/F', '/IM', 'TTRPGPlayer.exe', '/T'], {
       stdio: 'ignore',
       windowsHide: true,
     });
@@ -37,7 +37,7 @@ async function tryRmWinUnpacked() {
     }
   }
   console.warn(
-    '[release-win-prep] Не удалось удалить release/win-unpacked. Закройте DNDGamePlayer и повторите pack.',
+    '[release-win-prep] Не удалось удалить release/win-unpacked. Закройте TTRPGPlayer и повторите pack.',
   );
 }
 

scripts/sync-update-feed.mjs

@@ -1,102 +0,0 @@
-/**
- * Складывает артефакты electron-builder (win + mac) в публичный репозиторий,
- * ветка `updates`, чтобы generic URL …/raw/branch/updates/ указывал на актуальные latest*.yml и установщики.
- *
- * Переменные окружения (имена без префикса GITEA_ — в Gitea секреты GITEA_* зарезервированы):
- *   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
- *   GIT_COMMIT_TAG  — опционально, для сообщения коммита
- */
-import { execFileSync } 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']);
-
-function mustEnv(name) {
-  const v = process.env[name]?.trim();
-  if (!v) throw new Error(`Missing env ${name}`);
-  return v;
-}
-
-function copyFlatReleaseFiles(fromDir, toDir) {
-  if (!fs.existsSync(fromDir)) {
-    console.warn(`[sync-update-feed] skip missing dir: ${fromDir}`);
-    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;
-    fs.copyFileSync(src, path.join(toDir, name));
-    n += 1;
-  }
-  return n;
-}
-
-function runGit(args, cwd) {
-  execFileSync('git', args, { cwd, stdio: 'inherit' });
-}
-
-function emptyWorkingTreeExceptGit(cwd) {
-  for (const ent of fs.readdirSync(cwd)) {
-    if (ent === '.git') continue;
-    fs.rmSync(path.join(cwd, ent), { recursive: true, force: true });
-  }
-}
-
-function main() {
-  const server = mustEnv('DND_UPDATES_SERVER').replace(/\/+$/u, '');
-  const updatesRepo = mustEnv('UPDATES_REPO');
-  const token = mustEnv('DND_UPDATES_PUSH_TOKEN');
-  const winDir = mustEnv('ARTIFACT_WIN');
-  const macDir = mustEnv('ARTIFACT_MAC');
-
-  const u = new URL(server);
-  const host = u.host;
-  const cloneUrl = `https://oauth2:${encodeURIComponent(token)}@${host}/${updatesRepo}.git`;
-
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'dnd-feed-'));
-  const work = path.join(tmp, 'repo');
-
-  try {
-    execFileSync('git', ['clone', '--depth', '1', '-b', 'updates', cloneUrl, work], { stdio: 'inherit' });
-  } catch {
-    execFileSync('git', ['clone', '--depth', '1', 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);
-
-  emptyWorkingTreeExceptGit(work);
-
-  const copied = copyFlatReleaseFiles(winDir, work) + copyFlatReleaseFiles(macDir, work);
-  if (copied === 0) {
-    throw new Error('[sync-update-feed] no release files copied (check ARTIFACT_WIN / ARTIFACT_MAC)');
-  }
-
-  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) {
-    runGit(['commit', '-m', `update feed ${tag}`], work);
-    runGit(['push', '-u', 'origin', 'updates'], 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) staged)`);
-}
-
-main();

scripts/ttrpg-release/README.txt

@@ -0,0 +1,45 @@
+TTRPG Release folder
+====================
+
+RECOMMENDED WORKFLOW (same version on all platforms)
+----------------------------------------------------
+
+1) bump-version.cmd
+   OR in project: npm version patch --no-git-tag-version
+
+2) On Mac: npm ci && npm run build && npm run pack:mac
+   Copy to D:\TTRPG-Release:
+     latest-mac.yml, TTRPGPlayer-x64.zip, TTRPGPlayer-arm64.zip (+ dmg optional)
+
+3) release-all.cmd
+   - does NOT bump version (default -AfterMac)
+   - checks Mac files match package.json version
+   - builds Windows + Linux, copies artifacts, publishes to updates.mailib.ru
+
+LEGACY (Win/Linux ahead of Mac)
+-------------------------------
+release-all-bump.cmd  - bumps patch in script, build Win/Linux, publish with -SkipMac or add Mac later
+
+SCRIPTS
+-------
+release-all.cmd       prepare + publish (-AfterMac by default)
+prepare-release.cmd   build Win/Linux only
+publish.cmd           upload only (-SkipMac if no Mac)
+bump-version.cmd      patch version in package.json only
+
+prepare-release flags:
+  -AfterMac   no bump, require Mac files in this folder (default via release-all)
+  -Bump       bump patch then build
+  -SkipGit -SkipLinux -NoBump -Version X.Y.Z -Minor
+
+publish flags:
+  -SkipMac -CheckOnly
+
+CONFIG
+------
+release-config.json  - project path, release path, git, WSL
+publish-config.json  - SSH upload settings
+
+Requires: Node.js 20+, git, OpenSSH, WSL+nvm for Linux.
+
+Doc: TTRPG-Release-Instructions.docx

scripts/ttrpg-release/bump-version.cmd

@@ -0,0 +1,11 @@
+@echo off
+REM Bump patch in package.json only (no git tag). Run BEFORE Mac build.
+cd /d "D:\Work\my_projects\dnd_project\dnd_player"
+call npm version patch --no-git-tag-version
+if errorlevel 1 pause & exit /b 1
+echo.
+echo Version bumped. Next:
+echo   1) npm run pack:mac on Mac
+echo   2) Copy latest-mac.yml + TTRPGPlayer-*.zip to D:\TTRPG-Release
+echo   3) release-all.cmd
+pause

scripts/ttrpg-release/prepare-release.cmd

@@ -0,0 +1,4 @@
+@echo off
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0prepare-release.ps1" %*
+if errorlevel 1 pause

scripts/ttrpg-release/prepare-release.ps1

@@ -0,0 +1,393 @@
+# Prepare TTRPG release: build Win/Linux, copy to release folder.
+# Run: prepare-release.cmd
+#
+# Recommended (Mac first, same version on all platforms):
+#   1) Bump version in package.json manually (npm version patch --no-git-tag-version)
+#   2) pack:mac on Mac, copy latest-mac.yml + *.zip to release folder
+#   3) prepare-release.cmd -AfterMac   (or release-all.cmd)
+#
+# Options:
+#   -AfterMac           do not bump; require Mac files in release folder (default in release-all)
+#   -Bump               bump patch before build (Mac can be added later)
+#   -Version 1.0.17     set explicit version (with -Bump workflow)
+#   -Minor              bump minor (with -Bump)
+#   -SkipGit            skip commit/push
+#   -SkipLinux          skip Linux build (WSL)
+#   -NoBump             do not change package.json (same as -AfterMac without Mac check)
+
+param(
+  [string]$Version = '',
+  [switch]$Patch,
+  [switch]$Minor,
+  [switch]$Bump,
+  [switch]$AfterMac,
+  [switch]$SkipGit,
+  [switch]$SkipLinux,
+  [switch]$NoBump
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$ToolDir = $PSScriptRoot
+$ConfigPath = Join-Path $ToolDir 'release-config.json'
+
+function Write-Step([int]$n, [string]$text) {
+  Write-Host ''
+  Write-Host "----- Step $n : $text -----" -ForegroundColor Cyan
+}
+
+function Write-Ok([string]$text) {
+  Write-Host "  [OK] $text" -ForegroundColor Green
+}
+
+function Write-Fail([string]$text) {
+  Write-Host "  [!!] $text" -ForegroundColor Red
+}
+
+function Invoke-Npm {
+  param(
+    [string]$Label,
+    [string[]]$NpmArgs,
+    [string]$WorkingDirectory
+  )
+  Write-Host "  > $Label"
+  Push-Location $WorkingDirectory
+  try {
+    & npm @NpmArgs
+    if ($LASTEXITCODE -ne 0) {
+      throw "$Label failed (exit $LASTEXITCODE)"
+    }
+  } finally {
+    Pop-Location
+  }
+}
+
+function Convert-ToWslPath([string]$winPath) {
+  $full = [System.IO.Path]::GetFullPath($winPath)
+  $p = $full -replace '\\', '/'
+  if ($p -match '^([A-Za-z]):(.*)$') {
+    $drive = $Matches[1].ToLower()
+    return "/mnt/$drive$($Matches[2])"
+  }
+  return $p
+}
+
+function Get-WslLinuxBuildCommand([string]$WslProjectPath) {
+  # WSL Debian often has node 18 on PATH; scripts/wsl-pack-linux.sh uses nvm + .nvmrc.
+  return "cd '$WslProjectPath' && bash scripts/wsl-pack-linux.sh"
+}
+
+function Read-PackageVersion([string]$packageJsonPath) {
+  $json = Get-Content -LiteralPath $packageJsonPath -Raw -Encoding UTF8 | ConvertFrom-Json
+  return [string]$json.version
+}
+
+function Invoke-NpmVersion {
+  param(
+    [string]$ProjectRoot,
+    [string]$Spec
+  )
+  Invoke-Npm "npm version $Spec" @('version', $Spec, '--no-git-tag-version', '--allow-same-version') $ProjectRoot
+}
+
+function Get-GiteaPushUrl([string]$mcpConfigPath) {
+  if (-not (Test-Path -LiteralPath $mcpConfigPath)) {
+    return $null
+  }
+  $raw = Get-Content -LiteralPath $mcpConfigPath -Raw -Encoding UTF8 | ConvertFrom-Json
+  $token = $raw.mcpServers.'gitea-mailib'.env.GITEA_ACCESS_TOKEN
+  if (-not $token) {
+    return $null
+  }
+  return "https://ifontosh:${token}@git.mailib.ru/ifontosh/DndGamePlayer.git"
+}
+
+function Invoke-Git {
+  param(
+    [string]$ProjectRoot,
+    [string[]]$GitArgs
+  )
+  & git -C $ProjectRoot @GitArgs
+  if ($LASTEXITCODE -ne 0) {
+    throw "git $($GitArgs -join ' ') failed (exit $LASTEXITCODE)"
+  }
+}
+
+function Write-GitLines($lines) {
+  foreach ($line in $lines) {
+    if ($line -is [System.Management.Automation.ErrorRecord]) {
+      Write-Host $line.ToString()
+    } else {
+      Write-Host ([string]$line)
+    }
+  }
+}
+
+function Invoke-GitPush {
+  param(
+    [string]$ProjectRoot,
+    [string[]]$PushArgs
+  )
+  $prevEap = $ErrorActionPreference
+  $ErrorActionPreference = 'Continue'
+  try {
+    $output = & git -C $ProjectRoot push @PushArgs 2>&1
+    Write-GitLines $output
+    return $LASTEXITCODE
+  } finally {
+    $ErrorActionPreference = $prevEap
+  }
+}
+
+function Push-Git([string]$ProjectRoot, [string]$Remote, [string]$McpConfigPath) {
+  $branch = (git -C $ProjectRoot rev-parse --abbrev-ref HEAD).Trim()
+  Write-Host "  > git push $Remote $branch"
+  $exitCode = Invoke-GitPush $ProjectRoot @($Remote, $branch)
+  if ($exitCode -eq 0) {
+    return
+  }
+  $pushUrl = Get-GiteaPushUrl $McpConfigPath
+  if (-not $pushUrl) {
+    throw "git push failed (exit $exitCode) and no Gitea token in mcp config ($McpConfigPath)"
+  }
+  Write-Host "  > git push via Gitea token URL"
+  $exitCode = Invoke-GitPush $ProjectRoot @($pushUrl, "HEAD:${branch}")
+  if ($exitCode -ne 0) {
+    throw "git push failed (exit $exitCode)"
+  }
+}
+
+function Get-YmlField([string]$ymlPath, [string]$fieldName) {
+  $content = Get-Content -LiteralPath $ymlPath -Raw -Encoding UTF8
+  $m = [regex]::Match($content, "(?m)^${fieldName}:\s*(\S+)\s*$")
+  if ($m.Success) {
+    return $m.Groups[1].Value.Trim()
+  }
+  return $null
+}
+
+function Test-MacReleaseReady {
+  param(
+    [string]$ReleaseDir,
+    [string]$ExpectedVersion
+  )
+  $macYml = Join-Path $ReleaseDir 'latest-mac.yml'
+  if (-not (Test-Path -LiteralPath $macYml)) {
+    throw @"
+AfterMac: missing latest-mac.yml in $ReleaseDir
+  1) Bump version in package.json (now $ExpectedVersion)
+  2) npm run pack:mac on Mac
+  3) Copy latest-mac.yml + TTRPGPlayer-*.zip into release folder
+  4) Run prepare-release.cmd -AfterMac again
+"@
+  }
+  $macVersion = Get-YmlField $macYml 'version'
+  if ($macVersion -and $macVersion -ne $ExpectedVersion) {
+    throw "AfterMac: latest-mac.yml is v$macVersion but package.json is v$ExpectedVersion. Align versions before building Win/Linux."
+  }
+  $primary = Get-YmlField $macYml 'path'
+  if (-not $primary) {
+    throw 'AfterMac: latest-mac.yml has no path: entry'
+  }
+  $primaryPath = Join-Path $ReleaseDir $primary
+  if (-not (Test-Path -LiteralPath $primaryPath)) {
+    throw "AfterMac: missing Mac update file $primary (path in latest-mac.yml). Copy zip from Mac build."
+  }
+  Write-Ok "Mac feed v$ExpectedVersion, primary: $primary"
+}
+
+function Copy-ReleaseArtifacts {
+  param(
+    [string]$BuildReleaseDir,
+    [string]$TargetDir
+  )
+
+  if (-not (Test-Path -LiteralPath $TargetDir)) {
+    New-Item -ItemType Directory -Path $TargetDir | Out-Null
+  }
+
+  $names = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
+
+  $fixed = @(
+    'latest.yml',
+    'TTRPGPlayer-Setup.exe',
+    'TTRPGPlayer-Setup.exe.blockmap'
+  )
+  foreach ($n in $fixed) {
+    [void]$names.Add($n)
+  }
+
+  foreach ($yml in Get-ChildItem -LiteralPath $BuildReleaseDir -Filter 'latest-linux*.yml' -File -ErrorAction SilentlyContinue) {
+    [void]$names.Add($yml.Name)
+    $content = Get-Content -LiteralPath $yml.FullName -Raw -Encoding UTF8
+    foreach ($m in [regex]::Matches($content, '(?m)^(?:\s*-\s*)?(?:url|path):\s*(\S+)\s*$')) {
+      [void]$names.Add($m.Groups[1].Value.Trim())
+    }
+  }
+
+  foreach ($img in Get-ChildItem -LiteralPath $BuildReleaseDir -Filter 'TTRPGPlayer-*.AppImage' -File -ErrorAction SilentlyContinue) {
+    [void]$names.Add($img.Name)
+  }
+
+  $copied = 0
+  foreach ($name in ($names | Sort-Object)) {
+    $src = Join-Path $BuildReleaseDir $name
+    if (-not (Test-Path -LiteralPath $src)) {
+      if ($name -match 'x64' -and $name -notmatch 'x86_64') {
+        $alt = $name -replace 'x64', 'x86_64'
+        $src = Join-Path $BuildReleaseDir $alt
+      }
+    }
+    if (-not (Test-Path -LiteralPath $src)) {
+      Write-Host "  [--] skip (not built): $name" -ForegroundColor Yellow
+      continue
+    }
+    $dest = Join-Path $TargetDir ([System.IO.Path]::GetFileName($src))
+    Copy-Item -LiteralPath $src -Destination $dest -Force
+    Write-Ok "copied $([System.IO.Path]::GetFileName($src))"
+    $copied += 1
+  }
+
+  if ($copied -eq 0) {
+    throw 'No release artifacts copied - check build output in project release folder'
+  }
+}
+
+if (-not (Test-Path -LiteralPath $ConfigPath)) {
+  throw "Missing release-config.json: $ConfigPath"
+}
+
+$config = Get-Content -LiteralPath $ConfigPath -Raw -Encoding UTF8 | ConvertFrom-Json
+$projectRoot = [System.IO.Path]::GetFullPath([string]$config.projectRoot)
+$releaseDir = [System.IO.Path]::GetFullPath([string]$config.releaseDir)
+$gitRemote = [string]$config.gitRemote
+$mcpConfig = [string]$config.giteaMcpConfig
+$wslDistro = [string]$config.wslDistro
+
+$packageJson = Join-Path $projectRoot 'package.json'
+$buildReleaseDir = Join-Path $projectRoot 'release'
+
+if (-not (Test-Path -LiteralPath $packageJson)) {
+  throw "package.json not found: $packageJson"
+}
+
+Write-Host '=== TTRPG Prepare Release ===' -ForegroundColor Cyan
+Write-Host "Project: $projectRoot"
+Write-Host "Release folder: $releaseDir"
+
+if ($AfterMac) {
+  $NoBump = $true
+}
+if ($Bump -and $AfterMac) {
+  throw 'Use either -Bump or -AfterMac, not both'
+}
+if ($Bump) {
+  $Patch = $true
+}
+
+$currentVersion = Read-PackageVersion $packageJson
+
+if ($AfterMac) {
+  Write-Step 0 'Mac artifacts check'
+  Test-MacReleaseReady $releaseDir $currentVersion
+}
+
+# Step 1 - version
+if ($AfterMac) {
+  Write-Step 1 'Version (unchanged, Mac-first workflow)'
+  $newVersion = $currentVersion
+  Write-Ok "building Win/Linux at v$newVersion (same as Mac feed)"
+} else {
+  Write-Step 1 'Bump version'
+  $newVersion = $currentVersion
+}
+
+if ($AfterMac) {
+  # version step done above
+} elseif ($NoBump) {
+  Write-Ok "version unchanged: $currentVersion"
+  $newVersion = $currentVersion
+} elseif ($Version) {
+  Invoke-NpmVersion $projectRoot $Version.Trim()
+  $newVersion = Read-PackageVersion $packageJson
+  Write-Ok "version set to $newVersion (was $currentVersion)"
+} elseif ($Minor) {
+  Invoke-NpmVersion $projectRoot 'minor'
+  $newVersion = Read-PackageVersion $packageJson
+  Write-Ok "version $currentVersion -> $newVersion (minor)"
+} else {
+  Invoke-NpmVersion $projectRoot 'patch'
+  $newVersion = Read-PackageVersion $packageJson
+  Write-Ok "version $currentVersion -> $newVersion (patch)"
+}
+
+# Step 2 - git
+if ($SkipGit) {
+  Write-Step 2 'Git commit and push (skipped)'
+} else {
+  Write-Step 2 'Git commit and push'
+  Invoke-Git $projectRoot @('add', 'package.json')
+  if (Test-Path -LiteralPath (Join-Path $projectRoot 'package-lock.json')) {
+    Invoke-Git $projectRoot @('add', 'package-lock.json')
+  }
+  $commitMsg = "chore: release v$newVersion"
+  $status = (git -C $projectRoot status --porcelain).Trim()
+  if ($status) {
+    Invoke-Git $projectRoot @('commit', '-m', $commitMsg)
+    Write-Ok "committed: $commitMsg"
+  } else {
+    Write-Ok 'nothing to commit (version may already be committed)'
+  }
+  Push-Git $projectRoot $gitRemote $mcpConfig
+  Write-Ok 'pushed to remote'
+}
+
+# Step 3 - Windows build
+Write-Step 3 'Build Windows (npm ci + pack:win)'
+Invoke-Npm 'npm ci' @('ci') $projectRoot
+Invoke-Npm 'npm run pack:win' @('run', 'pack:win') $projectRoot
+Write-Ok 'Windows build finished'
+
+# Step 4 - Linux build
+if ($SkipLinux) {
+  Write-Step 4 'Build Linux (skipped)'
+} else {
+  Write-Step 4 'Build Linux via WSL (npm ci + pack:linux)'
+  $wslProject = Convert-ToWslPath $projectRoot
+  $wslCmd = Get-WslLinuxBuildCommand $wslProject
+  $wslArgs = @()
+  if ($wslDistro) {
+    $wslArgs += '-d', $wslDistro
+  }
+  $wslArgs += '-e', 'bash', '-lc', $wslCmd
+  Write-Host "  > wsl $($wslArgs -join ' ')"
+  & wsl @wslArgs
+  if ($LASTEXITCODE -ne 0) {
+    throw "WSL Linux build failed (exit $LASTEXITCODE). Install WSL or use -SkipLinux"
+  }
+  Write-Ok 'Linux build finished'
+}
+
+# Step 5 - copy
+Write-Step 5 'Copy artifacts to release folder'
+if (-not (Test-Path -LiteralPath $buildReleaseDir)) {
+  throw "Build output missing: $buildReleaseDir"
+}
+Copy-ReleaseArtifacts $buildReleaseDir $releaseDir
+Write-Ok "release folder updated: $releaseDir"
+
+Write-Host ''
+Write-Host '=== Prepare release done ===' -ForegroundColor Green
+Write-Host "Version: $newVersion"
+Write-Host ''
+Write-Host 'Next steps:' -ForegroundColor Yellow
+if ($AfterMac) {
+  Write-Host '  Run publish.cmd (release-all continues to publish automatically)'
+} else {
+  Write-Host '  1) Copy Mac files (latest-mac.yml, TTRPGPlayer-*.zip) from Mac into release folder'
+  Write-Host '  2) Run release-all.cmd (default -AfterMac) or publish.cmd'
+}
+Write-Host ''
+
+exit 0

scripts/ttrpg-release/publish-config.json

@@ -0,0 +1,6 @@
+{
+  "sshKey": "%USERPROFILE%\\.ssh\\ttrpg_updates_root",
+  "sshTarget": "root@185.173.94.234",
+  "remoteDir": "/var/www/updates_mailib_ru",
+  "feedUrl": "https://updates.mailib.ru/"
+}

scripts/ttrpg-release/publish.cmd

@@ -0,0 +1,4 @@
+@echo off
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0publish.ps1" %*
+if errorlevel 1 pause

scripts/ttrpg-release/publish.ps1

@@ -0,0 +1,289 @@
+# Copy of D:\TTRPG-Release\publish.ps1 - keep in sync when updating the release folder tool.
+
+param(
+  [switch]$CheckOnly,
+  [switch]$SkipMac
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$ReleaseDir = $PSScriptRoot
+$ConfigPath = Join-Path $ReleaseDir 'publish-config.json'
+
+function Expand-ConfigPath([string]$value) {
+  if ($value -match '%([^%]+)%') {
+    $envName = $Matches[1]
+    $envVal = [Environment]::GetEnvironmentVariable($envName)
+    if ($null -ne $envVal) {
+      return $value.Replace("%$envName%", $envVal)
+    }
+  }
+  return $value
+}
+
+function Write-Title([string]$text) {
+  Write-Host ''
+  Write-Host "=== $text ===" -ForegroundColor Cyan
+}
+
+function Write-Ok([string]$text) {
+  Write-Host "  [OK] $text" -ForegroundColor Green
+}
+
+function Write-Fail([string]$text) {
+  Write-Host "  [!!] $text" -ForegroundColor Red
+}
+
+function Write-Warn([string]$text) {
+  Write-Host "  [--] $text" -ForegroundColor Yellow
+}
+
+function Get-YmlVersion([string]$ymlPath) {
+  $content = Get-Content -LiteralPath $ymlPath -Raw -Encoding UTF8
+  $m = [regex]::Match($content, '(?m)^version:\s*(\S+)\s*$')
+  if ($m.Success) {
+    return $m.Groups[1].Value.Trim()
+  }
+  return $null
+}
+
+function Get-YmlPrimaryPath([string]$ymlPath) {
+  $content = Get-Content -LiteralPath $ymlPath -Raw -Encoding UTF8
+  $m = [regex]::Match($content, '(?m)^path:\s*(\S+)\s*$')
+  if ($m.Success) {
+    return $m.Groups[1].Value.Trim()
+  }
+  return $null
+}
+
+function Get-YmlReferencedFiles([string]$ymlPath) {
+  $names = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
+  $content = Get-Content -LiteralPath $ymlPath -Raw -Encoding UTF8
+  foreach ($m in [regex]::Matches($content, '(?m)^(?:\s*-\s*)?(?:url|path):\s*(\S+)\s*$')) {
+    [void]$names.Add($m.Groups[1].Value.Trim())
+  }
+  return @($names)
+}
+
+function Get-YmlOptionalUrls([string]$ymlPath) {
+  $primary = Get-YmlPrimaryPath $ymlPath
+  $names = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
+  $content = Get-Content -LiteralPath $ymlPath -Raw -Encoding UTF8
+  foreach ($m in [regex]::Matches($content, '(?m)^\s*-\s*url:\s*(\S+)\s*$')) {
+    $name = $m.Groups[1].Value.Trim()
+    if ($primary -and $name.Equals($primary, [StringComparison]::OrdinalIgnoreCase)) {
+      continue
+    }
+    [void]$names.Add($name)
+  }
+  return @($names)
+}
+
+function Resolve-ReleaseFile([string]$name) {
+  $direct = Join-Path $ReleaseDir $name
+  if (Test-Path -LiteralPath $direct) {
+    return Get-Item -LiteralPath $direct
+  }
+  if ($name -match 'x64' -and $name -notmatch 'x86_64') {
+    $alt = $name -replace 'x64', 'x86_64'
+    $altPath = Join-Path $ReleaseDir $alt
+    if (Test-Path -LiteralPath $altPath) {
+      return Get-Item -LiteralPath $altPath
+    }
+  }
+  if ($name -match 'x86_64') {
+    $alt = $name -replace 'x86_64', 'x64'
+    $altPath = Join-Path $ReleaseDir $alt
+    if (Test-Path -LiteralPath $altPath) {
+      return Get-Item -LiteralPath $altPath
+    }
+  }
+  return $null
+}
+
+function Add-FileToUploadSet {
+  param(
+    [System.Collections.Generic.HashSet[string]]$set,
+    [System.IO.FileInfo]$file
+  )
+  [void]$set.Add($file.FullName)
+}
+
+Write-Title 'TTRPG Release Publisher'
+Write-Host "Release folder: $ReleaseDir"
+
+if (-not (Test-Path -LiteralPath $ConfigPath)) {
+  throw "Missing publish-config.json: $ConfigPath"
+}
+
+$config = Get-Content -LiteralPath $ConfigPath -Raw -Encoding UTF8 | ConvertFrom-Json
+$sshKey = Expand-ConfigPath $config.sshKey
+$sshTarget = [string]$config.sshTarget
+$remoteDir = [string]$config.remoteDir
+$feedUrl = [string]$config.feedUrl
+
+if (-not (Test-Path -LiteralPath $sshKey)) {
+  throw "SSH key not found: $sshKey"
+}
+
+$errors = [System.Collections.Generic.List[string]]::new()
+$warnings = [System.Collections.Generic.List[string]]::new()
+$uploadFiles = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
+
+Write-Title 'Windows (required)'
+$winYml = Join-Path $ReleaseDir 'latest.yml'
+if (-not (Test-Path -LiteralPath $winYml)) {
+  $errors.Add('Missing latest.yml')
+} else {
+  Write-Ok 'latest.yml'
+  [void]$uploadFiles.Add($winYml)
+  foreach ($name in (Get-YmlReferencedFiles $winYml)) {
+    $file = Resolve-ReleaseFile $name
+    if ($null -eq $file) {
+      $errors.Add("Windows: missing file $name (from latest.yml)")
+    } else {
+      Write-Ok $file.Name
+      Add-FileToUploadSet $uploadFiles $file
+    }
+  }
+  $blockmap = Resolve-ReleaseFile 'TTRPGPlayer-Setup.exe.blockmap'
+  if ($null -eq $blockmap) {
+    $warnings.Add('Missing TTRPGPlayer-Setup.exe.blockmap (recommended)')
+  } else {
+    Write-Ok $blockmap.Name
+    Add-FileToUploadSet $uploadFiles $blockmap
+  }
+}
+
+Write-Title 'Linux (if latest-linux*.yml present)'
+$linuxYmls = Get-ChildItem -LiteralPath $ReleaseDir -Filter 'latest-linux*.yml' -File -ErrorAction SilentlyContinue
+if ($linuxYmls.Count -eq 0) {
+  Write-Warn 'No latest-linux*.yml - skipping Linux'
+} else {
+  foreach ($yml in $linuxYmls) {
+    Write-Ok $yml.Name
+    [void]$uploadFiles.Add($yml.FullName)
+    foreach ($name in (Get-YmlReferencedFiles $yml.FullName)) {
+      $file = Resolve-ReleaseFile $name
+      if ($null -eq $file) {
+        $errors.Add("Linux ($($yml.Name)): missing file $name")
+      } else {
+        if ($file.Name -ne $name) {
+          Write-Warn "$($yml.Name): yml expects $name, disk has $($file.Name) - will upload $($file.Name)"
+        } else {
+          Write-Ok "$($yml.Name) -> $name"
+        }
+        Add-FileToUploadSet $uploadFiles $file
+      }
+    }
+  }
+}
+
+Write-Title 'macOS (if latest-mac.yml present)'
+$macYml = Join-Path $ReleaseDir 'latest-mac.yml'
+if ($SkipMac) {
+  Write-Warn 'macOS skipped (-SkipMac)'
+} elseif (-not (Test-Path -LiteralPath $macYml)) {
+  Write-Warn 'No latest-mac.yml - skipping macOS'
+} else {
+  Write-Ok 'latest-mac.yml'
+  [void]$uploadFiles.Add($macYml)
+
+  $macVersion = Get-YmlVersion $macYml
+  $winYml = Join-Path $ReleaseDir 'latest.yml'
+  $winVersion = $null
+  if (Test-Path -LiteralPath $winYml) {
+    $winVersion = Get-YmlVersion $winYml
+  }
+  if ($macVersion -and $winVersion -and $macVersion -ne $winVersion) {
+    $errors.Add(
+      "macOS: latest-mac.yml is v$macVersion but latest.yml is v$winVersion (stale Mac feed). " +
+      'On Mac run: npm run pack:mac, then copy latest-mac.yml + TTRPGPlayer-*.zip (+ optional *.dmg). ' +
+      'Or publish Win/Linux only: publish.cmd -SkipMac'
+    )
+  }
+
+  $primaryName = Get-YmlPrimaryPath $macYml
+  if (-not $primaryName) {
+    $errors.Add('macOS: latest-mac.yml has no path: entry')
+  } else {
+    $primaryFile = Resolve-ReleaseFile $primaryName
+    if ($null -eq $primaryFile) {
+      $errors.Add(
+        "macOS: missing primary update file $primaryName (path in latest-mac.yml). " +
+        'electron-updater on macOS needs the .zip from pack:mac, not only .dmg. Rebuild on Mac or use -SkipMac.'
+      )
+    } else {
+      Write-Ok "primary update: $($primaryFile.Name)"
+      Add-FileToUploadSet $uploadFiles $primaryFile
+    }
+  }
+
+  foreach ($name in (Get-YmlOptionalUrls $macYml)) {
+    $file = Resolve-ReleaseFile $name
+    if ($null -eq $file) {
+      $warnings.Add("macOS: optional file missing (not uploaded): $name")
+    } else {
+      Write-Ok "optional: $($file.Name)"
+      Add-FileToUploadSet $uploadFiles $file
+    }
+  }
+}
+
+Write-Title 'Summary'
+foreach ($w in $warnings) {
+  Write-Warn $w
+}
+if ($errors.Count -gt 0) {
+  foreach ($e in $errors) {
+    Write-Fail $e
+  }
+  Write-Host ''
+  Write-Host 'Upload cancelled. Fix the release folder and run again.' -ForegroundColor Red
+  exit 1
+}
+
+Write-Host ''
+Write-Host "Files to upload: $($uploadFiles.Count)" -ForegroundColor Green
+foreach ($path in ($uploadFiles | Sort-Object)) {
+  Write-Host "  - $([System.IO.Path]::GetFileName($path))"
+}
+
+if ($CheckOnly) {
+  Write-Host ''
+  Write-Host 'CheckOnly: upload skipped.' -ForegroundColor Yellow
+  exit 0
+}
+
+Write-Title 'Upload'
+Write-Host "Target: ${sshTarget}:${remoteDir}"
+Write-Host "Feed: $feedUrl"
+
+foreach ($path in ($uploadFiles | Sort-Object)) {
+  $name = [System.IO.Path]::GetFileName($path)
+  Write-Host "  -> $name"
+  & scp -i $sshKey -q $path "${sshTarget}:${remoteDir}/"
+  if ($LASTEXITCODE -ne 0) {
+    throw "scp failed for $name (exit $LASTEXITCODE)"
+  }
+}
+
+Write-Host ''
+Write-Host 'Setting www-data ownership on server...'
+& ssh -i $sshKey $sshTarget "chown -R www-data:www-data '$remoteDir'"
+if ($LASTEXITCODE -ne 0) {
+  throw "ssh chown failed (exit $LASTEXITCODE)"
+}
+
+Write-Title 'Done'
+Write-Host 'Verify:'
+Write-Host "  ${feedUrl}latest.yml"
+if (Test-Path -LiteralPath (Join-Path $ReleaseDir 'latest-linux.yml')) {
+  Write-Host "  ${feedUrl}latest-linux.yml"
+}
+if (Test-Path -LiteralPath (Join-Path $ReleaseDir 'latest-mac.yml')) {
+  Write-Host "  ${feedUrl}latest-mac.yml"
+}
+
+exit 0

scripts/ttrpg-release/release-all-bump.cmd

@@ -0,0 +1,5 @@
+@echo off
+REM Legacy: bump version in script, then Win/Linux (Mac files added later).
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0release-all.ps1" -Bump %*
+if errorlevel 1 pause

scripts/ttrpg-release/release-all.cmd

@@ -0,0 +1,4 @@
+@echo off
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0release-all.ps1" %*
+if errorlevel 1 pause

scripts/ttrpg-release/release-all.ps1

@@ -0,0 +1,70 @@
+# Full release: prepare (build Win/Linux, copy) then publish (validate + upload).
+# Run: release-all.cmd  (default: -AfterMac, version already set, Mac files in release folder)
+#      release-all-bump.cmd  (bump version first, Mac later)
+
+param(
+  [string]$Version = '',
+  [switch]$Bump,
+  [switch]$AfterMac,
+  [switch]$Minor,
+  [switch]$SkipGit,
+  [switch]$SkipLinux,
+  [switch]$NoBump,
+  [switch]$CheckOnlyPublish,
+  [switch]$SkipMac
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$ToolDir = $PSScriptRoot
+$PrepareScript = Join-Path $ToolDir 'prepare-release.ps1'
+$PublishScript = Join-Path $ToolDir 'publish.ps1'
+
+if (-not (Test-Path -LiteralPath $PrepareScript)) {
+  throw "Missing prepare-release.ps1: $PrepareScript"
+}
+if (-not (Test-Path -LiteralPath $PublishScript)) {
+  throw "Missing publish.ps1: $PublishScript"
+}
+
+$useAfterMac = $AfterMac
+if ($Bump -and $AfterMac) {
+  throw 'Use either -Bump or -AfterMac, not both'
+}
+if (-not $Bump -and -not $PSBoundParameters.ContainsKey('AfterMac')) {
+  $useAfterMac = $true
+}
+
+$prepareArgs = @()
+if ($Version) { $prepareArgs += '-Version', $Version }
+if ($Bump) { $prepareArgs += '-Bump' }
+if ($useAfterMac) { $prepareArgs += '-AfterMac' }
+if ($Minor) { $prepareArgs += '-Minor' }
+if ($SkipGit) { $prepareArgs += '-SkipGit' }
+if ($SkipLinux) { $prepareArgs += '-SkipLinux' }
+if ($NoBump) { $prepareArgs += '-NoBump' }
+
+$publishArgs = @()
+if ($CheckOnlyPublish) { $publishArgs += '-CheckOnly' }
+if ($SkipMac) { $publishArgs += '-SkipMac' }
+
+Write-Host '=== TTRPG Full Release ===' -ForegroundColor Cyan
+Write-Host ''
+
+Write-Host '>>> Phase 1/2: Prepare release' -ForegroundColor Yellow
+& powershell -NoProfile -ExecutionPolicy Bypass -File $PrepareScript @prepareArgs
+if ($LASTEXITCODE -ne 0) {
+  throw "Prepare release failed (exit $LASTEXITCODE). Publish not started."
+}
+
+Write-Host ''
+Write-Host '>>> Phase 2/2: Publish to server' -ForegroundColor Yellow
+& powershell -NoProfile -ExecutionPolicy Bypass -File $PublishScript @publishArgs
+if ($LASTEXITCODE -ne 0) {
+  throw "Publish failed (exit $LASTEXITCODE)"
+}
+
+Write-Host ''
+Write-Host '=== Full release completed ===' -ForegroundColor Green
+exit 0

scripts/ttrpg-release/release-config.json

@@ -0,0 +1,7 @@
+{
+  "projectRoot": "D:\\Work\\my_projects\\dnd_project\\dnd_player",
+  "releaseDir": "D:\\TTRPG-Release",
+  "gitRemote": "origin",
+  "giteaMcpConfig": "C:\\Users\\Administrator\\.cursor\\mcp.json",
+  "wslDistro": ""
+}

scripts/ttrpg-release/release.cmd

@@ -0,0 +1,4 @@
+@echo off
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0release.ps1" %*
+if errorlevel 1 pause

scripts/ttrpg-release/release.ps1

@@ -0,0 +1,54 @@
+# Full release: prepare (version, git, build, copy) then publish (validate + upload).
+# Run: release.cmd
+
+param(
+  [string]$Version = '',
+  [switch]$Minor,
+  [switch]$SkipGit,
+  [switch]$SkipLinux,
+  [switch]$NoBump,
+  [switch]$CheckOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$ToolDir = $PSScriptRoot
+$PrepareScript = Join-Path $ToolDir 'prepare-release.ps1'
+$PublishScript = Join-Path $ToolDir 'publish.ps1'
+
+if (-not (Test-Path -LiteralPath $PrepareScript)) {
+  throw "Missing prepare-release.ps1 in $ToolDir"
+}
+if (-not (Test-Path -LiteralPath $PublishScript)) {
+  throw "Missing publish.ps1 in $ToolDir"
+}
+
+Write-Host '=== TTRPG Full Release ===' -ForegroundColor Cyan
+Write-Host 'Step A: prepare-release'
+Write-Host 'Step B: publish (after prepare succeeds)'
+Write-Host ''
+
+$prepareArgs = @('-File', $PrepareScript)
+if ($Version) { $prepareArgs += '-Version', $Version }
+if ($Minor) { $prepareArgs += '-Minor' }
+if ($SkipGit) { $prepareArgs += '-SkipGit' }
+if ($SkipLinux) { $prepareArgs += '-SkipLinux' }
+if ($NoBump) { $prepareArgs += '-NoBump' }
+
+& powershell -NoProfile -ExecutionPolicy Bypass @prepareArgs
+if ($LASTEXITCODE -ne 0) {
+  Write-Host ''
+  Write-Host 'Prepare failed. Publish was not started.' -ForegroundColor Red
+  exit $LASTEXITCODE
+}
+
+Write-Host ''
+Write-Host 'Prepare finished. Starting publish...' -ForegroundColor Green
+Write-Host ''
+
+$publishArgs = @('-File', $PublishScript)
+if ($CheckOnly) { $publishArgs += '-CheckOnly' }
+
+& powershell -NoProfile -ExecutionPolicy Bypass @publishArgs
+exit $LASTEXITCODE

scripts/wsl-pack-linux.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+export NVM_DIR="${HOME}/.nvm"
+if [[ -s "${NVM_DIR}/nvm.sh" ]]; then
+  # shellcheck source=/dev/null
+  . "${NVM_DIR}/nvm.sh"
+  nvm install
+  nvm use
+else
+  echo "nvm not found at ${NVM_DIR}/nvm.sh (install nvm or use Node 20.19+ / 22.12+ for Vite)" >&2
+  exit 1
+fi
+
+echo "Using $(node -v) ($(command -v node))"
+npm ci
+npm run pack:linux