Phase 4 und Teile von Phase 5

Download-Regeln
- Automatisches Löschen nach dem Ansehen, mit Frist statt sofort: wer
  die letzte Szene noch einmal sucht, soll sie nicht schon verloren
  haben. „Nie" ist die Voreinstellung.
- „Halte N ungesehene Folgen offline": wartende und laufende Downloads
  zählen mit, sonst würde bei jedem Durchlauf nachgelegt, bis die ganze
  Serie auf dem Gerät liegt.
- Beides als reine Rechnung ohne Zugriff auf Datenbank oder Dateien —
  bei einer Regel, die Filme löscht, ist Prüfbarkeit keine Formsache.
  13 Tests.

Qualitätswahl beim Download
- transcodedDownloadURL über den Universal-Transcoder mit protocol=http
  statt über die umständliche Sync-API. NOCH NICHT AM SERVER GEPRÜFT:
  offen ist, ob Plex eine Content-Length mitschickt (sonst kein
  Fortschritt und kein Fortsetzen) und ob die Datei durchsuchbar ist.
  Steht so im Quelltext; Original bleibt Voreinstellung.

Erscheinungsbild
- Akzentfarbe: zehn kuratierte Kacheln plus freie Hex-Eingabe. Bei einer
  eigenen Farbe greift die Kontrastkorrektur und sagt es auch — sonst
  wirkt sie wie ein Fehler.
- Vorschaufläche mit Knopf, Symbol und Fortschrittsbalken.

Serveraktionen
- Gesehen-Status umschalten und Sterne setzen über ein Menü auf der
  Detailseite.
- Suchlauf der Mediathek aus der Werkzeugleiste.

115 Tests.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlixyKit/Sources/PlexKit/Endpoints/PlexServer+Playback.swift

@@ -189,3 +189,56 @@ extension PlexServer {
             .min(by: { ($0.index ?? 0) < ($1.index ?? 0) })
     }
 }
+
+extension PlexServer {
+    /// Die Adresse für einen heruntergerechneten Download.
+    ///
+    /// **Noch nicht an einem echten Server geprüft.** Der Weg nutzt den
+    /// Universal-Transcoder mit `protocol=http`, der einen fortlaufenden Strom
+    /// statt HLS liefert — anders als der offizielle Sync-Weg von Plex, der
+    /// umständlich und schlecht dokumentiert ist.
+    ///
+    /// Zwei Dinge sind dabei offen und gehören am eigenen Server geprüft,
+    /// bevor die Einstellung angeboten wird:
+    /// 1. Ob Plex eine `Content-Length` mitschickt. Ohne sie gibt es keinen
+    ///    Fortschrittsbalken und kein Fortsetzen nach dem Pausieren.
+    /// 2. Ob die entstehende Datei durchsuchbar ist. Ein Strom, der von vorn
+    ///    gedacht ist, muss es nicht sein — dann ließe sich im Download nicht
+    ///    springen.
+    ///
+    /// Bis das geklärt ist, bleibt der Download in Originalqualität die
+    /// Voreinstellung.
+    public nonisolated func transcodedDownloadURL(
+        ratingKey: String,
+        mediaIndex: Int = 0,
+        maximumBitrate: Int,
+        resolution: String?
+    ) -> URL? {
+        guard let baseURL = connection.url,
+              var components = URLComponents(
+                url: baseURL.appending(path: "/video/:/transcode/universal/start"),
+                resolvingAgainstBaseURL: false
+              )
+        else { return nil }
+
+        let request = TranscodeRequest(
+            ratingKey: ratingKey,
+            mediaIndex: mediaIndex,
+            maximumBitrate: maximumBitrate,
+            resolution: resolution,
+            // Ein Download ist kein Abspielen im Heimnetz: `wan` lässt Plex
+            // konservativer puffern, was für eine Datei egal ist.
+            isLocal: false
+        )
+
+        components.queryItems = request.queryItems
+            // Überschreibt `protocol=hls` aus der Anfrage: für eine Datei
+            // brauchen wir einen fortlaufenden Strom, keine Segmentliste.
+            .filter { $0.name != "protocol" && $0.name != "fastSeek" && $0.name != "copyts" }
+            + [
+                URLQueryItem(name: "protocol", value: "http"),
+                URLQueryItem(name: "X-Plex-Token", value: token),
+            ]
+        return components.url
+    }
+}