Project Chimera
Меню

Исходники

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 не снимают.
17set -euo pipefail
18
19out="${1:-/tmp/chl-ui-matrix}"
20gui="${GUI:-$HOME/.cache/chimera-launcher-dev/target/debug/chimera-launcher}"
21here="$(cd "$(dirname "$0")" && pwd)"
22game="${GAME:-A Plague Tale: Requiem}"
23read -ra pages <<< "${PAGES:-library stats media stores accounts downloads settings wine appearance gamepad launcher backups data-root doctor updates about}"
24
25rm -rf "$out"; mkdir -p "$out/shots"
26tmp="$(mktemp -d)"; trap 'rm -rf "$tmp"' EXIT
27stamp="$tmp/stamp"; touch "$stamp"
28live=("$HOME/.config/chimera-launcher" "$HOME/.local/share/chimera-launcher" "$HOME/.local/state/chimera-launcher" "$HOME/.cache/chimera-launcher")
29
30# Общий кэш один на все варианты: обложки только читаются.
31mkdir -p "$tmp/cache"
32rsync -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…]
37make_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
67shot() { # <вариант>[:<имя снимка>] <ширина> <высота> <страница> [доп. переменные]
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
94make_env base teal 1
95make_env sysfont150 teal 1.5
96make_env font150 teal 1 'font_scale = 1.5'
97make_env amber amber 1
98make_env graphite graphite 1
99make_env extremes teal 1 'density = "compact"' 'corners = "soft"' 'background_dim = 0.6' \
100 'background_blur = 16' 'captions = "always"' 'dim_uninstalled = false'
101
102list="$out/list.txt"; : > "$list"
103for 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"
109done
110for 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"
114done
115
116changed=$(find "${live[@]}" -newer "$stamp" -type f 2>/dev/null | grep -v -e '/app/' -e '/gog-downloads/' -e '/credentials/' || true)
117if [ -n "$changed" ]; then
118 echo "ВНИМАНИЕ: за время прогона изменились живые файлы (их мог записать и открытый лаунчер или другая сессия):"
119 echo "$changed"
120fi
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"
137echo "готово: $out/index.html ($(wc -l < "$list") снимков)"
138sort -t= -k2 -nr "$out/summary.txt" | head -15
139