youtube_personal/BASELINE_PROTEGEE_18_7_5.md

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 :

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 -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.