Document Athena 3D mode and agent operations

docs/ARCHITECTURE.md

@@ -10,6 +10,8 @@ flowchart LR
     I --> E[Qwen3-8B NF4 Textencoder<br/>RTX 3060 während Bildauftrag]
     R --> T[Qwen3-TTS RTX 3060<br/>Normalisierungs- und Streaming-Gateway]
     R --> STT[Whisper.cpp ggml-small<br/>CPU, lokale Spracherkennung]
+    P --> SP[Exklusive Spezialworker<br/>Musik / Trennung / Voice / RVC / 3D]
+    SP --> TR[TRELLIS.2 4B Q8<br/>trellis.cpp, RTX 5080]
 
     H --> U[MUA / Unraid MCP]
     H --> A[ARR-MCP]
@@ -17,11 +19,12 @@ flowchart LR
     H --> N[Navidrome-MCP]
     H --> S[STRATO-MCP]
     H --> X[Nginx-Proxy-Manager-MCP]
-    U --> M[Media-Tools<br/>ffmpeg / ffprobe / yt-dlp]
+    U --> MT[Media-Tools<br/>ffmpeg / ffprobe / yt-dlp]
 
     W[WireGuard-Gateway<br/>Athena] -->|DNS-Proxy| R
     W -->|DNS-Proxy :8099| B[Athena Dashboard<br/>internes Frontend-Netz]
     W -->|DNS-Proxy :9443| PRT[Portainer<br/>internes Frontend-Netz]
+    W -->|DNS-Proxy :8013| TRUI[Trellis Studio<br/>Bild zu GLB]
     W -->|DNS-Proxy| O[Athena Operator]
     K[Backup alle 5 Stunden] --> DATA[/data und /etc/mike-ai]
 ```
@@ -34,6 +37,9 @@ flowchart LR
 - **MUA** verwaltet Unraid. **Athena Operator** bleibt auf den Athena-Host
   begrenzt.
 - Der Router ist die einzige Modelladresse, die Hermes kennen muss.
+- GPU-intensive Spezialdienste sind gegenseitig exklusiv. Der Router speichert
+  Modus und Rückkehrprofil; der Profile Controller startet nur eindeutig
+  gelabelte Worker.
 - Dashboard und Portainer besitzen eigene Netzwerk-Namespaces. Das
   WireGuard-Gateway löst ihre stabilen Compose-Dienstnamen bei jeder
   Verbindung neu auf; seine konkrete Container-ID ist damit irrelevant.
@@ -75,3 +81,16 @@ Eine zweite Detailkarte, `athena-gpu-allocation-map.png`, zeigt die
 profilabhängige Layer-Verteilung auf RTX 5080 und RTX 3060. Die PNG-Karten
 zeigen noch den Stand vor dem 9B-Bildpfad; die aktuelle textuelle Beschreibung
 in diesem Dokument ist verbindlich.
+
+## TRELLIS.2 3D-Modus
+
+Der Modus `trellis` stoppt die anderen GPU-Worker und startet genau den mit
+`com.mike-ai.trellis-worker=trellis2-q8` markierten Container. trellis.cpp
+0.6.0 sieht ausschließlich die Host-GPU 1, die RTX 5080. Q8-Gewichte liegen
+unter `/data/models/trellis2-q8`, Runtime und Ausgaben unter
+`/data/trellis-studio`. Die UI ist intern `trellis-studio:8080` und wird vom
+WireGuard-Gateway auf `192.168.1.212:8013` weitergeleitet. Sie erzeugt GLB;
+regulärer Qualitätsmodus ist 1024 Pixel.
+
+Die vollständigen Regeln für Erweiterungen, Rückbau und Fehlersuche stehen in
+[`../for_ki.md`](../for_ki.md).