chore(release): point updater feed at updates.mailib.ru (v1.0.16)

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>

.gitea/workflows/release.yml

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

app/main/index.ts

@@ -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 «пропадают» из списка (остаются в старой папке).
@@ -447,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 };
@@ -473,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({

app/main/license/licenseService.ts

@@ -7,7 +7,7 @@ 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';
@@ -87,7 +87,7 @@ export class LicenseService {
   private deriveFallbackKey(): Buffer {
     return crypto
       .createHash('sha256')
-      .update('DNDGamePlayer.license.fallback.v1\0', 'utf8')
+      .update('TTRPGPlayer.license.fallback.v1\0', 'utf8')
       .update(this.deviceId, 'utf8')
       .digest();
   }
@@ -342,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/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,7 @@
 import { app, dialog } from 'electron';
 import { autoUpdater } from 'electron-updater';
 
+import { appDisplayNameForLocale } from '../../shared/appBranding';
 import {
   ipcChannels,
   type UpdaterCheckResponse,
@@ -77,6 +78,7 @@ function registerUpdaterHandlers(register: RegisterFn, licenseService: LicenseSe
 /**
  * Проверка обновлений: только упакованное приложение, только при активной лицензии.
  * Канал и 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, register: RegisterFn): void {
   registerUpdaterHandlers(register, licenseService);
@@ -89,6 +91,15 @@ export function installAutoUpdater(licenseService: LicenseService, register: Reg
     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;
 
@@ -100,7 +111,7 @@ export function installAutoUpdater(licenseService: LicenseService, register: Reg
     void dialog
       .showMessageBox({
         type: 'info',
-        title: 'DNDGamePlayer',
+        title: appDisplayNameForLocale(app.getLocale()),
         message: `Доступна новая версия ${info.version}. Установить и перезапустить?`,
         buttons: ['Перезапустить сейчас', 'Позже'],
         defaultId: 0,

app/main/windows/bootWindow.ts

@@ -2,6 +2,7 @@ import path from 'node:path';
 
 import { app, BrowserWindow } from 'electron';
 
+import { appDisplayNameForLocale } from '../../shared/appBranding';
 import { getAppSemanticVersion } from '../versionInfo';
 
 import { loadBrandingWindowIcon } from './brandingIcon';
@@ -93,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/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

@@ -4,6 +4,7 @@ import { createPortal } from 'react-dom';
 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';
@@ -377,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
@@ -1319,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': 'Не принимаю',
@@ -156,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': 'Сохранить как…',
 
@@ -288,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…',
@@ -297,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',
@@ -383,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/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

@@ -16,11 +16,14 @@ void test('package.json: конфиг electron-builder (mac/win/linux)', () => {
       mac: { target: unknown };
       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')));
@@ -36,10 +39,15 @@ void test('package.json: конфиг electron-builder (mac/win/linux)', () => {
     ),
   );
   assert.ok(Array.isArray(pkg.build.mac.target));
+  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.ok(pkg.build.appImage?.artifactName?.includes('${arch}'));
+  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/**/*'));
 });

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,484 +1,52 @@
-# Автообновление через Gitea (приватный код + публичный feed)
+# Автообновления TTRPG Player
 
-Исходники остаются в **закрытом** репозитории с игрой. Файлы обновлений (`latest.yml`, установщики) лежат в **отдельном публичном** репозитории — по HTTPS их скачивает `electron-updater`.
+## Сборка и публикация
 
-## Твой публичный репозиторий (уже есть)
+- Релизы собираются **локально** (CI отключён).
+- Артефакты кладутся в `D:\TTRPG-Release\` (или копируются из `release\` после сборки).
+- Публикация на VPS: `powershell -ExecutionPolicy Bypass -File scripts\publish-to-updates.ps1`
+- **Имена файлов без версии** — версия только в `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)** и **Linux (AppImage x64 + arm64)** в CI идёт **на одном** `ubuntu-22.04`: NSIS + `wine64` для Win, `qemu-user-static` для кросс-сборки arm64 AppImage на amd64 (см. `release.yml`). **macOS** в этом job не собирается (ручная выкладка или отдельный раннер — см. `docs/MANUAL_MAC_UPDATE_UPLOAD.md`).
-
----
-
-## Linux: AppImage и автообновление
-
-- В ветке **`updates`** рядом с Windows лежат **`latest-linux.yml`** и файлы **`*.AppImage`** (x64 и arm64). Скрипт **`scripts/sync-update-feed.mjs`** делает **merge-копирование**: файлы других ОС в репозитории **не удаляются**, обновляются только имена, пришедшие из текущего CI-прогона.
-- **Базовый дистрибутив для бинарников:** сборка на **Ubuntu 22.04 (glibc 2.35)** — совместимость с «максимумом» настольных дистрибутивов с glibc не старее целевого; **Alpine/musl** без отдельной сборки не гарантируется.
-- **Запуск AppImage:** на части систем нужен **FUSE** (например `libfuse2` для старых форматов / документация дистрибутива). Подпись пакетов в первом варианте **не** используется (как договорённость по проекту).
-- Правила **electron-updater** в приложении те же: упакованная сборка и **активная лицензия** (`installAutoUpdater.ts`).
-
----
-
-## Шаг 4 — выпуск версии
-
-1. В `package.json` версия должна совпасть с тегом (workflow при пуше тега делает `npm version` из имени тега — удобно).
-2. Закоммить все изменения в **приватный** репо, затем:
-
-```bash
-git tag v1.0.1
-git push origin main
-git push origin v1.0.1
-```
-
-(ветка может быть не `main` — подставь свою.)
-
-3. Открой в Gitea **«Действия»** у приватного репо — должен появиться запуск **Release**. Дождись успеха job **`release`** (после появления раннера, см. раздел выше).
-
-4. После успеха открой **публичный** `DndGamePlayerUpdates` → ветка **`updates`** — в корне должны появиться `latest.yml`, установщики и т.д.
-
----
-
-## Контрольный чеклист
-
-1. **`package.json` → `build.publish.url`** =  
-   `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/`  
-   Совпадает с **`DND_UPDATE_FEED_URL`** (со слэшем в конце).
-2. В **DndGamePlayerUpdates** есть хотя бы один коммит (не пустой репо).
-3. В приватном репо заданы **все четыре** секрета из таблицы шага 2 (имена **не** начинаются с `GITEA_`).
-4. В репо с кодом есть **`.gitea/workflows/release.yml`**.
-5. Релиз: пуш тега `v*` → в Actions job **`release`**: сборка **Windows** + **Linux AppImage** и push feed; в публичном репо ветка **`updates`** содержит `latest.yml`, `latest-linux.yml`, установщики Windows и **`.AppImage`** для Linux (нужен online-раннер `ubuntu-22.04`, см. раздел про act_runner). Скрипт sync **не затирает** артефакты других платформ при обновлении.
-6. В приложении: обновления только **`app.isPackaged`** и при **активной лицензии** (см. `app/main/update/installAutoUpdater.ts`).
-
----
-
-## Если `git push` в `updates` падает: `remote end hung up` / таймаут
-
-Один коммит с **Windows + два AppImage** может быть **сотни МБ** — HTTPS-push иногда рвётся из‑за лимита буфера Git или таймаута **nginx / reverse proxy** перед Gitea. Отдельно встречается **`HTTP 500`** от Gitea/прокси на большом pack (например один `*-win.zip` ~200 MiB) — это уже **ошибка сервера** при приёме тела запроса; повторы push иногда помогают, но при стабильном 500 нужно править лимиты/таймауты на стороне Gitea и reverse proxy.
-
-**В репозитории с кодом** скрипт `scripts/sync-update-feed.mjs` уже выставляет в клоне feed-репо:
-
-- `http.postBuffer` **2 GiB**;
-- отключение «медленной передачи» (`http.lowSpeedLimit` / `http.lowSpeedTime`);
-- повторы **`git push`**: переменная **`DND_GIT_PUSH_RETRIES`** (по умолчанию **5**, максимум **10**), пауза **`DND_GIT_PUSH_RETRY_SLEEP_SEC`** (по умолчанию **30** с, максимум **120**). В workflow для шага sync задано **`DND_GIT_PUSH_RETRIES=8`** и **`DND_GIT_PUSH_RETRY_SLEEP_SEC=35`**.
-
-Если ошибка сохраняется — на **сервере** (nginx и т.п.) проверьте, например:
-
-- `client_max_body_size` — не меньше размера push (или `0` для безлимита, если политика безопасности позволяет);
-- `proxy_read_timeout` / `proxy_send_timeout` — **несколько минут** и больше для больших загрузок;
-- лимиты самого **Gitea** (`[repository.upload]`, `APP_MAX_FILE_SIZE` в зависимости от версии) — в документации вашей сборки Gitea.
-
----
-
-## Линейная история в `UPDATES_REPO` (например DndGamePlayerUpdates)
-
-Переписывается **только** публичный репозиторий из секрета **`UPDATES_REPO`**, ветка **`updates`**. Репозиторий с исходниками игры (**DndGamePlayer**) и его теги **не меняются**.
-
-В workflow задано **`DND_UPDATES_SQUASH_HISTORY=1`**: после merge и подкладки артефактов скрипт делает **`git checkout --orphan`** и собирает историю **только текущего релиза**. Чтобы не отправлять один огромный pack (~700+ MiB) и не ловить `curl 55 Broken pipe`, загрузка идёт через **временную** ветку **`updates-upload-*`**: сначала small files, затем каждый большой файл отдельным push (порог **`DND_FEED_LARGE_FILE_BYTES`**, по умолчанию 64 MiB). Эта ветка **не заменяет** публичный feed: URL для клиентов по-прежнему **`…/raw/branch/updates/`**. `updates-upload-*` — только черновик на время job; в конце ветка **`updates`** передвигается на готовый коммит (`--force-with-lease` или первый push), временная ветка **удаляется** с remote.
-
-На **сервере Gitea** старые объекты коммитов остаются «висячими», пока не отработает **сборка мусора** репозитория (настройки сервера / ручной `git gc` в bare-репо). Для пользователей приложения важны только URL **`latest*.yml`** и установщиков — они не меняются по смыслу.
-
-Не запускайте **два релиза**, которые одновременно пушат feed, — возможна гонка и отказ **`--force-with-lease`**.
-
-Перед подкладкой артефактов скрипт **удаляет** из корня ветки файлы вида **`DNDGamePlayer-<чужая версия>-*`** / **`DNDGamePlayer-Setup-<чужая версия>.exe`** (и связанные `.blockmap`), чтобы после `merge` не копились старые установщики (1.0.6 рядом с 1.0.14). Версия текущего релиза берётся из **`GIT_COMMIT_TAG`** (`v1.0.14` → `1.0.14`). Файлы **`latest*.yml`** перезаписываются копированием. Если в **`ARTIFACT_MAC`** нет ни одного файла сборки, **`.dmg` / `.pkg`** не удаляются — сохраняется вручную залитый mac в feed. Отключить очистку: **`DND_FEED_PRUNE_OLD_VERSIONS=0`**.
-
----
-
-## Если push отклонён: `(fetch first)` / `rejected`
-
-Пока job собирает артефакты, в **`updates`** мог успеть попасть **другой** коммит (второй релиз, ручная выкладка). Скрипт `sync-update-feed.mjs` перед push (в режиме **без** squash) делает **`git fetch` + `git merge origin/updates`** (и после клона — то же в начале), плюс shallow **глубина** (`DND_UPDATES_CLONE_DEPTH`: по умолчанию **40**, при **`DND_UPDATES_SQUASH_HISTORY=1`** в скрипте по умолчанию **8**). В режиме **squash** перед финальным push merge **не** выполняется — уже смерженное дерево отправляется через временную ветку и затем публикуется force-with-lease. Не запускайте **два релиза одного и того же репо одновременно** по двум тегам — возможны конфликты merge.
-
----
-
-## ENOSPC / «no space left on device» при sync
-
-Частая причина: **дублирование** артефактов (`release/` → `_linux`/`_win` → временный клон в **`/tmp`**) на раннере с маленьким root. Сейчас CI **не копирует** в `_win`/`_linux`: `ARTIFACT_WIN` и `ARTIFACT_LINUX` указывают на **`release/`**, а временный клон feed создаётся под **`DND_FEED_TMP_ROOT`** (в workflow — `${{ github.workspace }}/.dnd-feed-tmp`). Скрипт по возможности делает **`rename`** файлов в клон (без второй полной копии на том же диске).
-
-Если ошибка остаётся — на машине раннера нужно **освободить место** или увеличить диск / вынести workspace на больший том.
-
-Перед `git clone` скрипт проверяет **свободное место на томе**, где лежит `DND_FEED_TMP_ROOT` (оценка: артефакты × 2.5 + ~1 GiB запас, минимум ~2 GiB). Если проверка мешает (редкий ложный срабатывание), можно задать **`DND_FEED_SKIP_DISK_CHECK=1`** (лучше всё же поправить диск).
-
-Несколько **неудачных** `git fetch` подряд (обрыв TLS) могли раньше забивать диск частично распакованными pack-файлами; между попытками вызывается **`git gc --prune=now`**.
-
----
-
-## Сбой fetch: `GnuTLS recv error` / `early EOF`
-
-Сеть или TLS к серверу Gitea. Скрипт делает **несколько повторов** `git fetch` (`DND_GIT_FETCH_RETRIES`, по умолчанию **6**), между попытками — **`git gc --prune=now`**, для clone/fetch задано **`http.version=HTTP/1.1`** (иногда стабильнее за прокси). Если ветки **`updates` на сервере ещё нет**, merge **намеренно** пропускается (первый push feed); при **любой другой** ошибке fetch job **завершится ошибкой** — не будет «тихого» продолжения с последующим `ENOSPC` на `git add`.
-
-При стабильных обрывах проверьте прокси/MTU/антивирус на раннере и лимиты прокси к Gitea.
-
----
-
-## Поведение приложения
-
-- Проверка только в **собранной** установке (`app.isPackaged`).
-- Только если **лицензия активна**.
-- Первый запрос примерно через **12 с** после старта; при смене лицензии — снова (не чаще **30 с**).
-- Для отладки можно задать переменную окружения **`DND_UPDATE_FEED_URL`** при запуске приложения (Windows / Linux / macOS) — переопределит feed.
-
-Подпись кода в CI отключена: `CSC_IDENTITY_AUTO_DISCOVERY=false` (в т.ч. Linux AppImage без репозитория подписи).
-
----
-
-## Локальная отладка feed
-
-Запуск установленного приложения с другим URL (без пересборки): задать **`DND_UPDATE_FEED_URL`** в ярлыке или системных переменных окружения.
-
----
-
-## Как сделать так, чтобы ассистент в Cursor мог «выпустить релиз»
-
-У ассистента **нет своего аккаунта** на `git.mailib.ru`. Релиз = **появление тега `v*`** на нужном коммите в **приватном** репозитории с кодом → Gitea Actions собирает и пушит feed. Ниже два рабочих варианта.
-
-### Вариант A — Gitea MCP (удобно из чата)
-
-У тебя уже подключён MCP **user-gitea-mailib** с инструментом **`create_tag`**: по API создаётся тег на сервере (аналог `git tag` + `git push` тега).
-
-**Что сделать один раз:**
-
-1. В Cursor MCP для Gitea должен быть **включён и залогинен** под учёткой, у которой есть право **создавать теги** в приватном репо с `dnd_player`.
-2. Знать **`owner`** и **`repo`** этого репозитория (как в URL: `https://git.mailib.ru/OWNER/REPO`).
-
-**Как просить в чате:**  
-«Создай тег `v1.0.2` в репозитории `OWNER/REPO` с целевой веткой `main`» (или укажи SHA коммита). Перед этим **весь код релиза уже должен быть запушен** в эту ветку — тег вешается на последний коммит (или на явный `target`).
-
-После создания тега зайди в **Действия** репозитория и проверь workflow **Release**.
-
-_(Отдельно: `create_release` в MCP создаёт **запись релиза** на Gitea; сборку у тебя запускает именно **тег** и `release.yml`.)_
-
-### Вариант B — команды `git` в терминале Cursor
-
-Ассистент может выполнить у тебя локально:
-
-```bash
-git fetch origin
-git tag v1.0.2 origin/main   # или другая ветка / коммит
-git push origin v1.0.2
-```
-
-**Что сделать один раз:**
-
-1. Чтобы `git push` **не спрашивал пароль** каждый раз: настроить **учётные данные** (Windows: диспетчер учётных данных / `git credential-manager`; либо **SSH-ключ** и remote `git@git.mailib.ru:...`).
-2. Убедиться, что из того же окружения, где работает Cursor, `git push` в приватный репо уже проходил успешно.
-
-Тогда в чате можно написать: «Поставь тег `v1.0.2` на `origin/main` и запушь тег» — ассистент выполнит команды в `dnd_player`.
-
-### Ограничения
-
-- Ассистент **не видит** твои пароли и не обходит Gitea: всё упирается в **MCP-токен** или **твои локальные git credentials**.
-- Если MCP отключён и git без настроенного доступа — релиз тегом придётся пушить **тебе** вручную (как в шаге 4 выше).
-
----
-
-## Про коммит и пуш кода (не тег)
-
-Закоммитить и запушить **изменения в файлах** ассистент может через те же механизмы: либо ты делаешь `git push` после правок, либо настроенный **git** / отдельный скрипт. Без доступа к remote ассистент только правит файлы в рабочей копии.

docs/MANUAL_MAC_UPDATE_UPLOAD.md

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

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`).
@@ -29,7 +29,7 @@
 Пример запуска AppImage:
 
 ```bash
-DND_LICENSE_INSECURE_FILE_STORAGE=1 ./DNDGamePlayer-1.0.12-x64.AppImage --no-sandbox --appimage-extract-and-run
+DND_LICENSE_INSECURE_FILE_STORAGE=1 ./TTRPGPlayer-1.0.12-x64.AppImage --no-sandbox --appimage-extract-and-run
 ```
 
 ## Юридическое (D9)

package-lock.json

@@ -1,11 +1,11 @@
 {
-  "name": "DndGamePlayer",
+  "name": "TTRPGPlayer",
   "version": "1.0.15",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "DndGamePlayer",
+      "name": "TTRPGPlayer",
       "version": "1.0.15",
       "hasInstallScript": true,
       "license": "ISC",

package.json

@@ -1,7 +1,7 @@
 {
-  "name": "DndGamePlayer",
+  "name": "TTRPGPlayer",
-  "version": "1.0.15",
+  "version": "1.0.16",
-  "description": "DNDGamePlayer — редактор и проигрыватель игр",
+  "description": "TTRPG Player — редактор и проигрыватель НРИ",
   "main": "dist/main/index.cjs",
   "scripts": {
     "dev": "node scripts/dev.mjs",
@@ -19,7 +19,8 @@
     "pack:dir": "npm run build && node scripts/release-win-prep.mjs && electron-builder --dir",
     "pack:mac": "npm run build && electron-builder --mac",
     "pack:win": "npm run build && node scripts/release-win-prep.mjs && electron-builder --win",
-    "pack:linux": "npm run build && electron-builder --linux"
+    "pack:linux": "node scripts/release-linux-pack.mjs",
+    "publish:updates": "powershell -ExecutionPolicy Bypass -File scripts/publish-to-updates.ps1"
   },
   "keywords": [],
   "author": "",
@@ -70,9 +71,9 @@
     "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"
@@ -96,6 +97,9 @@
       "node_modules/@img/**",
       "node_modules/ffmpeg-static/**"
     ],
+    "toolsets": {
+      "appimage": "1.0.2"
+    },
     "mac": {
       "category": "public.app-category.games",
       "target": [
@@ -144,22 +148,25 @@
         }
       ],
       "category": "Game",
-      "maintainer": "DNDGamePlayer",
+      "maintainer": "TTRPGPlayer",
-      "synopsis": "DNDGamePlayer — редактор и проигрыватель игр",
+      "synopsis": "TTRPG Player — tabletop RPG editor and player",
       "icon": "build/icon.png"
     },
     "appImage": {
-      "artifactName": "${productName}-${version}-${arch}.${ext}"
+      "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/publish-to-updates.ps1

@@ -0,0 +1,53 @@
+# Заливка релиза на https://updates.mailib.ru/ (nginx root: /var/www/updates_mailib_ru)
+# Использование:
+#   1) Положите артефакты в $LocalDir (или соберите pack:win и скопируйте из release\)
+#   2) powershell -ExecutionPolicy Bypass -File scripts\publish-to-updates.ps1
+
+$ErrorActionPreference = 'Stop'
+
+$Key = "$env:USERPROFILE\.ssh\ttrpg_updates_root"
+$LocalDir = 'D:\TTRPG-Release'
+$SshTarget = 'root@185.173.94.234'
+$RemoteDir = '/var/www/updates_mailib_ru'
+
+if (-not (Test-Path $Key)) {
+  Write-Error "SSH key not found: $Key"
+}
+if (-not (Test-Path $LocalDir)) {
+  Write-Error "Local release folder not found: $LocalDir"
+}
+
+$patterns = @(
+  'latest.yml',
+  'latest-linux*.yml',
+  'latest-mac.yml',
+  'TTRPGPlayer-Setup.exe',
+  'TTRPGPlayer-Setup.exe.blockmap',
+  'TTRPGPlayer-x64.AppImage',
+  'TTRPGPlayer-x86_64.AppImage',
+  'TTRPGPlayer-arm64.AppImage',
+  'TTRPGPlayer-x64.dmg',
+  'TTRPGPlayer-arm64.dmg'
+)
+
+$files = @()
+foreach ($pat in $patterns) {
+  $files += Get-ChildItem -Path $LocalDir -Filter $pat -File -ErrorAction SilentlyContinue
+}
+$files = $files | Sort-Object -Property Name -Unique
+
+if (-not $files) {
+  Write-Error "No release files matched in $LocalDir"
+}
+
+Write-Host "Uploading to ${SshTarget}:${RemoteDir}"
+foreach ($f in $files) {
+  Write-Host "  -> $($f.Name)"
+  & scp -i $Key $f.FullName "${SshTarget}:${RemoteDir}/"
+}
+
+& ssh -i $Key $SshTarget "chown -R www-data:www-data $RemoteDir && ls -la $RemoteDir"
+
+Write-Host ''
+Write-Host 'Verify:'
+Write-Host '  curl https://updates.mailib.ru/latest.yml'

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