Linux: session-native GDK/WebKit mitigations and in-page browse scroll (#731)

* feat(linux): session GDK defaults, nvidia-quirk, optional x11-legacy wrap Ship PSYSONIC_ALLOW_NATIVE_GDK from Nix/AUR instead of pinning WEBKIT_DISABLE_* and GDK x11. Add flake psysonic-x11-legacy for the old wrap; alias gdk-session to psysonic. Startup uses webkit2gtk-nvidia-quirk and Wayland-aware compositing; refresh Help (a45) and nixos-install docs. * fix(linux): session GDK and nvidia-quirk only; drop wrapper env heuristics Remove PSYSONIC_ALLOW_NATIVE_GDK and devShell GDK/WEBKIT exports; stop synthesizing GDK/WebKit vars in main.rs. Update Nix/AUR wrappers, install docs, CHANGELOG, and help FAQ with practical user-facing workarounds. * fix(linux): X11-pinned GDK uses DMABUF quirk path, not Wayland explicit-sync When GDK_BACKEND is forced to x11 on a wayland user session, webkit2gtk-nvidia-quirk would still apply __NV_DISABLE_EXPLICIT_SYNC and gray out the webview. Map that case to WEBKIT_DISABLE_DMABUF_RENDERER like native X11. * fix(ui): stabilize WebKitGTK/Wayland hover paint for nav and media cards Sidebar nav links avoid transition:all and promote icons with translateZ(0). Artist rows and album/artist/song cards use compositing hints; card shadows and borders no longer interpolate so cover zoom can stay smooth without jitter. * fix(ui): isolate artist/album card text and cover paint on WebKitGTK Promote cover blocks with contain/paint and text stacks with translateZ(0); use artist-card-info on the artists grid for the same layout as other cards. * feat(artists): in-page overlay scroll and locked main viewport Move list/grid into an inner OverlayScrollArea, stop sticky toolbar from owning the route scroll, align the rail with the main panel edge, and skip the main-route overlay thumb when the viewport cannot scroll vertically. * feat(browse): extend in-page overlay scroll to more library routes Reuse the locked main viewport pattern from Artists for Albums, Composers, Lossless albums, and New releases; wire VirtualCardGrid and scroll chrome to the matching in-page viewport ids. * fix(linux): improve Wayland GPU compositing text clarity in WebKitGTK Use on-demand hardware acceleration on main and mini webviews when the session is Wayland and compositing stays on; gate subpixel body AA on the same conditions via new Tauri probes. Document PSYSONIC_SKIP_WAYLAND_FONT_TUNING for opt-out and changelog. * fix(rust): satisfy clippy needless_return in Linux webkit helpers * fix(linux): tune Wayland text rendering with HW policy env and CSS Allow PSYSONIC_WEBKIT_WAYLAND_HW_POLICY to select WebKit hardware acceleration policy (never/always vs default on-demand). Extend Wayland font CSS to #root with geometricPrecision and text-size-adjust on html. * feat(linux): Wayland text presets in settings, safe WebKit apply, CPU default Persist profile to app config; apply WebKit policy at startup/mini only to avoid WebKitGTK hangs on live toggles. UI + CSS preview stays live; default preset is sharp (CPU-friendly). * fix(linux): map Wayland sharp preset to OnDemand WebKit policy HardwareAccelerationPolicy::Never at startup broke main-viewport wheel scrolling on WebKitGTK+Wayland; sharp vs balanced remains a CSS AA path. Use PSYSONIC_WEBKIT_WAYLAND_HW_POLICY for a true Never policy. * fix(rust): gate Linux-only Wayland WebKit helpers for Windows builds Re-export startup helpers only under cfg(linux) and drop non-Linux stubs so Windows compiles without unused-import and dead-code warnings. * chore(release): CHANGELOG + credits for Linux session/WebKit work (PR #731) Consolidate scattered incremental changelog notes into two [1.47.0] entries with PR link; remove duplicate Linux blocks from [1.46.0] Fixed. Append settings credit line for cucadmuh.
2026-07-22 06:25:41 +00:00 · 2026-05-18 21:00:46 +03:00
parent b4782aeedb
commit 70c2fdfbf9
61 changed files with 1602 additions and 712 deletions
@@ -111,5 +111,5 @@ export const help = {
  q44: 'Cover und Künstlerbilder laden langsam.',
  a44: 'Bilder werden beim ersten Aufruf vom Server geholt und dann 30 Tage lokal gecacht. Bei langsamen Server-Festplatten kann der erste Seitenaufruf einen Moment dauern; danach sind sie sofort da. Der Hot Cache hilft auch bei Tracks, der Bild-Cache ist davon unabhängig.',
  q45: 'Linux-Probleme — schwarzer Bildschirm oder kein Ton?',
-  a45: 'Schwarzer Bildschirm ist meist ein GPU- / EGL-Treiberproblem in WebKitGTK — mit GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 starten (die AUR- / .deb- / .rpm-Installer setzen das automatisch). Für Audio sicherstellen, dass PipeWire oder PulseAudio läuft. Tonaussetzer nach Sleep / Wake werden mittlerweile vom Post-Sleep-Recovery-Hook automatisch behandelt.',
+  a45: 'Ein schwarzer Bildschirm unter Linux betrifft meist Grafik oder die WebView-Anzeige. Versuchen Sie eine X11-Sitzung oder setzen Sie vor dem Start GDK_BACKEND=x11 und EGL_PLATFORM=x11 (unter Wayland). Für Ton: PipeWire oder PulseAudio. Verschwindet der Ton nach Standby, beenden Sie Psysonic vollständig und starten Sie neu.',
 };
@@ -185,6 +185,13 @@ export const settings = {
  useCustomTitlebarDesc: 'Ersetzt die System-Titelleiste durch eine eingebaute, die zum App-Theme passt. Deaktivieren, um die native GNOME/GTK-Titelleiste zu verwenden.',
  linuxWebkitSmoothScroll: 'Sanftes Mausrad (Linux)',
  linuxWebkitSmoothScrollDesc: 'An: mit Nachlauf. Aus: zeilenweise wie in GTK-Apps.',
+  linuxWaylandTextRender: 'Wayland-Textdarstellung (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Kantenglättung in der Oberfläche wirkt sofort. Die WebKit-Beschleunigungsrichtlinie (scharf/GPU) wird gespeichert und beim nächsten App-Start angewendet — ein Live-Umschalten kann WebKitGTK einfrieren.',
+  linuxWaylandTextRenderBalanced: 'Ausgewogen',
+  linuxWaylandTextRenderSharp: 'Scharf (CPU-freundlich)',
+  linuxWaylandTextRenderGpu: 'GPU zuerst',
+  linuxWaylandTextRenderMinimal: 'Minimal (Standard-CSS-Glättung)',
  discordCoverSource: 'Cover-Quelle',
  discordCoverSourceDesc: 'Woher das Album-Cover für dein Discord-Profil geladen wird.',
  discordCoverNone: 'Keine (nur App-Symbol)',
@@ -111,5 +111,5 @@ export const help = {
  q44: 'Cover art and artist images load slowly.',
  a44: 'Images are fetched from your server on first view and then cached locally for 30 days. If your server\'s storage is slow, the first visit to a page can take a moment; subsequent visits are instant. The Hot Cache also helps for tracks but image cache is independent.',
  q45: 'Linux issues — black screen or no audio?',
-  a45: 'Black screen is usually a GPU / EGL driver issue in WebKitGTK — launch with GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 (the AUR / .deb / .rpm installers set these automatically). For audio, make sure PipeWire or PulseAudio is running. If audio drops out after sleep / wake, this is now handled automatically by the post-sleep recovery hook.',
+  a45: 'A black screen on Linux is usually a graphics or WebView display issue. Try an X11 session, or set GDK_BACKEND=x11 and EGL_PLATFORM=x11 before launching if you use Wayland. For audio, make sure PipeWire or PulseAudio is running. If sound stops after sleep or wake, quit Psysonic completely and open it again.',
 };
@@ -188,6 +188,13 @@ export const settings = {
  useCustomTitlebarDesc: 'Replace the system title bar with a built-in one that matches the app theme. Disable to use the native GNOME/GTK title bar.',
  linuxWebkitSmoothScroll: 'Smooth wheel (Linux)',
  linuxWebkitSmoothScrollDesc: 'On: inertial scroll. Off: line-by-line, GTK-style.',
+  linuxWaylandTextRender: 'Wayland text rendering (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Font smoothing in the UI updates immediately. WebKit hardware acceleration (sharp / GPU presets) is saved and applied on the next app start — changing it live can freeze WebKitGTK on some setups.',
+  linuxWaylandTextRenderBalanced: 'Balanced',
+  linuxWaylandTextRenderSharp: 'Sharp (CPU-friendly)',
+  linuxWaylandTextRenderGpu: 'GPU-first',
+  linuxWaylandTextRenderMinimal: 'Minimal (default CSS smoothing)',
  discordCoverSource: 'Cover art source',
  discordCoverSourceDesc: 'Where to fetch album artwork shown on your Discord profile.',
  discordCoverNone: 'None (app icon only)',
@@ -101,5 +101,5 @@ export const help = {
  q44: 'Las portadas e imágenes de artista cargan lentamente.',
  a44: 'Las imágenes se obtienen del servidor en la primera vista y luego se almacenan localmente durante 30 días. Si el almacenamiento de tu servidor es lento, la primera visita a una página puede tardar un momento; las visitas posteriores son instantáneas. Hot Cache también ayuda con pistas pero el caché de imágenes es independiente.',
  q45: 'Problemas en Linux — ¿pantalla negra o sin sonido?',
-  a45: 'La pantalla negra es generalmente un problema de driver GPU / EGL en WebKitGTK — lanza con GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 (los instaladores AUR / .deb / .rpm los configuran automáticamente). Para audio, asegúrate de que PipeWire o PulseAudio esté ejecutándose. Los cortes de audio tras suspensión / despertar ahora son manejados automáticamente por el hook de recuperación post-sleep.',
+  a45: 'La pantalla negra en Linux suele ser un problema de gráficos o de la ventana WebView. Prueba una sesión X11 o, antes de abrir la app, exporta GDK_BACKEND=x11 y EGL_PLATFORM=x11 si usas Wayland. Audio: PipeWire o PulseAudio. Si pierdes el sonido tras suspender, cierra por completo Psysonic y vuelve a abrirlo.',
 };
@@ -185,6 +185,13 @@ export const settings = {
  useCustomTitlebarDesc: 'Reemplaza la barra de título del sistema con una integrada que coincide con el tema de la app. Desactiva para usar la barra nativa de GNOME/GTK.',
  linuxWebkitSmoothScroll: 'Rueda suave (Linux)',
  linuxWebkitSmoothScrollDesc: 'Activado: inercia. Desactivado: pasos por línea (estilo GTK).',
+  linuxWaylandTextRender: 'Renderizado de texto Wayland (Linux)',
+  linuxWaylandTextRenderDesc:
+    'El suavizado en la interfaz se aplica al instante. La aceleración de hardware de WebKit (nítido/GPU) se guarda y aplica al reiniciar la app; cambiarla en vivo puede congelar WebKitGTK.',
+  linuxWaylandTextRenderBalanced: 'Equilibrado',
+  linuxWaylandTextRenderSharp: 'Nítido (más CPU)',
+  linuxWaylandTextRenderGpu: 'Prioridad GPU',
+  linuxWaylandTextRenderMinimal: 'Mínimo (suavizado CSS por defecto)',
  discordCoverSource: 'Fuente de portada',
  discordCoverSourceDesc: 'De dónde obtener la portada del álbum para tu perfil de Discord.',
  discordCoverNone: 'Ninguna (solo icono de la app)',
@@ -101,5 +101,5 @@ export const help = {
  q44: 'Les pochettes et images d\'artiste se chargent lentement.',
  a44: 'Les images sont récupérées du serveur à la première vue puis mises en cache localement pour 30 jours. Si le stockage du serveur est lent, la première visite d\'une page peut prendre un instant ; les visites suivantes sont instantanées. Le Hot Cache aide aussi pour les pistes mais le cache d\'images est indépendant.',
  q45: 'Problèmes Linux — écran noir ou pas de son ?',
-  a45: 'L\'écran noir est généralement un souci de pilote GPU / EGL dans WebKitGTK — lancez avec GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 (les installeurs AUR / .deb / .rpm le font automatiquement). Pour le son, vérifiez que PipeWire ou PulseAudio tourne. Les coupures audio après mise en veille sont désormais gérées automatiquement par le hook de récupération post-sleep.',
+  a45: 'L\'écran noir sous Linux indique souvent un souci d\'affichage WebView ou graphique. Essayez une session X11, ou définissez GDK_BACKEND=x11 et EGL_PLATFORM=x11 avant le lancement sous Wayland. Audio : PipeWire ou PulseAudio. Si le son disparaît après une mise en veille, quittez entièrement Psysonic puis rouvrez-le.',
 };
@@ -181,6 +181,13 @@ export const settings = {
  preloadMiniPlayerDesc: 'Construit la fenêtre du mini-lecteur en arrière-plan au démarrage de l\'application afin qu\'elle affiche son contenu instantanément à la première ouverture. Utilise un peu plus de mémoire.',
  linuxWebkitSmoothScroll: 'Molette fluide (Linux)',
  linuxWebkitSmoothScrollDesc: 'Activé : inertie. Désactivé : pas à la ligne, style GTK.',
+  linuxWaylandTextRender: 'Rendu du texte Wayland (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Le lissage dans l’interface est immédiat. L’accélération matérielle WebKit (net / GPU) est enregistrée et appliquée au prochain lancement — la modifier en direct peut figer WebKitGTK.',
+  linuxWaylandTextRenderBalanced: 'Équilibré',
+  linuxWaylandTextRenderSharp: 'Net (favorise le CPU)',
+  linuxWaylandTextRenderGpu: 'GPU prioritaire',
+  linuxWaylandTextRenderMinimal: 'Minimal (lissage CSS par défaut)',
  discordRichPresence: 'Discord Rich Presence',
  discordRichPresenceDesc: 'Affiche le titre en cours de lecture sur votre profil Discord. Discord doit être ouvert.',
  discordCoverSource: 'Source de pochette',
@@ -101,5 +101,5 @@ export const help = {
  q44: 'Cover-art og artistbilder lastes sakte.',
  a44: 'Bilder hentes fra serveren ved første visning og caches deretter lokalt i 30 dager. Hvis serverens lagring er treg, kan første besøk på en side ta et øyeblikk; påfølgende besøk er umiddelbare. Hot Cache hjelper også for spor, men bildecachen er uavhengig.',
  q45: 'Linux-problemer — svart skjerm eller ingen lyd?',
-  a45: 'Svart skjerm er vanligvis et GPU- / EGL-driverproblem i WebKitGTK — start med GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 (AUR / .deb / .rpm-installerne setter disse automatisk). For lyd, sørg for at PipeWire eller PulseAudio kjører. Lydutfall etter dvale / oppvåkning håndteres nå automatisk av post-sleep recovery hook.',
+  a45: 'Svart skjerm på Linux tyder vanligvis på grafikk eller WebView-visning. Prøv X11-økt, eller sett GDK_BACKEND=x11 og EGL_PLATFORM=x11 før start ved Wayland. Lyd: PipeWire eller PulseAudio. Forsvinner lyd etter dvale: lukk Psysonic helt og åpne igjen.',
 };
@@ -180,6 +180,13 @@ export const settings = {
  preloadMiniPlayerDesc: 'Bygger miniavspiller-vinduet i bakgrunnen ved appstart slik at det viser innhold umiddelbart ved første åpning. Bruker litt mer minne.',
  linuxWebkitSmoothScroll: 'Mykt musehjul (Linux)',
  linuxWebkitSmoothScrollDesc: 'På: treg rull med etterslep. Av: trinnvis som i GTK.',
+  linuxWaylandTextRender: 'Wayland-tekstgjengivelse (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Utjevning i grensesnittet skjer med én gang. WebKit-maskinvareakselerasjon (skarp/GPU) lagres og brukes ved neste appstart — live bytte kan fryse WebKitGTK.',
+  linuxWaylandTextRenderBalanced: 'Balansert',
+  linuxWaylandTextRenderSharp: 'Skarpt (CPU-vennlig)',
+  linuxWaylandTextRenderGpu: 'GPU først',
+  linuxWaylandTextRenderMinimal: 'Minimum (standard CSS-utjevning)',
  discordRichPresence: 'Discord Rich Presence',
  discordRichPresenceDesc: 'Vis sporet som spilles i din Discord-profil. Krever at Discord kjører.',
  discordCoverSource: 'Coverkilde',
@@ -101,5 +101,5 @@ export const help = {
  q44: 'Hoezen en artiestafbeeldingen laden traag.',
  a44: 'Afbeeldingen worden bij de eerste weergave van uw server gehaald en vervolgens 30 dagen lokaal gecached. Als de opslag van uw server traag is, kan het eerste bezoek aan een pagina even duren; volgende bezoeken zijn onmiddellijk. De Hot Cache helpt ook voor nummers, maar de afbeeldingscache is onafhankelijk.',
  q45: 'Linux-problemen — zwart scherm of geen geluid?',
-  a45: 'Zwart scherm is meestal een GPU / EGL-stuurprogrammakwestie in WebKitGTK — start met GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 (de AUR / .deb / .rpm-installers stellen deze automatisch in). Voor audio, zorg ervoor dat PipeWire of PulseAudio draait. Audio-uitval na slaap / wakker worden wordt nu automatisch afgehandeld door de post-sleep recovery hook.',
+  a45: 'Een zwart scherm op Linux wijst meestal op een grafisch of WebView-weergaveprobleem. Probeer een X11-sessie of stel vóór starten GDK_BACKEND=x11 en EGL_PLATFORM=x11 in bij Wayland. Audio: PipeWire of PulseAudio. Verdwijnt geluid na slaapstand: sluit Psysonic volledig af en start opnieuw.',
 };
@@ -181,6 +181,13 @@ export const settings = {
  preloadMiniPlayerDesc: 'Bouwt het venster van de mini-speler op de achtergrond bij het opstarten van de app, zodat het bij de eerste opening direct inhoud toont. Gebruikt iets meer geheugen.',
  linuxWebkitSmoothScroll: 'Vloeiend muiswiel (Linux)',
  linuxWebkitSmoothScrollDesc: 'Aan: traag naloop. Uit: regel voor regel, GTK-stijl.',
+  linuxWaylandTextRender: 'Wayland-tekstweergave (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Vloeiendheid in de UI werkt meteen. WebKit-hardwareversnelling (scherp/GPU) wordt bewaard en toegepast bij de volgende app-start — live schakelen kan WebKitGTK laten vastlopen.',
+  linuxWaylandTextRenderBalanced: 'Gebalanceerd',
+  linuxWaylandTextRenderSharp: 'Scherp (CPU-vriendelijk)',
+  linuxWaylandTextRenderGpu: 'GPU eerst',
+  linuxWaylandTextRenderMinimal: 'Minimaal (standaard CSS-verzachting)',
  discordRichPresence: 'Discord Rich Presence',
  discordRichPresenceDesc: 'Toont het huidige nummer op je Discord-profiel. Discord moet daarvoor geopend zijn.',
  discordCoverSource: 'Hoesbron',
@@ -111,5 +111,5 @@ export const help = {
  q44: 'Arta copertei și imaginile artiștilor se încarcă încet.',
  a44: 'Imaginile sunt preluate de pe serverul tău la prima vedere și apoi stocate în cache pentru 30 de zile. Dacă stocarea serverului tău este înceată, prima vizită către o pagină poate dura un moment; vizitele consecutive sunt instantanee. Hot Cache de asemenea ajută pentru piese dar nu pentru cache-ul imaginii.',
  q45: 'Probleme pe Linux - ecran negru sau niciun audio?',
-  a45: 'Aceasta este de obicei o problemă de driver GPU/EGL în WebKitGTK. Pornește cu GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1. Pachetul AUR și installer-ele oficiale .deb/.rpm fac asta automat.',
+  a45: 'Ecranul negru pe Linux este de obicei o problemă de grafică sau de afișare WebView. Încearcă o sesiune X11 sau setează înainte de lansare GDK_BACKEND=x11 și EGL_PLATFORM=x11 dacă folosești Wayland. Pentru audio: PipeWire sau PulseAudio. Dacă sunetul dispare după somn, închide complet Psysonic și redeschide-l.',
 };
@@ -188,6 +188,13 @@ export const settings = {
  useCustomTitlebarDesc: 'Înlocuiește bara de titlu a sistemului cu una care corespunde cu tema aplicației. Dezactivează pentru a folosi bara de titlu nativ GNOME/GTK.',
  linuxWebkitSmoothScroll: 'Rotiță lină (Linux)',
  linuxWebkitSmoothScrollDesc: 'Pornit: scroll inert. Oprit: linie cu linie, în stil GTK.',
+  linuxWaylandTextRender: 'Randare text Wayland (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Netezirea în interfață se aplică imediat. Accelerația hardware WebKit (ascuțit/GPU) este salvată și aplicată la următoarea pornire a aplicației — comutarea în timpul rulării poate îngheța WebKitGTK.',
+  linuxWaylandTextRenderBalanced: 'Echilibrat',
+  linuxWaylandTextRenderSharp: 'Ascuțit (prietenos cu CPU)',
+  linuxWaylandTextRenderGpu: 'Prioritate GPU',
+  linuxWaylandTextRenderMinimal: 'Minim (netezire CSS implicită)',
  discordCoverSource: 'Sursa artei de copertă',
  discordCoverSourceDesc: 'De unde să fie preluată arta de album afișată pe profilul tău de Discord.',
  discordCoverNone: 'Niciuna (doar iconița aplicației)',
@@ -101,5 +101,5 @@ export const help = {
  q44: 'Обложки и изображения исполнителей загружаются медленно.',
  a44: 'Изображения подгружаются с сервера при первом просмотре, затем кэшируются локально на 30 дней. Если хранилище сервера медленное, первый визит на страницу может занять момент; последующие визиты мгновенные. Hot Cache также помогает с треками, но кэш изображений независим.',
  q45: 'Проблемы Linux — чёрный экран или нет звука?',
-  a45: 'Чёрный экран обычно проблема GPU / EGL драйвера в WebKitGTK — запускайте с GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 (AUR / .deb / .rpm установщики устанавливают это автоматически). Для аудио убедитесь, что PipeWire или PulseAudio запущены. Пропадание звука после спящего режима / пробуждения теперь обрабатывается автоматически post-sleep recovery hook.',
+  a45: 'Чёрный экран на Linux чаще всего связан с отображением окна приложения или графическим стеком. Попробуйте сеанс на X11 или перед запуском задайте GDK_BACKEND=x11 и EGL_PLATFORM=x11, если используете Wayland. Для звука нужны PipeWire или PulseAudio. Если после сна пропал звук — полностью закройте Psysonic и откройте снова.',
 };
@@ -190,6 +190,13 @@ export const settings = {
    'Заменить системную строку заголовка встроенной, в стиле темы приложения. Отключите, чтобы использовать родную строку GNOME/GTK и т.д.',
  linuxWebkitSmoothScroll: 'Плавное колесо (Linux)',
  linuxWebkitSmoothScrollDesc: 'Вкл — инерция. Выкл — по шагам, как в GTK.',
+  linuxWaylandTextRender: 'Рендеринг текста Wayland (Linux)',
+  linuxWaylandTextRenderDesc:
+    'Сглаживание в интерфейсе меняется сразу. Политику ускорения WebKit (чёткий / GPU) сохраняем и применяем при следующем запуске — переключение на лету на части сборок зависает в WebKitGTK.',
+  linuxWaylandTextRenderBalanced: 'Сбалансированный',
+  linuxWaylandTextRenderSharp: 'Чёткий (меньше GPU)',
+  linuxWaylandTextRenderGpu: 'С приоритетом GPU',
+  linuxWaylandTextRenderMinimal: 'Минимальный (сглаживание по умолчанию)',
  discordRichPresence: 'Статус в Discord',
  discordRichPresenceDesc:
    'Показывать текущий трек в профиле и статусе Discord. Нужен запущенный клиент Discord.',
@@ -101,5 +101,5 @@ export const help = {
  q44: '封面和艺术家图像加载缓慢。',
  a44: '图像在首次查看时从服务器获取，然后本地缓存 30 天。如果您服务器的存储速度慢，第一次访问页面可能需要片刻；后续访问是即时的。Hot Cache 也对曲目有帮助，但图像缓存是独立的。',
  q45: 'Linux 问题 — 黑屏或无声音？',
-  a45: '黑屏通常是 WebKitGTK 中的 GPU / EGL 驱动程序问题 — 使用 GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 启动（AUR / .deb / .rpm 安装程序自动设置这些）。对于音频，确保 PipeWire 或 PulseAudio 正在运行。睡眠/唤醒后的音频丢失现在由 post-sleep 恢复钩子自动处理。',
+  a45: 'Linux 黑屏多半是图形或应用 WebView 显示层面的问题。可改用 X11 会话，或在 Wayland 下启动前设置 GDK_BACKEND=x11、EGL_PLATFORM=x11。声音请确认 PipeWire 或 PulseAudio 在运行；若睡眠唤醒后无声，完全退出 Psysonic 再重新打开。',
 };
@@ -181,6 +181,12 @@ export const settings = {
  preloadMiniPlayerDesc: '在应用启动时于后台构建迷你播放器窗口，使其首次打开即可立即显示内容。会占用少量额外内存。',
  linuxWebkitSmoothScroll: '滚轮平滑（Linux）',
  linuxWebkitSmoothScrollDesc: '开：惯性滚动。关：逐行，类似 GTK。',
+  linuxWaylandTextRender: 'Wayland 文本渲染（Linux）',
+  linuxWaylandTextRenderDesc: '界面字体平滑立即生效。WebKit 硬件加速策略（锐利 / GPU）会保存并在下次启动应用时应用；运行中反复切换可能导致 WebKitGTK 卡死。',
+  linuxWaylandTextRenderBalanced: '平衡',
+  linuxWaylandTextRenderSharp: '锐利（偏 CPU）',
+  linuxWaylandTextRenderGpu: 'GPU 优先',
+  linuxWaylandTextRenderMinimal: '最小（默认 CSS 平滑）',
  discordRichPresence: 'Discord Rich Presence',
  discordRichPresenceDesc: '在 Discord 个人资料上显示当前播放的曲目。需要 Discord 处于运行状态。',
  discordCoverSource: '封面来源',