Scaffold overlay для преднастроенного RustDesk-клиента

Тонкая обвязка поверх rustdesk@1.4.9: preconfigure.sh патчит
RENDEZVOUS_SERVERS+RS_PUB_KEY в hbb_common, build-windows.ps1 —
локальный оркестратор сборки. Значения сервера/ключа не в репо
(config/server.env в .gitignore, в CI — gitea secrets).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

scripts/build-windows.ps1

@@ -0,0 +1,95 @@
+<#
+  Локальная сборка преднастроенного RustDesk-клиента под Windows (GUSIK-PC).
+  Делает: клон rustdesk@пин -> preconfigure (вшить сервер+ключ) -> python build.py --flutter -> dist/.
+  Тулчейн (Rust 1.75 / LLVM 15 / Flutter 3.24.5 / vcpkg@пин) должен быть уже поднят —
+  скрипт делает preflight-проверку и подсказывает, чего не хватает.
+
+  Запуск:  pwsh -File scripts\build-windows.ps1
+  Опции:   -Clean  (снести клон и склонировать заново)
+#>
+[CmdletBinding()]
+param(
+  [switch]$Clean,
+  [switch]$SkipBuild   # только клон+preconfigure, без компиляции (для отладки)
+)
+$ErrorActionPreference = 'Stop'
+$root = Split-Path -Parent $PSScriptRoot            # корень overlay-репо
+$src  = Join-Path $root 'rustdesk'                  # клон апстрима
+$dist = Join-Path $root 'dist'
+
+# --- читаем пины ---
+$pins = @{}
+Get-Content (Join-Path $root 'upstream.txt') | Where-Object { $_ -match '^\s*[A-Z]' } | ForEach-Object {
+  $k,$v = $_ -split '=',2; $pins[$k.Trim()] = $v.Trim()
+}
+$TAG   = $pins['RUSTDESK_TAG']
+$REPO  = $pins['RUSTDESK_REPO']
+Write-Host "== RustDesk custom build == tag=$TAG" -ForegroundColor Cyan
+
+# --- загрузка config/server.env ---
+$envFile = Join-Path $root 'config\server.env'
+if (-not (Test-Path $envFile)) {
+  throw "Нет $envFile. Скопируй config\server.env.example -> config\server.env и заполни RUSTDESK_SERVER/RUSTDESK_PUB_KEY."
+}
+Get-Content $envFile | Where-Object { $_ -match '^\s*[A-Z].*=' } | ForEach-Object {
+  $k,$v = $_ -split '=',2
+  Set-Item -Path "Env:$($k.Trim())" -Value $v.Trim()
+}
+if (-not $env:RUSTDESK_SERVER -or -not $env:RUSTDESK_PUB_KEY) {
+  throw "В config\server.env не заданы RUSTDESK_SERVER и/или RUSTDESK_PUB_KEY."
+}
+
+# --- preflight тулчейна ---
+function Need($name, $test, $hint) {
+  if (-not (& $test)) { Write-Host "  [нет] $name — $hint" -ForegroundColor Yellow; return $false }
+  Write-Host "  [ok]  $name" -ForegroundColor Green; return $true
+}
+Write-Host "Preflight тулчейна:" -ForegroundColor Cyan
+$ok = $true
+$ok = (Need 'git'     { Get-Command git -EA SilentlyContinue }     'установи Git for Windows') -and $ok
+$ok = (Need 'bash'    { Get-Command bash -EA SilentlyContinue }    'нужен git-bash для preconfigure.sh') -and $ok
+$ok = (Need 'python'  { Get-Command python -EA SilentlyContinue }  'нужен Python 3 для build.py') -and $ok
+$ok = (Need 'rustup'  { Get-Command rustup -EA SilentlyContinue }  'установи rustup') -and $ok
+$ok = (Need 'flutter' { Get-Command flutter -EA SilentlyContinue } "Flutter $($pins['FLUTTER_VERSION']) stable в PATH") -and $ok
+$ok = (Need 'vcpkg'   { $env:VCPKG_ROOT -and (Test-Path (Join-Path $env:VCPKG_ROOT 'vcpkg.exe')) } "склонируй vcpkg@$($pins['VCPKG_COMMIT_ID']), задай VCPKG_ROOT") -and $ok
+$ok = (Need 'LLVM'    { $env:LIBCLANG_PATH -and (Test-Path $env:LIBCLANG_PATH) } "LLVM $($pins['LLVM_VERSION']), задай LIBCLANG_PATH") -and $ok
+if (-not $ok) { throw "Тулчейн неполный — см. docs\CODEMAP.md (раздел 'Windows toolchain')." }
+
+# --- клон / обновление до пина ---
+if ($Clean -and (Test-Path $src)) { Remove-Item -Recurse -Force $src }
+if (-not (Test-Path $src)) {
+  Write-Host "Клонирую rustdesk@$TAG ..." -ForegroundColor Cyan
+  git clone --branch $TAG --depth 1 --recurse-submodules --shallow-submodules $REPO $src
+} else {
+  Write-Host "Клон уже есть — сбрасываю патчи до чистого $TAG ..." -ForegroundColor Cyan
+  git -C $src checkout -- .
+  git -C $src submodule foreach --recursive 'git checkout -- .'
+}
+
+# зафиксировать Rust 1.75 для этого дерева
+Push-Location $src
+rustup override set $pins['RUST_VERSION'] | Out-Null
+Pop-Location
+
+# --- preconfigure: вшить сервер+ключ ---
+Write-Host "Preconfigure (вшиваю сервер+ключ)..." -ForegroundColor Cyan
+bash "$root/scripts/preconfigure.sh" "$src"
+
+if ($SkipBuild) { Write-Host "SkipBuild — остановился после preconfigure." -ForegroundColor Yellow; return }
+
+# --- сборка ---
+Write-Host "Сборка: python build.py --flutter (первый раз долго: vcpkg ffmpeg/aom)..." -ForegroundColor Cyan
+Push-Location $src
+python build.py --flutter
+Pop-Location
+
+# --- собрать артефакт ---
+New-Item -ItemType Directory -Force $dist | Out-Null
+$exe = Get-ChildItem -Path $src -Recurse -Filter 'rustdesk*.exe' -EA SilentlyContinue |
+       Where-Object { $_.FullName -match 'Release|portable' } | Select-Object -First 1
+if ($exe) {
+  Copy-Item $exe.FullName (Join-Path $dist $exe.Name) -Force
+  Write-Host "Готово: $(Join-Path $dist $exe.Name)" -ForegroundColor Green
+} else {
+  Write-Host "Сборка завершилась, но .exe не найден автоматически — глянь $src\build и $src\flutter\build." -ForegroundColor Yellow
+}

scripts/preconfigure.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Вшивает адрес сервера и публичный ключ в клон RustDesk перед сборкой.
+# Патчит две константы в сабмодуле hbb_common:
+#   pub const RENDEZVOUS_SERVERS: &[&str] = &["rs-ny.rustdesk.com"];
+#   pub const RS_PUB_KEY: &str = "OeVu...";
+#
+# Значения берутся из окружения (см. config/server.env.example):
+#   RUSTDESK_SERVER   — хост(ы) hbbs. Несколько — через запятую. Порт по умолчанию 21116,
+#                       нестандартный указывать как host:port.
+#   RUSTDESK_PUB_KEY  — публичный ключ сервера (содержимое id_ed25519.pub, base64).
+#   RUSTDESK_API_SERVER — (опц.) URL API-сервера (RustDesk Server Pro). Пусто — пропустить.
+#
+# Использование:  RUSTDESK_SERVER=... RUSTDESK_PUB_KEY=... ./scripts/preconfigure.sh <путь-к-клону-rustdesk>
+set -euo pipefail
+
+SRC="${1:?укажи путь к клону rustdesk первым аргументом}"
+CFG="$SRC/libs/hbb_common/src/config.rs"
+
+[ -f "$CFG" ] || { echo "ОШИБКА: не найден $CFG — сабмодуль hbb_common не инициализирован?" >&2; exit 1; }
+: "${RUSTDESK_SERVER:?не задан RUSTDESK_SERVER}"
+: "${RUSTDESK_PUB_KEY:?не задан RUSTDESK_PUB_KEY}"
+
+# Собираем Rust-массив &["a", "b"] из запятой-разделённого списка серверов.
+IFS=',' read -ra SRV <<< "$RUSTDESK_SERVER"
+ARR=""
+for s in "${SRV[@]}"; do
+  s="$(echo -n "$s" | tr -d '[:space:]')"
+  [ -n "$s" ] && ARR="${ARR}\"${s}\", "
+done
+ARR="&[${ARR%, }]"
+
+# Экранируем спецсимволы sed-замены (& | \) в подставляемых значениях.
+esc() { printf '%s' "$1" | sed -e 's/[\\&|]/\\&/g'; }
+ARR_ESC="$(esc "$ARR")"
+KEY_ESC="$(esc "$RUSTDESK_PUB_KEY")"
+
+# Патч RENDEZVOUS_SERVERS
+sed -i -E "s|^pub const RENDEZVOUS_SERVERS: &\[&str\] = .*;|pub const RENDEZVOUS_SERVERS: \&[\&str] = ${ARR_ESC};|" "$CFG"
+# Патч RS_PUB_KEY
+sed -i -E "s|^pub const RS_PUB_KEY: &str = .*;|pub const RS_PUB_KEY: \&str = \"${KEY_ESC}\";|" "$CFG"
+
+# Проверяем, что патч применился (значения не печатаем целиком — только факт).
+grep -q "^pub const RENDEZVOUS_SERVERS: &\[&str\] = &\[\"" "$CFG" || { echo "ОШИБКА: не удалось пропатчить RENDEZVOUS_SERVERS" >&2; exit 1; }
+if grep -q "OeVuKk5nlHiXp" "$CFG"; then
+  echo "ОШИБКА: RS_PUB_KEY остался дефолтным RustDesk" >&2; exit 1
+fi
+
+echo "[preconfigure] RENDEZVOUS_SERVERS -> ${#SRV[@]} сервер(ов), RS_PUB_KEY вшит."
+
+# Опциональный API-сервер (RustDesk Server Pro). По умолчанию у hbbs/hbbr его нет.
+if [ -n "${RUSTDESK_API_SERVER:-}" ]; then
+  # В 1.4.9 отдельной const API_SERVER нет; дефолт задаётся через overrideConfig/filename.
+  # Оставляем маркер для ручной доработки, если понадобится Pro-API.
+  echo "[preconfigure] RUSTDESK_API_SERVER задан ($RUSTDESK_API_SERVER) — вшивание API требует доп. патча (см. docs/CODEMAP.md)."
+fi