Add managed LadyPoly WebUI using Deck music API

deploy/ladypoly/README.md

@@ -0,0 +1,52 @@
+# LadyPoly YuE2 für Athena Deck
+
+Die gepinnte LadyPoly-WebUI (Commit 3960afc309efcef5f4f570209cf01160b96b1ea3)
+läuft separat ohne Torch, CUDA, Modellmounts oder Docker-Socket. Die schmale
+Anbindung nutzt Decks authentifizierte Musik-API auf 127.0.0.1:8120.
+Deck steuert audio.cpp, Gewichte und den exklusiven Musikmodus.
+
+Auf Debian mit vorhandenem Docker, im Athena-Deck-Repository:
+
+```sh
+docker build -t athena-ladypoly:3960afc-deck1 deploy/ladypoly
+sudo python3 deploy/ladypoly/install.py
+```
+
+Container: `athena-ladypoly`. Frei zu prüfender Port: **8127**, nur Host-Loopback.
+Host-Netzwerk verbindet zur lokalen Deck-API; keine öffentliche Portfreigabe.
+Labels: `io.athena-deck.managed=true`, `io.athena-deck.role=application`,
+`io.athena-deck.application=ladypoly`. Diese machen ihn unter Weitere Dienste sichtbar.
+Volume: `/opt/athena-ladypoly/data:/data:rw`, UID/GID 65534, Verzeichnis 0700.
+Enthält Verbindungsdaten/Token (0600), UI-Einstellungen und generierte Musik.
+Keine Modelle oder Runtime im Container. Image wird aus diesem Rezept gebaut;
+noch kein öffentliches Registry-Image/Pull-Befehl verfügbar.
+
+```sh
+ssh -i ~/.ssh/athena_key -o BatchMode=yes -o ExitOnForwardFailure=yes -N -L 8127:127.0.0.1:8127 root@192.168.1.212
+```
+
+Dann http://127.0.0.1:8127/deck-connection öffnen. Eigenen Deck-API-Token und
+exakten freigegebenen YuE2-Profilnamen eingeben. Die Verbindung wird gegen die
+Musik-Modellliste geprüft. Bei Tokenwechsel hier erneut speichern.
+In Deck auf Musik umschalten, anschließend in LadyPoly Stil und Liedtext
+angeben und generieren. Deck-Endpunkt muss gestartet sein.
+
+Unterstützt: Titel/Bibliothek, Liedtext, Stil, Seed, WAV-Erzeugung über Deck,
+FLAC-Bibliothek und Wiedergabe. Derzeit Direct-Modus, bis 9000 semantische Tokens
+und sechs Syntheseschritte. Kein Versprechen einer bestimmten Songdauer.
+Writer, Cover-Erzeugung, Score, LoRA und Sampling-Overrides sind nicht angebunden;
+die betreffenden Bedienelemente sind ausgeblendet/gesperrt. Abbruch eines laufenden
+GPU-Jobs erfolgt in Deck; die WebUI ist kein zweiter Prozessmanager.
+
+```sh
+docker stop athena-ladypoly
+docker start athena-ladypoly
+```
+
+Der Deck-Backuphelfer kennt das gepinnte Build-Rezept und sichert die beiden
+Konfigurationsdateien im verschlüsselten Backup. Ergebnisse unter outputs sind
+Nutzdaten und werden nicht exportiert. Beim Restore wird das Image wieder gebaut;
+der Port muss frei sein. Deck-API-Portänderungen erfordern derzeit eine Anpassung
+von `BASE` in bridge.py und einen Image-Neubau.
+
+Upstream-Lizenz und Hinweise verbleiben unter /app im Image.