From 7c858ba633d2e2dd77fa2c58bdb0e6671305efa4 Mon Sep 17 00:00:00 2001 From: Ivan Fontosh Date: Sun, 17 May 2026 20:56:14 +0800 Subject: [PATCH] feat(phase1): rebrand to TTRPG Player and drop Git updates feed Rename product to TTRPG Player (TTRPGPlayer / com.ttrpgplayer.app), use .ttrpg.zip for new saves while keeping .dnd.zip import, accept TTRPG- and DND- license keys on client, and remove sync-update-feed plus CI push to DndGamePlayerUpdates. Co-authored-by: Cursor --- .gitea/workflows/release.yml | 76 +-- app/main/index.ts | 28 +- app/main/license/licenseService.ts | 6 +- app/main/project/atomicReplace.ts | 22 +- app/main/project/paths.ts | 9 +- app/main/project/zipRead.test.ts | 4 +- .../project/zipStore.legacyContract.test.ts | 2 +- app/main/project/zipStore.ts | 44 +- app/main/update/installAutoUpdater.ts | 3 +- app/main/windows/bootWindow.ts | 3 +- app/renderer/boot.html | 2 +- app/renderer/editor/EditorApp.tsx | 5 +- app/renderer/editor/i18n/editorMessages.ts | 12 +- app/renderer/legal/eulaRu.ts | 2 +- app/shared/appBranding.ts | 13 + app/shared/license/productKey.test.ts | 18 +- app/shared/license/productKey.ts | 11 +- app/shared/package.build.test.ts | 2 +- app/shared/project/projectZipExtension.ts | 52 ++ app/shared/types/domain.ts | 2 +- docs/GITEA_AUTO_UPDATE.md | 533 ++--------------- docs/MANUAL_MAC_UPDATE_UPLOAD.md | 161 +----- docs/licensing-spec.md | 6 +- package-lock.json | 4 +- package.json | 16 +- scripts/release-win-prep.mjs | 4 +- scripts/sync-update-feed.mjs | 541 ------------------ 27 files changed, 253 insertions(+), 1328 deletions(-) create mode 100644 app/shared/appBranding.ts create mode 100644 app/shared/project/projectZipExtension.ts delete mode 100644 scripts/sync-update-feed.mjs diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml index 0c6686c..981ad92 100644 --- a/.gitea/workflows/release.yml +++ b/.gitea/workflows/release.yml @@ -1,13 +1,9 @@ -# Сборка по тегу v* и выкладка в публичный репо (ветка updates). +# Сборка по тегу v* (Win NSIS + Linux AppImage x64/arm64). # -# Метки 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 без затирания других ОС. +# Метки runs-on = labels act_runner (Gitea → Действия → Раннеры). +# Публикация обновлений в Git-репозиторий отключена (фаза 1); выкладка на статический VPS — фаза 2. # -# Один 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 +# Secrets для feed больше не нужны. См. docs/GITEA_AUTO_UPDATE.md name: Release @@ -30,10 +26,6 @@ jobs: 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: | @@ -69,7 +61,6 @@ jobs: - run: npm run build - # Linux AppImage (x64 + arm64) до подмешивания win32-sharp в node_modules. - name: Зависимости Linux AppImage и кросс-сборка arm64 на amd64 shell: bash run: | @@ -81,20 +72,8 @@ jobs: 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}" + run: npx electron-builder --linux AppImage --x64 --arm64 --publish never - # Не используем `npm install`: на Linux npm падает с EBADPLATFORM для win32-пакета. - name: sharp (@img/sharp-win32-x64) для Windows-артефакта при сборке на Linux shell: bash run: | @@ -108,45 +87,12 @@ jobs: rm -rf "$tmp" - name: electron-builder (win) + run: npx electron-builder --win --publish never + + - name: Артефакты сборки 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: ... + echo "=== release/ ===" + ls -la release/ || true + echo "Готово. Выкладка на update-сервер — вручную или в фазе 2 (VPS + nginx)." diff --git a/app/main/index.ts b/app/main/index.ts index 53677f3..7da0589 100644 --- a/app/main/index.ts +++ b/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') - ? entry.fileName - : `${entry.fileName}.dnd.zip`; + const defaultName = isProjectZipFileName(entry.fileName) + ? entry.fileName.toLowerCase().endsWith('.ttrpg.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 lower = dest.toLowerCase(); - if (!lower.endsWith('.dnd.zip')) { - dest = lower.endsWith('.zip') ? dest.replace(/\.zip$/iu, '.dnd.zip') : `${dest}.dnd.zip`; - } + const dest = normalizeSaveProjectZipPath(filePath); emitZipProgress({ kind: 'export', stage: 'copy', percent: 0, detail: 'Экспорт…' }); await projectStore.exportProjectZipToPath(projectId, dest, (p) => { emitZipProgress({ diff --git a/app/main/license/licenseService.ts b/app/main/license/licenseService.ts index 50801fa..b1d6a26 100644 --- a/app/main/license/licenseService.ts +++ b/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); diff --git a/app/main/project/atomicReplace.ts b/app/main/project/atomicReplace.ts index c86acd3..05d1f76 100644 --- a/app/main/project/atomicReplace.ts +++ b/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 { @@ -50,8 +56,10 @@ export async function replaceFileAtomic(completedSrc: string, finalPath: string) await fs.unlink(backupPath).catch(() => undefined); } -/** Если сохранение оборвалось, остаётся только `*.dnd.zip.tmp` — восстанавливаем в `*.dnd.zip`. */ -export async function recoverOrphanDndZipTmpInRoot(root: string): Promise { +const ZIP_TMP_SUFFIXES = [`${PROJECT_ZIP_EXTENSION}.tmp`, `${PROJECT_ZIP_EXTENSION_LEGACY}.tmp`] as const; + +/** Если сохранение оборвалось, остаётся `*.ttrpg.zip.tmp` / `*.dnd.zip.tmp` — восстанавливаем финальный архив. */ +export async function recoverOrphanProjectZipTmpInRoot(root: string): Promise { let names: string[]; try { names = await fs.readdir(root); @@ -59,10 +67,11 @@ export async function recoverOrphanDndZipTmpInRoot(root: string): Promise 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 } } } + +/** @deprecated Используйте {@link recoverOrphanProjectZipTmpInRoot}. */ +export const recoverOrphanDndZipTmpInRoot = recoverOrphanProjectZipTmpInRoot; diff --git a/app/main/project/paths.ts b/app/main/project/paths.ts index 88cfc93..e8a2f39 100644 --- a/app/main/project/paths.ts +++ b/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'); diff --git a/app/main/project/zipRead.test.ts b/app/main/project/zipRead.test.ts index 0f5a029..0f92848 100644 --- a/app/main/project/zipRead.test.ts +++ b/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', diff --git a/app/main/project/zipStore.legacyContract.test.ts b/app/main/project/zipStore.legacyContract.test.ts index 637f540..1bea2f8 100644 --- a/app/main/project/zipStore.legacyContract.test.ts +++ b/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\)/); diff --git a/app/main/project/zipStore.ts b/app/main/project/zipStore.ts index 4a00749..db97eda 100644 --- a/app/main/project/zipStore.ts +++ b/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 { 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')) { - throw new Error('Ожидается файл с расширением .dnd.zip'); + if (!isProjectZipFileName(resolved)) { + 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 { - let base = preferredBaseFileName; - if (!base.toLowerCase().endsWith('.dnd.zip')) { - const stem = sanitizeFileName(path.basename(base, path.extname(base)) || 'project'); - base = `${stem}.dnd.zip`; - } - const stem = base.replace(/\.dnd\.zip$/iu, ''); - let candidate = base; +async function uniqueProjectZipFileNameInRoot(root: string, preferredBaseFileName: string): Promise { + const stem = sanitizeFileName(stripProjectZipExtension(path.basename(preferredBaseFileName)) || 'project'); + let candidate = projectZipFileNameFromBase(stem); 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; } diff --git a/app/main/update/installAutoUpdater.ts b/app/main/update/installAutoUpdater.ts index cd78621..dda4668 100644 --- a/app/main/update/installAutoUpdater.ts +++ b/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, @@ -110,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, diff --git a/app/main/windows/bootWindow.ts b/app/main/windows/bootWindow.ts index 1578412..e46671c 100644 --- a/app/main/windows/bootWindow.ts +++ b/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( diff --git a/app/renderer/boot.html b/app/renderer/boot.html index 9a5b418..bdefc24 100644 --- a/app/renderer/boot.html +++ b/app/renderer/boot.html @@ -113,7 +113,7 @@
-

DNDGamePlayer

+

TTRPG Player

редактор и проигрыватель

Запуск…

diff --git a/app/renderer/editor/EditorApp.tsx b/app/renderer/editor/EditorApp.tsx index 0fa96c5..2464ff1 100644 --- a/app/renderer/editor/EditorApp.tsx +++ b/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')} > -
DNDGamePlayer
+
{t('app.brandTitle')}
-
.dnd.zip
+
{PROJECT_ZIP_EXTENSION}
{!fileNameOk ?
{t('rename.fileInvalid')}
: null} {fileNameDup ?
{t('rename.fileDup')}
: null} diff --git a/app/renderer/editor/i18n/editorMessages.ts b/app/renderer/editor/i18n/editorMessages.ts index 7c5b359..ff22400 100644 --- a/app/renderer/editor/i18n/editorMessages.ts +++ b/app/renderer/editor/i18n/editorMessages.ts @@ -60,6 +60,8 @@ export const EDITOR_MESSAGES: Record> = { 'common.delete': 'Удалить', 'common.closeMenu': 'Закрыть меню', + 'app.brandTitle': 'НРИ Плеер', + 'notice.campaignAudioEmpty': 'Аудио не добавлено. Проверьте формат файла.', 'license.checkingTitle': 'Проверка лицензии…', @@ -69,7 +71,7 @@ export const EDITOR_MESSAGES: Record> = { 'Укажите ключ в меню «Настройки» → «Указать ключ». До активации доступно только меню «Настройки».', '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> = { 'export.title': 'Экспорт проекта', 'export.project': 'ПРОЕКТ', 'export.hint': - 'Далее откроется окно сохранения: укажите имя и папку для файла .dnd.zip — будет создана копия архива проекта.', + 'Далее откроется окно сохранения: укажите имя и папку для файла .ttrpg.zip — будет создана копия архива проекта.', 'export.exporting': 'Экспорт…', 'export.saveAs': 'Сохранить как…', @@ -288,6 +290,8 @@ export const EDITOR_MESSAGES: Record> = { '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> = { '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> = { '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…', diff --git a/app/renderer/legal/eulaRu.ts b/app/renderer/legal/eulaRu.ts index 1f68121..0f070f3 100644 --- a/app/renderer/legal/eulaRu.ts +++ b/app/renderer/legal/eulaRu.ts @@ -2,7 +2,7 @@ export const EULA_RU_MARKDOWN = ` # Лицензионное соглашение с конечным пользователем (EULA) -Используя DNDGamePlayer («Программу»), вы соглашаетесь с условиями ниже. +Используя НРИ Плеер («Программу»), вы соглашаетесь с условиями ниже. ## 1. Предоставление прав Правообладатель предоставляет вам неисключическую, непередаваемую лицензию на использование Программы в пределах приобретённой лицензии (активации). diff --git a/app/shared/appBranding.ts b/app/shared/appBranding.ts new file mode 100644 index 0000000..c5f220b --- /dev/null +++ b/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; +} diff --git a/app/shared/license/productKey.test.ts b/app/shared/license/productKey.test.ts index b7bb703..46d357c 100644 --- a/app/shared/license/productKey.test.ts +++ b/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: пример пользователя', () => { - assert.equal(isDndProductKey('DND-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD'), true); +void test('isProductKey: legacy DND prefix', () => { + assert.equal(isProductKey('DND-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD'), true); }); -void test('isDndProductKey: токен с точкой — нет', () => { - assert.equal(isDndProductKey('eyJ.xxx'), false); +void test('isProductKey: TTRPG prefix', () => { + assert.equal(isProductKey('TTRPG-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD'), true); }); -void test('isDndProductKey: пробелы по краям', () => { - assert.equal(isDndProductKey(' DND-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD '), true); +void test('isProductKey: token with dot — no', () => { + assert.equal(isProductKey('eyJ.xxx'), false); +}); + +void test('isProductKey: trimmed', () => { + assert.equal(isProductKey(' TTRPG-CEBEC1BF-AD0B-4312-BFDD-675AFF5955FD '), true); }); diff --git a/app/shared/license/productKey.ts b/app/shared/license/productKey.ts index 6c6444d..4b3e9ab 100644 --- a/app/shared/license/productKey.ts +++ b/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 { - return DND_PRODUCT_KEY_RE.test(s.trim()); +export function isProductKey(s: string): boolean { + 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); } diff --git a/app/shared/package.build.test.ts b/app/shared/package.build.test.ts index 68dd106..b62fa9a 100644 --- a/app/shared/package.build.test.ts +++ b/app/shared/package.build.test.ts @@ -20,7 +20,7 @@ void test('package.json: конфиг electron-builder (mac/win/linux)', () => { }; }; 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'))); diff --git a/app/shared/project/projectZipExtension.ts b/app/shared/project/projectZipExtension.ts new file mode 100644 index 0000000..3167176 --- /dev/null +++ b/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'], +}; diff --git a/app/shared/types/domain.ts b/app/shared/types/domain.ts index 7ee806f..9c7089e 100644 --- a/app/shared/types/domain.ts +++ b/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; diff --git a/docs/GITEA_AUTO_UPDATE.md b/docs/GITEA_AUTO_UPDATE.md index 239c5f0..02b06b8 100644 --- a/docs/GITEA_AUTO_UPDATE.md +++ b/docs/GITEA_AUTO_UPDATE.md @@ -1,519 +1,52 @@ -# Автообновление через Gitea (приватный код + публичный feed) +# Автообновления TTRPG Player -Исходники остаются в **закрытом** репозитории с игрой. Файлы обновлений (`latest.yml`, установщики) лежат в **отдельном публичном** репозитории — по HTTPS их скачивает `electron-updater`. +## Текущее состояние (фаза 1) -## Твой публичный репозиторий (уже есть) +- Продукт переименован в **TTRPG Player** / **НРИ Плеер** (`productName`: `TTRPGPlayer`, `appId`: `com.ttrpgplayer.app`). +- CI по тегу `v*` **только собирает** установщики в каталог `release/` (Win NSIS, Linux AppImage x64/arm64). Пуш в Git-репозиторий **`DndGamePlayerUpdates`** **отключён**; скрипт `scripts/sync-update-feed.mjs` удалён. +- В `package.json` → `build.publish.url` стоит заглушка `https://updates.invalid.ttrpg/` до настройки реального хоста. +- Секреты **`DND_UPDATE_FEED_URL`**, **`DND_UPDATES_SERVER`**, **`UPDATES_REPO`**, **`DND_UPDATES_PUSH_TOKEN`** в workflow **больше не используются** — их можно удалить из настроек репозитория. +- Публичный репозиторий **`DndGamePlayerUpdates` на Gitea можно удалить** (история с бинарниками ~4 GiB больше не нужна). -- Клон: `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git` -- Владелец/репо для секретов: **`ifontosh/DndGamePlayerUpdates`** -- Базовый URL feed (вшивается в сборку и должен совпадать с secret **`DND_UPDATE_FEED_URL`**): +Клиент по-прежнему использует **electron-updater** (generic provider). Пока URL заглушка, проверка обновлений в установленной сборке завершится ошибкой сети — это ожидаемо до фазы 2. - **`https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/`** +## Фаза 2 (план): статический VPS - Обрати внимание: слово **`branch`** в пути — это часть URL Gitea, не имя ветки. Имя ветки — в конце: **`updates`**. +Цель: один HTTPS- origin без Git LFS и без роста репозитория. -В `package.json` уже указан этот же `build.publish.url` (для локального `npm run pack` и метаданных electron-builder). +1. VPS с **nginx** (или аналог), TLS (Let's Encrypt). +2. Каталог, например `/var/www/ttrpg-updates/`, с **фиксированными именами** файлов (без версии в имени установщика) или с semver в `latest*.yml` и прямыми URL на те же имена. +3. CI или ручной шаг: **rsync/scp** артефактов из `release/` на сервер после тега `v*`. +4. В приватном репозитории кода — секрет **`TTRPG_UPDATE_FEED_URL`** (со слэшем в конце), подстановка в `electron-builder` при сборке релиза. +5. Mac: ручная выкладка `.dmg` / `latest-mac.yml` на тот же origin (см. `docs/MANUAL_MAC_UPDATE_UPLOAD.md`). ---- +Детали CI для VPS будут добавлены отдельным PR после выбора хоста и схемы имён файлов. -## Шаг 0 — репозиторий сейчас пустой (важно) - -На странице репо написано, что **контента нет**. Пока нет **ни одного коммита**, CI не сможет сделать `git clone`. - -Сделай так (любой способ): - -1. На сайте открой `ifontosh/DndGamePlayerUpdates` → кнопка вроде **«Инициализировать репозиторий»** / **«Добавить файл»** → создай файл `README.md` с парой строк и закоммить **в ветку по умолчанию** (часто `main`). -2. Либо с компьютера: +## Локальная сборка релиза ```bash -git clone https://git.mailib.ru/ifontosh/DndGamePlayerUpdates.git -cd DndGamePlayerUpdates -echo "# DndGamePlayer updates feed" > README.md -git add README.md -git commit -m "init" -git push origin main +npm run pack # Win (на Windows) или см. CI +npm run pack:linux # Linux AppImage +npm run pack:mac # macOS (на Mac) +npm run release:info # версия и пример тега vX.Y.Z ``` -(Если ветка по умолчанию у тебя `master` — подставь её вместо `main`.) +Артефакты: `TTRPGPlayer-Setup-.exe`, `TTRPGPlayer--.AppImage`, и т.д. (см. `package.json` → `build`). -После этого репозиторий **не пустой** — workflow сможет клонировать и создать ветку **`updates`**. +## Gitea Actions (act_runner) ---- +- Workflow: `.gitea/workflows/release.yml` +- Триггер: push тега `v*` +- Runner label: `ubuntu-22.04` (как в настройках раннера) -## Шаг 1 — токен для записи в публичный репозиторий +Если job падает на Wine/NSIS — см. комментарии в workflow (сборка Win на Linux без i386). -Нужен **персональный токен** (PAT), с которым CI сможет **пушить** в `DndGamePlayerUpdates`. +## Лицензия и обновления -В Gitea на русском обычно так (названия могут чуть отличаться в твоей теме): +Проверка обновлений доступна только при **активной лицензии** (как и раньше). Продуктовые ключи на клиенте: **`TTRPG-…`** и устаревшие **`DND-…`**; новые ключи выдаёт сервер лицензий (отдельный репозиторий `DndGamePlayerLicenseServer` — смена префикса на сервере вне этого PR). -1. Вверху справа **аватар** → **Настройки** (или «Параметры»). -2. Слева найди раздел вроде **«Приложения»** / **«Токены доступа»** / **«Токены»** (в англ. интерфейсе: **Settings → Applications → Generate New Token**). -3. Создай новый токен: - - имя: например `dnd-release-ci`; - - права: достаточно доступа к репозиторию с **записью** (для пуша в `DndGamePlayerUpdates`). Если есть галочки — включи что-то вроде **«Запись в репозиторий»** / **write:repository** / полный доступ к репо. -4. **Скопируй токен один раз** и сохрани в менеджере паролей — потом Gitea его не покажет. +## Устаревшая схема (не использовать) -Этот токен пойдёт в secret **`DND_UPDATES_PUSH_TOKEN`** (см. ниже). **Не вставляй токен в код и не коммить его.** - -> На **git.mailib.ru** имена секретов **не могут начинаться с `GITEA_`** (зарезервировано). Поэтому в workflow используются `DND_UPDATES_*`, а не `GITEA_*`. - ---- - -## Шаг 2 — секреты в приватном репозитории с кодом (`dnd_player`) - -Открой **приватный** репозиторий, где лежит исходник игры (не `DndGamePlayerUpdates`). - -Дальше (русский Gitea 1.26, ориентир по меню): - -1. Вкладка **«Настройки»** репозитория (вверху рядом с «Код», «Задачи» — иногда шестерёнка **«Настройки»**). -2. Слева раздел **«Секреты»** / **«Действия»** → **«Секреты»** (в англ. UI: **Settings → Actions → Secrets**). Если видишь **«Переменные»** — секреты обычно рядом; нам нужны именно **секреты** (скрытые значения). - -Добавь **четыре** секрета (имя **точно** как в таблице — workflow их читает): - -| Имя секрета | Что вписать в значение | -| ------------------------ | -------------------------------------------------------------------------------------------------------- | -| `DND_UPDATE_FEED_URL` | `https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/` (обязательно **слэш в конце**) | -| `DND_UPDATES_SERVER` | `https://git.mailib.ru` (**без** слэша в конце) | -| `UPDATES_REPO` | `ifontosh/DndGamePlayerUpdates` | -| `DND_UPDATES_PUSH_TOKEN` | токен из шага 1 (одна длинная строка) | - -Сохрани каждый секрет кнопкой вроде **«Сохранить»** / **«Добавить»**. - -Если раньше создавал секреты `GITEA_SERVER` / `GITEA_TOKEN` — их workflow **не читает**; удали или оставь, но **обязательно** заведи новые имена из таблицы. - ---- - -## Раннер act_runner — без этого «Всего: 0» и сборки не будет - -Gitea **не запускает** workflow на своём процессе: нужна **отдельная машина** (VPS, сервер или **WSL2 Ubuntu** на твоём ПК), на которой крутится **[act_runner](https://docs.gitea.com/usage/actions/act-runner)** и которая видит `git.mailib.ru` по сети. - -Пока в **«Настройки» → «Действия» → «Раннеры»** написано **«Всего: 0»**, workflow **висит в ожидании** — нечему выполнять шаги. - -### Важно: это не тот токен, что для пуша в `DndGamePlayerUpdates` - -| Токен | Где взять | Зачем | -| --------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -| **Регистрация раннера** (короткая случайная строка) | **Настройки репо** → **Действия** → **Раннеры** → **Создать новый раннер** | Только для команды **`act_runner register`** (один раз на каталог с раннером) | -| **`DND_UPDATES_PUSH_TOKEN`** (PAT) | **Аватар** → **Настройки пользователя** → токены доступа | Для CI: пуш в публичный репо обновлений (см. шаг 1 выше) | - -Если Gitea показала **только длинную строку** — это почти наверняка **токен регистрации раннера**. URL инстанса ты знаешь сам: **`https://git.mailib.ru`** (без пути к репозиторию). - -### Требования к машине под наш `release.yml` - -В workflow для job **`ubuntu-22.04`** идут **`sudo apt-get`** (пакеты **`nsis`**, **`wine64`**) на **Linux**. Multiarch **i386** намеренно не включается — на Debian с репозиториями только под amd64 (nginx, sury и т.п.) установка **wine32** часто падает с «unmet dependencies». После установки **`wine64`** в CI создаётся скрипт **`/usr/local/bin/wine`** с **`exec` по полному пути** к **`wine64`** (в job у act_runner иногда пустой/урезанный `PATH`, тогда имя `wine64` без пути не находится). electron-builder проверяет именно команду **`wine`** в `PATH`. Поэтому: - -- Нужен **Linux x86_64** (идеально **Ubuntu 22.04**), либо **WSL2** с Ubuntu 22.04 на Windows. -- Запускать раннер на «голом» Windows с меткой `ubuntu-22.04` **бессмысленно** — шаги с `apt` не выполнятся. - -### Шаг A — получить токен регистрации в Gitea - -1. Открой репозиторий с кодом (**DndGamePlayer** или как он у тебя называется). -2. **Настройки** → **Действия** → **Раннеры** → **Создать новый раннер**. -3. Выбери тип **репозитория** (repository runner), ОС **Linux**. -4. **Скопируй токен** (и при желании подсказку с URL инстанса, если она есть). Команду из мастера можно **не копировать**, если ниже удобнее готовая. - -### Шаг B — скачать act_runner (бинарник) - -Официальные сборки: **[релизы act_runner на gitea.com](https://gitea.com/gitea/act_runner/releases)**. - -1. Открой страницу релизов и посмотри **последний стабильный** тег, например **`v1.0.2`**. -2. В списке файлов скачай **`gitea-runner-ВЕРСИЯ-linux-amd64`** — это один исполняемый файл **без** расширения `.zip` (не путай с `darwin` / `arm64`, если у тебя обычный ПК/сервер Intel/AMD). - -**Прямая ссылка (подставь свою версию из релиза):** - -`https://gitea.com/gitea/act_runner/releases/download/v1.0.2/gitea-runner-1.0.2-linux-amd64` - -В URL после `download/` идёт тег с **`v`**, в имени файла версия **без `v`**. - -**Скачать с Linux/WSL одной командой** (замени `1.0.2` на актуальную версию с сайта): - -```bash -mkdir -p ~/gitea-act-runner && cd ~/gitea-act-runner -VERSION="1.0.2" -curl -fL -o act_runner "https://gitea.com/gitea/act_runner/releases/download/v${VERSION}/gitea-runner-${VERSION}-linux-amd64" -chmod +x act_runner -./act_runner --version -``` - -Если `curl` ругается на сертификат — обнови CA или скачай тот же файл через браузер и положи в папку, затем `chmod +x`. - -### Шаг C — регистрация (подставь свой токен) - -В каталоге, где лежит `act_runner`, выполни **одну** команду (токен — тот, что выдала Gitea при создании раннера): - -```bash -cd ~/gitea-act-runner - -./act_runner register --no-interactive \ - --instance "https://git.mailib.ru" \ - --token "ВСТАВЬ_СЮДА_ТОКЕН_ИЗ_МАСТЕРА_GITEA" \ - --name "dnd-release-runner" \ - --labels "ubuntu-22.04:host" -``` - -Пояснения: - -- **`--instance`** — корень твоего Gitea (**без** `/ifontosh/...`). -- **`--labels "ubuntu-22.04:host"`** — job в **`.gitea/workflows/release.yml`** имеет `runs-on: ubuntu-22.04`, а **`:host`** означает выполнение **на самой машине**, с настоящим `apt` и Wine (см. [документацию по меткам](https://docs.gitea.com/usage/actions/act-runner#labels)). Если при регистрации оставить **дефолтные** метки с **`docker://`**, шаги тоже могут сработать, но образ другой; для предсказуемости лучше **`ubuntu-22.04:host`** на чистой Ubuntu 22.04. -- После успешной регистрации в этой папке появится файл **`.runner`** — его не удаляй и не коммить. - -Если Gitea пишет ошибку регистрации — часто неверный **токен** (устарел после «сброса» в UI) или выбран не тот уровень (инстанс/организация/репозиторий). Создай раннера заново и возьми **новый** токен. - -### Шаг D — запуск вручную (для проверки) - -В той же папке: - -```bash -./act_runner daemon -``` - -Окно терминала должно остаться **открытым**. Остановка — `Ctrl+C`. Когда убедишься, что в Gitea раннер **online**, лучше перейти на **systemd** (шаг ниже). - -### Шаг D1 — systemd: автозапуск после перезагрузки (подробно) - -Идея: **systemd** сам поднимает `act_runner daemon` при загрузке системы и перезапускает процесс при падении. Рабочая директория должна быть **та же**, где лежат **`act_runner`** и зарегистрированный файл **`.runner`** (обычно `~/gitea-act-runner`). - -#### 0) Подготовка - -1. Регистрация (**шаг C**) уже выполнена, в каталоге есть **`.runner`**. -2. Узнай **точный путь** к каталогу (systemd не понимает `~`): - -```bash -cd ~/gitea-act-runner && pwd -``` - -Запомни вывод, например **`/home/ivan/gitea-act-runner`**. Имя пользователя Linux: - -```bash -whoami -``` - -Дальше в примерах: **`/home/ivan/gitea-act-runner`** и пользователь **`ivan`** — замени на свои. - -#### 1) Останови ручной запуск - -Если где-то в терминале уже крутится `./act_runner daemon` — заверши **Ctrl+C**, иначе два процесса будут мешать друг другу. - -#### 2) Создай unit-файл службы - -На **VPS / обычной Ubuntu** с правами root: - -```bash -sudo nano /etc/systemd/system/gitea-act-runner.service -``` - -Вставь текст **целиком** (подставь свои `User`, `Group`, `WorkingDirectory`, `ExecStart`): - -```ini -[Unit] -Description=Gitea Actions act_runner -Documentation=https://docs.gitea.com/usage/actions/act-runner -After=network-online.target -Wants=network-online.target - -[Service] -Type=simple -User=ivan -Group=ivan -WorkingDirectory=/home/ivan/gitea-act-runner -ExecStart=/home/ivan/gitea-act-runner/act_runner daemon -Restart=always -RestartSec=10 - -# Логи в journald (см. ниже как читать) -StandardOutput=journal -StandardError=journal - -[Install] -WantedBy=multi-user.target -``` - -Сохрани файл: в **nano** — **Ctrl+O**, Enter, **Ctrl+X**. - -Пояснения: - -- **`User` / `Group`** — под этим пользователем ты делал `register` и владеешь папкой (проверка: `ls -la ~/gitea-act-runner` — владелец должен совпадать). -- **`WorkingDirectory`** — каталог с **`.runner`**; без него раннер может не найти регистрацию. -- **`ExecStart`** — полный путь к бинарнику **`act_runner`** (тот, что скачал и сделал `chmod +x`). -- Блок **`After=network-online.target`** — старт после сети (удобно для `git`/`npm` в CI). Если вдруг зависнет старт из‑за сетевого таргета, можно временно заменить на **`After=network.target`**. - -Официальный пример с отдельным пользователем `act_runner` и `config.yaml`: [Start the runner with Systemd](https://docs.gitea.com/usage/actions/act-runner#start-the-runner-with-systemd) — у нас проще: один пользователь и без отдельного `config.yaml`, пока дефолты устраивают. - -#### 3) Включи и запусти службу - -```bash -sudo systemctl daemon-reload -sudo systemctl enable gitea-act-runner.service -sudo systemctl start gitea-act-runner.service -sudo systemctl status gitea-act-runner.service -``` - -В **`status`** должно быть **`active (running)`** зелёным. Если **`failed`** — смотри лог (шаг 5). - -Полезные команды: - -| Действие | Команда | -| --------------------- | ------------------------------------------------------------- | -| Остановить | `sudo systemctl stop gitea-act-runner` | -| Запустить снова | `sudo systemctl start gitea-act-runner` | -| Перезапуск | `sudo systemctl restart gitea-act-runner` | -| Выключить автозапуск | `sudo systemctl disable gitea-act-runner` | -| Проверка после ребута | перезагрузи машину, затем `systemctl status gitea-act-runner` | - -#### 4) Проверка в Gitea - -Как в **шаге E**: раннер снова **online** (иногда 10–30 секунд после `start`). - -#### 5) Логи, если что-то не так - -```bash -sudo journalctl -u gitea-act-runner -e --no-pager -``` - -В реальном времени: - -```bash -sudo journalctl -u gitea-act-runner -f -``` - -Типичные ошибки: неверный **`User`** (нет прав на каталог), **`WorkingDirectory`** не тот (нет **`.runner`**), бинарник не исполняемый (`chmod +x`), или старый процесс `act_runner` ещё запущен вручную. - -#### WSL2 (Ubuntu в Windows) - -Если раннер стоит **внутри WSL2**: - -1. На современных WSL **systemd уже может быть включён**. Проверка: `systemctl status` — без ошибки «running in chroot». -2. Если `systemctl` недоступен: в файле **`/etc/wsl.conf`** внутри дистрибутива добавь блок **`[boot]`** с **`systemd=true`**, затем из **PowerShell** Windows выполни **`wsl --shutdown`**, снова зайди в Ubuntu и повтори шаги 2–3. Подробнее: [документация Microsoft про systemd в WSL](https://learn.microsoft.com/en-us/windows/wsl/systemd). - -После **`wsl --shutdown`** раннер на WSL не работает, пока ты снова не откроешь WSL (это нормально для «домашнего» CI). - -### Шаг E — проверка в веб-интерфейсе - -Обнови **Настройки → Действия → Раннеры**: должен быть **1** раннер, статус **online**. У него в метках должно быть что-то вроде **`ubuntu-22.04`** (в связке с **host**). - -### Если у тебя только Windows - -Установи **WSL2** и дистрибутив **Ubuntu 22.04**, открой терминал Ubuntu и выполни шаги B–D **там** (это уже Linux). Файловую систему Windows из WSL видно как `/mnt/d/...`, но проще держать каталог раннера в домашнем каталоге Linux (`~/gitea-act-runner`). - -Официальная документация: [Gitea — Act Runner](https://docs.gitea.com/usage/actions/act-runner). - -Если раннер заводит **админ инстанса** — логика та же: раннер должен быть **online** и иметь метку, подходящую под **`runs-on`** в `release.yml` (сейчас **`ubuntu-22.04`**; при **`ubuntu-22.04:host`** в Gitea это сопоставляется с `runs-on: ubuntu-22.04`). - ---- - -## Шаг 3 — включить Actions (если ещё не включены) - -1. В том же **приватном** репозитории: **«Настройки»**. -2. Раздел **«Действия»** / **«Actions»** — включи использование Actions для этого репозитория, если Gitea это спрашивает. -3. Убедись, что в корне репозитория есть файл **`.gitea/workflows/release.yml`** (он уже в проекте `dnd_player`). - -Бегунки Gitea должны иметь доступ в интернет (для `npm ci`, `actions/checkout` и т.д.) — это настраивает админ сервера. - -### Метки `runs-on` (если раннер уже есть, но job не берётся) - -- В списке раннеров посмотри **метки** у online-раннера. -- В **`.gitea/workflows/release.yml`** в `runs-on:` должна совпадать **именно метка `ubuntu-22.04`** (Gitea сопоставляет её и с **`ubuntu-22.04:host`**, и с **`ubuntu-22.04:docker://...`** — см. [Labels](https://docs.gitea.com/usage/actions/act-runner#labels) в документации act_runner). -- Если при регистрации указал только **`self-hosted`** — добавь **`ubuntu-22.04:host`** (или поменяй `runs-on` в workflow на твои метки и закоммить). - -Сборка **Windows (NSIS)** и **Linux (AppImage x64 + arm64)** в CI идёт **на одном** `ubuntu-22.04`: NSIS + `wine64` для Win, `qemu-user-static` для кросс-сборки arm64 AppImage на amd64 (см. `release.yml`). **macOS** в этом job не собирается (ручная выкладка или отдельный раннер — см. `docs/MANUAL_MAC_UPDATE_UPLOAD.md`). - ---- - -## Linux: AppImage и автообновление - -- В ветке **`updates`** рядом с Windows лежат **`latest-linux.yml`** и файлы **`*.AppImage`** (x64 и arm64). Скрипт **`scripts/sync-update-feed.mjs`** делает **merge-копирование**: файлы других ОС в репозитории **не удаляются**, обновляются только имена, пришедшие из текущего CI-прогона. -- **Базовый дистрибутив для бинарников:** сборка на **Ubuntu 22.04 (glibc 2.35)** — совместимость с «максимумом» настольных дистрибутивов с glibc не старее целевого; **Alpine/musl** без отдельной сборки не гарантируется. -- **Запуск AppImage:** на части систем нужен **FUSE** (например `libfuse2` для старых форматов / документация дистрибутива). Подпись пакетов в первом варианте **не** используется (как договорённость по проекту). -- Правила **electron-updater** в приложении те же: упакованная сборка и **активная лицензия** (`installAutoUpdater.ts`). -- **Дифференциальное обновление** (запросы с несколькими HTTP `Range` по blockmap) на **Gitea raw** за nginx часто даёт **`400 Bad Request`** (`content-length: 18` — короткий текст ошибки); updater переходит на **полную** загрузку — обновление всё равно доходит. В коде по умолчанию **`disableDifferentialDownload: true`**, чтобы не делать лишний шаг (меньше шума в логе). Включить дифф снова: переменная **`DND_UPDATE_ENABLE_DIFFERENTIAL=1`** при запуске приложения — имеет смысл только если на сервере разрешили корректные Range / multi-range для raw. -- Сообщения вида **`duplicated in blockmap`** в консоли — предупреждение electron-updater, на работоспособность обычно не влияют. - ---- - -## Шаг 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`**. - ---- - -## Размер репозитория `DndGamePlayerUpdates` (почему ~4 GiB и как держать меньше) - -### Почему место не возвращается само - -При **`DND_UPDATES_SQUASH_HISTORY=1`** и **`git push --force-with-lease`** на ветке **`updates`** в истории остаётся по сути **один актуальный коммит**, но на **диске сервера** Git до **сборки мусора** продолжает хранить **недостижимые** объекты: старые коммиты, прерванные push, временные ветки **`updates-upload-*`**, старые pack-файлы. Пока не выполнен **`git gc --prune`**, размер каталога **`.git`** на Gitea может быть **сильно больше**, чем «один релиз файлов» в веб-интерфейсе. - -### Сразу освободить место (один раз на сервере) - -На машине Gitea найдите **bare**-репозиторий (типичный путь: `…/gitea-repositories/<владелец>/dndgameplayerupdates.git`), от имени пользователя с правами на каталог: - -```bash -cd /path/to/DndGamePlayerUpdates.git -git gc --prune=now -``` - -При очень большом накоплении мусора иногда используют **`--aggressive`** (дольше и тяжелее для CPU); чаще достаточно команды **без** него. После GC размер на диске должен приблизиться к сумме **текущих** файлов в последнем коммите. - -В веб-интерфейсе Gitea смотрите раздел **администрирования** / **обслуживание** / **garbage collection** (названия зависят от версии): там может быть глобальный GC по всем репозиториям. - -### Чтобы после каждого релиза снова не раздувалось - -В **`app.ini`** Gitea включите **периодический GC репозиториев** (секция и ключи зависят от версии; ориентир — задача **`git_gc_repos`** в документации [config cheat sheet](https://docs.gitea.com/administration/config-cheat-sheet)), например раз в **24 ч** или чаще, если релизы частые. - -Уже включено в вашем пайплайне по смыслу: **squash** + **prune** старых имён установщиков — это уменьшает **набор файлов** в новом коммите; **физическое** освобождение на диске — задача **GC на сервере**. - -### Можно ли «всегда не больше 1,5 GiB» - -**Жёстко задать потолок Git не умеет.** Реальный минимум на диске ≈ размер **текущих** артефактов в ветке (два AppImage + NSIS + zip + blockmap + mac и т.д.) плюс служебные pack’и. Если один релиз по сумме бинарников уже **> 1,5 GiB**, репозиторий физически не уместится в лимит без **урезания артефактов** (например не выкладывать **`win.zip`**, если он не нужен updater’у) или без **выноса больших файлов из Git**. - -Надёжный способ держать репо **маленьким постоянно**: в **`DndGamePlayerUpdates`** хранить только **`latest*.yml`** (и при необходимости подписи), а **`.exe` / `.AppImage` / `.zip`** выкладывать в **Gitea Releases**, **объектное хранилище** или **статический хост**, а в yml подставлять **прямые URL** туда. Тогда потребуется доработка **CI** и, при смене хоста, **`build.publish.url`** / секреты — это отдельная схема доставки, не только `git gc`. - ---- - -## Если 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 ассистент только правит файлы в рабочей копии. +Раньше артефакты пушились в публичный Git **`DndGamePlayerUpdates`**, ветка `updates`, URL вида +`https://git.mailib.ru/.../DndGamePlayerUpdates/raw/branch/updates/`. +Эта схема приводила к раздуванию репозитория, конфликтам merge, ENOSPC на раннере и HTTP 500 при `git push`. Она **снята с поддержки**. diff --git a/docs/MANUAL_MAC_UPDATE_UPLOAD.md b/docs/MANUAL_MAC_UPDATE_UPLOAD.md index 161bafe..67d6c93 100644 --- a/docs/MANUAL_MAC_UPDATE_UPLOAD.md +++ b/docs/MANUAL_MAC_UPDATE_UPLOAD.md @@ -1,159 +1,38 @@ -# Ручная выкладка macOS-обновлений в публичный feed +# Ручная выкладка macOS-обновлений (TTRPG Player) -Инструкция для случая, когда **сборка делается на вашем Mac вручную**, а файлы для `electron-updater` нужно **вручную** положить в публичный репозиторий обновлений. +До настройки VPS (фаза 2) mac-сборка выполняется **локально на Mac**. Артефакты нужно будет положить на тот же HTTPS-origin, что и Win/Linux (`build.publish.url`). -Общая схема проекта: приватный репозиторий с кодом, публичный **`DndGamePlayerUpdates`**, ветка **`updates`**, URL feed как в `package.json`: - -`https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/` - ---- - -## 1. Что собрать на Mac - -В каталоге проекта `dnd_player`: +## Сборка на Mac ```bash -cd /путь/к/dnd_player npm ci npm run build +npm run pack:mac ``` -Сборка установщиков только под macOS (без публикации в сеть, только файлы в `release/`): +В `release/` появятся, например: + +- `TTRPGPlayer--x64.dmg` (и arm64 при универсальной сборке) +- `latest-mac.yml` (если включена публикация generic при сборке) + +Для локальной проверки updater можно временно указать URL: ```bash npx electron-builder --mac --publish never \ --config.publish.provider=generic \ - --config.publish.url="https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/" + --config.publish.url="https://YOUR-UPDATE-HOST/" ``` -**Важно:** значение `--config.publish.url=...` должно совпадать с `package.json` → `build.publish.url` (**со слэшем в конце**). Так внутри приложения и в `latest-mac.yml` будет корректный базовый URL для скачивания. +(подставьте реальный origin со слэшем в конце) -После сборки откройте папку **`release/`** в корне проекта. Там должны быть, среди прочего: +## Фаза 2: выкладка на статический хост -- **`latest-mac.yml`** — обязателен для `electron-updater` на Mac; -- **`.dmg`** и/или **`.zip`** — то, на что ссылается `latest-mac.yml`; -- при необходимости **`.blockmap`** (если electron-builder их создал) — заливайте с теми же именами, что указаны в `latest-mac.yml`. +1. Скопировать на сервер обновлений: + - `latest-mac.yml` + - `.dmg` / `.zip` с именами, на которые ссылается yml +2. Проверить в браузере: `https://YOUR-UPDATE-HOST/latest-mac.yml` +3. В установленном приложении: **Настройки → Проверить обновления** (нужна активная лицензия). -Имена файлов зависят от версии и архитектур (в конфиге dmg и zip для **x64** и **arm64**). На Apple Silicon без дополнительных шагов часто получается только **arm64**; для отдельного Intel-сборщика нужна своя машина или параметры arch — ориентируйтесь на фактический список файлов в `release/`. +## Устаревшая схема (Git feed) ---- - -## 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). +Раньше файлы коммитили в репозиторий **`DndGamePlayerUpdates`**, ветка `updates`. Этот способ **больше не используется** — репозиторий можно удалить на Gitea. diff --git a/docs/licensing-spec.md b/docs/licensing-spec.md index ae38bd4..8e31d6b 100644 --- a/docs/licensing-spec.md +++ b/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) diff --git a/package-lock.json b/package-lock.json index c8c663c..0947b91 100644 --- a/package-lock.json +++ b/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", diff --git a/package.json b/package.json index f7bd426..ac9a671 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { - "name": "DndGamePlayer", + "name": "TTRPGPlayer", "version": "1.0.15", - "description": "DNDGamePlayer — редактор и проигрыватель игр", + "description": "TTRPG Player — редактор и проигрыватель НРИ", "main": "dist/main/index.cjs", "scripts": { "dev": "node scripts/dev.mjs", @@ -70,9 +70,9 @@ "yazl": "^3.3.1" }, "build": { - "appId": "com.dndplayer.app", - "productName": "DNDGamePlayer", - "copyright": "Copyright © DNDGamePlayer", + "appId": "com.ttrpgplayer.app", + "productName": "TTRPGPlayer", + "copyright": "Copyright © TTRPGPlayer", "directories": { "output": "release", "buildResources": "build" @@ -144,8 +144,8 @@ } ], "category": "Game", - "maintainer": "DNDGamePlayer", - "synopsis": "DNDGamePlayer — редактор и проигрыватель игр", + "maintainer": "TTRPGPlayer", + "synopsis": "TTRPG Player — tabletop RPG editor and player", "icon": "build/icon.png" }, "appImage": { @@ -159,7 +159,7 @@ }, "publish": { "provider": "generic", - "url": "https://git.mailib.ru/ifontosh/DndGamePlayerUpdates/raw/branch/updates/" + "url": "https://updates.invalid.ttrpg/" } } } diff --git a/scripts/release-win-prep.mjs b/scripts/release-win-prep.mjs index cf76e10..9eb2afb 100644 --- a/scripts/release-win-prep.mjs +++ b/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.', ); } diff --git a/scripts/sync-update-feed.mjs b/scripts/sync-update-feed.mjs deleted file mode 100644 index bfeee77..0000000 --- a/scripts/sync-update-feed.mjs +++ /dev/null @@ -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();