139 строк · 10 КиБ
tools/ui-matrix/run.sh
| 1 | #!/usr/bin/env bash |
| 2 | # Матрица проверки интерфейса (docs/UI-DESIGN-SPEC.md, п. 24): снимки страниц |
| 3 | # в нескольких режимах, оценка контраста текста и одна HTML-страница с итогом. |
| 4 | # |
| 5 | # tools/ui-matrix/run.sh [каталог-результата] |
| 6 | # |
| 7 | # Все четыре каталога XDG (CONFIG/DATA/STATE/CACHE) указывают на копии во |
| 8 | # временном каталоге: окно в режиме --screenshot пишет как обычное |
| 9 | # (appearance.toml, кэш обложек), а живые файлы трогать нельзя. В копию не |
| 10 | # идут credentials/ (токены магазинов), данные WebKit (store-browser/, |
| 11 | # storage/, mediakeys/ — там cookie входа в витрины), app/ (установленный |
| 12 | # лаунчер) и |
| 13 | # крупные кэши (загрузки GOG, WebKit, витрины). Steam только читается из |
| 14 | # ~/.local/share/Steam. После прогона скрипт проверяет, что живые каталоги |
| 15 | # не изменились. Окна — NON_UNIQUE: открытый лаунчер не трогают, игр не |
| 16 | # запускают, полноэкранный Big Picture не снимают. |
| 17 | set -euo pipefail |
| 18 | |
| 19 | out="${1:-/tmp/chl-ui-matrix}" |
| 20 | gui="${GUI:-$HOME/.cache/chimera-launcher-dev/target/debug/chimera-launcher}" |
| 21 | here="$(cd "$(dirname "$0")" && pwd)" |
| 22 | game="${GAME:-A Plague Tale: Requiem}" |
| 23 | read -ra pages <<< "${PAGES:-library stats media stores accounts downloads settings wine appearance gamepad launcher backups data-root doctor updates about}" |
| 24 | |
| 25 | rm -rf "$out"; mkdir -p "$out/shots" |
| 26 | tmp="$(mktemp -d)"; trap 'rm -rf "$tmp"' EXIT |
| 27 | stamp="$tmp/stamp"; touch "$stamp" |
| 28 | live=("$HOME/.config/chimera-launcher" "$HOME/.local/share/chimera-launcher" "$HOME/.local/state/chimera-launcher" "$HOME/.cache/chimera-launcher") |
| 29 | |
| 30 | # Общий кэш один на все варианты: обложки только читаются. |
| 31 | mkdir -p "$tmp/cache" |
| 32 | rsync -a --exclude gog-downloads --exclude WebKitCache --exclude store-browser \ |
| 33 | --exclude redist --exclude kb --exclude wine-downloads "$HOME/.cache/chimera-launcher" "$tmp/cache/" |
| 34 | |
| 35 | # Копия настроек одного варианта. |
| 36 | # make_env <имя> <палитра> <системный шрифт ×> [строки для appearance.toml…] |
| 37 | make_env() { |
| 38 | local name=$1 theme=$2 fscale=$3 root="$tmp/$1"; shift 3 |
| 39 | mkdir -p "$root/config" "$root/data" "$root/state" |
| 40 | rsync -a --exclude credentials "$HOME/.config/chimera-launcher" "$root/config/" |
| 41 | rsync -a --exclude app --exclude store-browser --exclude storage --exclude mediakeys \ |
| 42 | "$HOME/.local/share/chimera-launcher" "$root/data/" |
| 43 | if [ -d "$HOME/.local/state/chimera-launcher" ]; then rsync -a "$HOME/.local/state/chimera-launcher" "$root/state/"; fi |
| 44 | local a="$root/config/chimera-launcher/appearance.toml" line |
| 45 | sed -i "s/^theme = .*/theme = \"$theme\"/" "$a" |
| 46 | for line in "$@"; do |
| 47 | sed -i "/^${line%% =*} =/d" "$a"; echo "$line" >> "$a" |
| 48 | done |
| 49 | # Системные настройки GTK — копия живых (тема значков), меняется только |
| 50 | # размер шрифта. Читаются они лишь при GDK_DEBUG=no-portals (см. shot); |
| 51 | # gtk-xft-dpi из копии убран: через портал он не действует — масштаб |
| 52 | # экрана даёт композитор, — а без портала умножил бы всё ещё раз. |
| 53 | # Значки из ~/.local/share/icons нужны и копии: XDG_DATA_HOME подменён, |
| 54 | # а тема Papirus лежит именно там. |
| 55 | mkdir -p "$root/config/gtk-4.0" |
| 56 | local ini="$root/config/gtk-4.0/settings.ini" font |
| 57 | grep -v '^gtk-xft-dpi' "$HOME/.config/gtk-4.0/settings.ini" > "$ini" 2>/dev/null \ |
| 58 | || printf '[Settings]\ngtk-font-name=Cantarell, 11\n' > "$ini" |
| 59 | font=$(grep -oP '^gtk-font-name=\K.*' "$ini") |
| 60 | local fam=${font%%,*} size=${font##*[ ,]} |
| 61 | size=$(python3 -c "print(round($size*$fscale))") |
| 62 | sed -i "s/^gtk-font-name=.*/gtk-font-name=$fam, $size/" "$ini" |
| 63 | if [ -d "$HOME/.local/share/icons" ]; then ln -sfn "$HOME/.local/share/icons" "$root/data/icons"; fi |
| 64 | if [ -d "$HOME/.local/share/fonts" ]; then ln -sfn "$HOME/.local/share/fonts" "$root/data/fonts"; fi |
| 65 | } |
| 66 | |
| 67 | shot() { # <вариант>[:<имя снимка>] <ширина> <высота> <страница> [доп. переменные] |
| 68 | local v=${1%%:*} tag=${1##*:} w=$2 h=$3 p=$4; shift 4 |
| 69 | local root="$tmp/$v" file="$out/shots/$tag-$p-$w.png" args=(--page "$p") |
| 70 | [ "$p" = game ] && args=(--page library --game "$game") |
| 71 | # Витрины магазинов — WebKit: его процессы поднимаются секунд пять, и |
| 72 | # раньше окно ещё ничего не нарисовало («пустой кадр»). Но и с задержкой |
| 73 | # снимок выходит примерно в каждом третьем запуске, от состояния копии |
| 74 | # (кэш, cookie) это не зависит — проверено. Причина не найдена; пропуск |
| 75 | # «Магазинов» в матрице — известное ограничение, а не поломка страницы. |
| 76 | local delay=3500; [ "$p" = stores ] && delay=8000 |
| 77 | # no-portals: иначе шрифт приходит от портала рабочего стола, и |
| 78 | # settings.ini из копии не действует — вариант «системный шрифт 150%» |
| 79 | # выходил неотличимым от обычного. С ним и без масштаба вид совпадает с |
| 80 | # обычным запуском до пикселя (проверено на боковой панели). |
| 81 | env GDK_DEBUG=no-portals XDG_CONFIG_HOME="$root/config" XDG_DATA_HOME="$root/data" XDG_STATE_HOME="$root/state" \ |
| 82 | XDG_CACHE_HOME="$tmp/cache" CHL_SCREENSHOT_DELAY="$delay" CHL_WINDOW_WIDTH="$w" CHL_WINDOW_HEIGHT="$h" "$@" \ |
| 83 | timeout 40 "$gui" "${args[@]}" --screenshot "$file" >/dev/null 2>&1 || true |
| 84 | # Второй заход с двойной задержкой: WebKit и первый запуск GStreamer |
| 85 | # иногда не успевают, и снимок выходит «пустым кадром». |
| 86 | if [ ! -s "$file" ]; then |
| 87 | env GDK_DEBUG=no-portals XDG_CONFIG_HOME="$root/config" XDG_DATA_HOME="$root/data" XDG_STATE_HOME="$root/state" \ |
| 88 | XDG_CACHE_HOME="$tmp/cache" CHL_SCREENSHOT_DELAY="$((delay * 2))" CHL_WINDOW_WIDTH="$w" CHL_WINDOW_HEIGHT="$h" "$@" \ |
| 89 | timeout 60 "$gui" "${args[@]}" --screenshot "$file" >/dev/null 2>&1 || true |
| 90 | fi |
| 91 | if [ -s "$file" ]; then echo "$file"; else echo "нет снимка: $v $p $w" >&2; fi |
| 92 | } |
| 93 | |
| 94 | make_env base teal 1 |
| 95 | make_env sysfont150 teal 1.5 |
| 96 | make_env font150 teal 1 'font_scale = 1.5' |
| 97 | make_env amber amber 1 |
| 98 | make_env graphite graphite 1 |
| 99 | make_env extremes teal 1 'density = "compact"' 'corners = "soft"' 'background_dim = 0.6' \ |
| 100 | 'background_blur = 16' 'captions = "always"' 'dim_uninstalled = false' |
| 101 | |
| 102 | list="$out/list.txt"; : > "$list" |
| 103 | for p in "${pages[@]}" game; do |
| 104 | shot base 1100 720 "$p" >> "$list" |
| 105 | shot base 1600 1000 "$p" >> "$list" |
| 106 | shot font150 1100 720 "$p" >> "$list" |
| 107 | shot sysfont150 1100 720 "$p" >> "$list" |
| 108 | shot base:hc 1100 720 "$p" ADW_DEBUG_HIGH_CONTRAST=1 >> "$list" |
| 109 | done |
| 110 | for p in ${PALETTE_PAGES:-library game settings appearance}; do |
| 111 | shot amber 1100 720 "$p" >> "$list" |
| 112 | shot graphite 1100 720 "$p" >> "$list" |
| 113 | shot extremes 1100 720 "$p" >> "$list" |
| 114 | done |
| 115 | |
| 116 | changed=$(find "${live[@]}" -newer "$stamp" -type f 2>/dev/null | grep -v -e '/app/' -e '/gog-downloads/' -e '/credentials/' || true) |
| 117 | if [ -n "$changed" ]; then |
| 118 | echo "ВНИМАНИЕ: за время прогона изменились живые файлы (их мог записать и открытый лаунчер или другая сессия):" |
| 119 | echo "$changed" |
| 120 | fi |
| 121 | |
| 122 | # Контраст и сводка. |
| 123 | { |
| 124 | echo '<!doctype html><meta charset="utf-8"><title>Матрица интерфейса</title>' |
| 125 | echo '<style>body{background:#161618;color:#eee;font:14px system-ui;margin:24px}figure{display:inline-block;margin:0 12px 24px 0;vertical-align:top;width:560px}img{width:560px;border:1px solid #333}.bad{color:#ff6b6b}.ok{color:#6bd6a8}</style>' |
| 126 | echo "<h1>Матрица интерфейса</h1><p>$(date '+%F %T') · красным обведены слова ниже порога WCAG (4.5:1, крупный текст 3:1)</p>" |
| 127 | while read -r f; do |
| 128 | m="${f%.png}-marked.png" |
| 129 | j=$(python3 "$here/contrast.py" "$f" "$m" 2>/dev/null || echo '{"words":0,"fails":0,"worst":null}') |
| 130 | fails=$(python3 -c "import json,sys;print(json.loads(sys.argv[1])['fails'])" "$j") |
| 131 | worst=$(python3 -c "import json,sys;w=json.loads(sys.argv[1])['worst'];print(w['ratio'] if w else '—')" "$j") |
| 132 | cls=ok; [ "$fails" -gt 0 ] && cls=bad |
| 133 | echo "<figure><a href=\"shots/$(basename "$m")\"><img src=\"shots/$(basename "$m")\" loading=lazy></a><figcaption>$(basename "$f" .png) · <span class=$cls>ниже порога: $fails</span> · худшее $worst:1</figcaption></figure>" |
| 134 | echo "$(basename "$f" .png) fails=$fails worst=$worst" >> "$out/summary.txt" |
| 135 | done < "$list" |
| 136 | } > "$out/index.html" |
| 137 | echo "готово: $out/index.html ($(wc -l < "$list") снимков)" |
| 138 | sort -t= -k2 -nr "$out/summary.txt" | head -15 |
| 139 |