Light theme default + yt-dlp search fallback

2026-08-22 13:02:32 +01:00
commit 7704cae4a0
282 changed files with 52324 additions and 0 deletions
@@ -0,0 +1,61 @@
+# YouTube Personal — Baseline protégée 18.7.5
+
+## Statut
+
+Cette version est la référence fonctionnelle validée pour le démarrage vidéo Windows.
+Elle ne doit pas être remplacée par une réécriture du pipeline de démarrage sans test comparatif et possibilité de retour arrière.
+
+## Fichiers protégés
+
+- `lib/screens/video_player_page.dart`
+- `lib/services/windows_hd_service.dart`
+
+## Comportement à préserver
+
+1. Au clic sur une vidéo sous Windows, tenter d'abord le démarrage rapide 360p muxé.
+2. Ne pas bloquer le premier affichage sur le téléchargement complet de la vidéo et de l'audio.
+3. En cas d'échec du chemin rapide, conserver un fallback yt-dlp robuste.
+4. Si la qualité cible est supérieure à 360p, préparer la HD en arrière-plan puis basculer à la position courante.
+5. Si 360p est explicitement sélectionné, ne pas lancer de préparation HD inutile.
+6. Une bascule de qualité ne doit pas incrémenter le compteur personnel de vues.
+7. Ne pas réintroduire le relais Range `yt-dlp HttpFD` de la 18.7.4 comme chemin principal : il a provoqué des HTTP 403 et des timeouts de 30 s.
+
+## Règles obligatoires pour les évolutions futures
+
+Avant toute modification touchant le lecteur Windows :
+
+1. Conserver cette archive intacte comme point de retour arrière.
+2. Faire une modification minimale et localisée.
+3. Ne pas réécrire `WindowsHdService` ou le démarrage du `VideoPlayerPage` si l'évolution demandée ne concerne pas directement le pipeline vidéo.
+4. Vérifier le diff contre cette baseline avant livraison.
+5. Tester au minimum une vidéo non mise en cache.
+6. Vérifier que la première image apparaît avant de valider la modification.
+7. Vérifier les logs `[HD-WINDOWS]`, `[HD-PROGRESSIVE]` et `[YT-PLAYER]` en cas de changement du pipeline.
+8. Si une régression apparaît, restaurer immédiatement cette baseline avant de poursuivre.
+9. Toute livraison doit contenir uniquement les fichiers modifiés/ajoutés avec chemins relatifs au projet.
+
+## Régressions connues à ne pas réintroduire
+
+### 18.7.2 / ancien chemin lent
+Le lecteur pouvait attendre le téléchargement complet d'environ 20 MiB de vidéo + 10 MiB d'audio avant de commencer la lecture 360p.
+
+### 18.7.4
+Le relais Range basé sur `yt-dlp HttpFD` a produit :
+
+```text
+HTTP Error 403: Forbidden
+0 octet fourni
+Timeout 30 secondes
+```
+
+Ce chemin ne doit pas redevenir le démarrage principal.
+
+## Restauration
+
+Depuis le dossier extrait de cette baseline :
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\restore_18_7_5.ps1 -ProjectPath "D:\07-Logiciels\23-youtube_personal"
+```
+
+Le script crée d'abord une sauvegarde des fichiers actuels avant de remettre les deux fichiers protégés.