docs: add offline knowledge library with project analysis and external references

- function-inventory: complete public API for 10 Rust crates + 56 Dart files - coverage-analysis: 312 Rust tests, 221 Dart tests, doc coverage gaps - doc-quality-analysis: duplications, broken refs, useless content audit - link-coverage-report: all internal/external links validated - external/teaspeak: TeaSpeak voice server architecture & protocol - external/respeak: ReSpeak org, tsclientlib, tsproto, crypto docs - external/yatqa-en/de: yat.qa admin tool (English + German) - reviews/: cross-validation reports for all analyses All documentation only, no code changes.
2026-06-13 02:00:26 +09:00
parent 89bbfa1e18
commit dd6e80f72a
13 changed files with 3358 additions and 0 deletions
@@ -0,0 +1,348 @@
+# YaTQA Wissensdatenbank (Deutsch)
+
+> Quelle: https://yat.qa/ — Abgerufen: 13.06.2026
+> Version: v3.9.9b (01. Mrz 2023)
+
+## Überblick
+
+**YaTQA** (Yet Another TeamSpeak³ Query Admin Tool) ist eine Windows-Anwendung zur Verwaltung von **TeamSpeak-3-Servern und -Instanzen** über das ServerQuery-Interface. Es bietet eine grafische Oberfläche für alle Query-Befehle und macht das Erlernen der rohen Query-Syntax überflüssig.
+
+- **Autor:** Janni „Яedeemer" K. (Norddeutschland)
+- **Sprache:** Geschrieben in Delphi 2009 (über 50.000 Zeilen Quelltext)
+- **Entwicklungsbeginn:** 10. April 2011
+- **Erstveröffentlichung:** 29. Juni 2011
+- **Lizenz:** Kostenlos und voll funktionsfähig (keine Adware/Spyware)
+- **Plattformen:** Windows XP und neuer, Linux mittels Wine
+- **Größe:** ~1,3 MiB Installer
+- **Enthaltene Sprachen:** Deutsch und Englisch (Auswahl während der Installation)
+- **Unterstützte Server:** TeamSpeak 3.9.0 bis 3.13.7, TeaSpeak 1.4.10-beta
+- **Download:** https://dl.yat.qa/stable/
+- **Website:** https://yat.qa/
+
+### Motto
+*„Dinosaurier haben kein TeamSpeak benutzt und sind vor 66 Millionen Jahren ausgestorben. Zufall? Vermutlich nicht."*
+
+---
+
+## Funktionen
+
+**YaTQA unterstützt alle ServerQuery-Funktionen ohne Ausnahme.** Die folgende Liste beschränkt sich auf Funktionen, die der normale TS-Client nicht bietet.
+
+### Allgemeine Funktionen (Kein Admin erforderlich)
+
+- **DNS-Auflösung:** Detaillierte Visualisierung der DNS-Auflösung (simuliert 10 verschiedene Client-Versionen)
+- **Blacklist-Prüfung:** TeamSpeaks Blacklist auf eine IP überprüfen
+- **Blacklist2:** TeamSpeaks Blacklist2 für virtuelle Server prüfen
+- **Benutzerdiagramm:** Serverstatistiken von Planet TeamSpeak als Diagramm anzeigen und als PNG speichern
+- **Client-Cache:** Avatare, Icons und Chatlogs im Client-Cache finden
+
+### Konsole (Query-Interface)
+
+- **Autovervollständigung:** Befehlsvervollständigung einschließlich undokumentierter Befehle
+- **Parameterhilfe:** Zeigt alle Parameter eines Befehls basierend auf eigener Forschung
+- **Werteauswahl:** Strg+Leertaste für Werteliste
+- **Ergebnisanalyse:** Gruppierte Datensätze mit Erklärungen
+- **Skripting:** Befehlslisten aus Dateien laden und ausführen
+- **Events:** Server-Events abonnieren und in der Konsole protokollieren
+
+### SSH-Tunnel
+
+- **Verschlüsselung:** Vollständig verschlüsselte Verbindung (außer Dateiübertragungen)
+- **Geschwindigkeit:** Auf vielen Servern merkbar schneller (ähnlich wie `tcp_nodelay`)
+- **Privatsphäre:** IP wird immer verborgen (man erscheint als 127.0.0.1)
+- **Flood-Umgehung:** Umgeht alle Flood-Beschränkungen (127.0.0.1 steht üblicherweise auf der Whitelist)
+
+### Instanz-Funktionen (Erfordert serveradmin)
+
+- Instanzstatistiken anzeigen/bearbeiten
+- Lizenzdetails und IP-Bindings anzeigen
+- Alle virtuellen Server anzeigen
+- Lokale Notizen zu Servern erstellen (lokal gespeichert)
+- Virtuelle Server starten/stoppen/erstellen/löschen/umbenennen
+- Unsichtbar werden (Server-Fehler, könnte behoben werden)
+- Nachricht an alle Server senden
+- Snapshots erstellen/massenweise erstellen/wiederherstellen (inkl. Dateien)
+- Manipulierte Snapshots einspielen
+- Server mittels Snapshots kopieren
+- Rechte auf Vorlagengruppen zurücksetzen
+- Channel-Datei-Backups speichern/wiederherstellen (inkrementelles Backup unterstützt)
+
+### Funktionen für virtuelle Server
+
+- Host-Message-Modal-Quit und hohe Sicherheitsstufe ignorieren
+- Sehr detaillierte Serverstatistiken
+- Mehrere Server gleichzeitig bearbeiten
+- Ausklappbarer Serverbaum (optional immer im Vordergrund)
+- Mehrere Nutzer gleichzeitig verschieben/kicken/bannen/beschreiben
+- Mehrere Channel gleichzeitig erstellen
+- Channel als Vorlage für weitere verwenden
+- Mehrere Channel gleichzeitig bearbeiten
+- Nachrichten an mehrere Nutzer/Channel gleichzeitig senden
+- Rechte mehrerer Nutzer/Channel gleichzeitig bearbeiten
+- Dateien zwischen Channeln verschieben
+- Bildvorschau ohne Download (bmp, gif, jpg, png, pbm, pgm, ppm, xbm, xpm)
+- Upload/Download ganzer Ordnerstrukturen
+- Nutzer zu Gruppen hinzufügen durch Namenseingabe
+- Funktionierende Rechteübersicht mit Echtzeitbearbeitung
+- Rechte zwischen Servern/Instanzen kopieren
+- Rechtewerte und -powers vergleichen
+- Alle Clients/Gruppen mit einem bestimmten Recht finden
+- Mehrere Gruppen gleichzeitig bearbeiten
+- Verbesserte Clientdatenbank mit mehr Details und Suchfunktionen
+- Gesamte Clientdatenbank mit einem Klick herunterladen
+- Clientdatenbank als HTML oder CSV exportieren
+- Gebannte Nutzer und IP-teilende Profile hervorheben
+- Log an beliebiger Stelle lesen
+- User CustomInfo verwalten (suchen, anzeigen, bearbeiten, hinzufügen)
+- Log als HTML oder TXT exportieren
+- Avatare und Icons herunterladen
+- Avatar-Besitzer auf dem Server identifizieren
+- Servervorlage verwalten
+- Uploads/Downloads überwachen
+
+### Unterstützte Bildformate
+
+| Format | Beschreibung |
+|--------|-------------|
+| bmp | Windows Bitmap |
+| gif | Graphics Interchange Format |
+| jpg/jpeg | Joint Photographic Experts Group |
+| png | Portable Network Graphics |
+| pbm | Portable Bitmap (ASCII und binär) |
+| pgm | Portable Graymap (ASCII und binär) |
+| ppm | Portable Pixmap (ASCII und binär) |
+| xbm | X BitMap |
+| xpm | X PixMap |
+
+---
+
+## Architektur / Funktionsweise
+
+### Verbindungsmethoden
+- **Raw TCP/Telnet:** Standard-Query-Verbindung (Standardport 10011)
+- **YaTQA-SSH-Tunnel:** Über Plink (PuTTY-Suite) — verschlüsselt, schneller, IP verborgen
+- **TeamSpeak SSH:** Natives TS3.3+-SSH (auch unterstützt, aber weniger Vorteile)
+
+### Datenspeicherung
+- **Portable Modus:** Alle Daten im Installationsverzeichnis (`yatqa.ini` vorhanden)
+- **Standardmodus:** Einige Dateien in `%APPDATA%\YaTQA`
+- **Icon-Cache:** 16-Bit-RES-Format (`icons.res`)
+- **Befehlsverlauf:** `commandhistory.txt`
+- **Debug-Log:** `RedeemerTS3.log` (erstellt mit `-debug`-Schalter)
+
+### DNS-Auflösung
+YaTQA simuliert die Auflösungsschritte des TeamSpeak-Clients und zeigt sie visuell an. Verwendet Googles DNS-Server für Zuverlässigkeit. Unterstützt:
+- A- und CNAME-Einträge
+- SRV-Einträge
+- TSDNS-Auflösung
+- Alle 10 verschiedenen Client-Version-DNS-Verhaltensweisen
+
+### Snapshot-System
+- Snapshots enthalten alle Servereinstellungen (außer Port und Server-ID)
+- Snapshots enthalten KEINE Dateien, Icons oder Avatare
+- Datei-Backups enthalten Dateien und Icons (keine Avatare wegen Serverbeschränkungen)
+- Pseudo-Snapshots ermöglichen Serverkopien ohne Keypair
+- Unterstützt Zstd-komprimierte Snapshots (3.10.0+-Format)
+
+### Anti-Flood-Schutz
+- Konfigurierbare „Befehle bis Flood"-Einstellung (empfohlen: ~20)
+- Konfigurierbare Verzögerung zwischen Befehlen (empfohlen: 340ms für fremde Server)
+- SSH-Verbindungen umgehen Flood-Beschränkungen (127.0.0.1 auf Whitelist)
+
+---
+
+## Konfiguration
+
+### Anwendungseinstellungen
+
+| Einstellung | Beschreibung |
+|------------|-------------|
+| Verbesserte XP-Unicode-Anzeige | Verwendet Arial Unicode MS für bessere CJK-Unterstützung |
+| Daten bei Tabwechsel aktualisieren | Automatisch Daten aktualisieren |
+| Lokale Zeit verwenden | Lokale Zeit statt UTC |
+| Verbesserte Channel-Dropdowns | Baumansicht für Unterchannel |
+| In den Tray minimieren | Minimieren in den Systemtray |
+| Tray-Icon immer anzeigen | Permanent anzeigen |
+| Icon-Caching aktivieren | Icons in `icons.res` cachen (empfohlen) |
+| Keine Icons verwenden | Icon-Anzeige deaktivieren |
+| Windows Aero verwenden | Aero-Design nutzen (Vista+) |
+| Aero-Glow deaktivieren | Weißen Schatten hinter Menütext entfernen |
+| Beim Start nach Updates suchen | Automatisch nach Updates suchen |
+| Sortiereinstellungen speichern | Sortierpräferenzen merken |
+| Sprunglisten aktivieren | Windows 7+-Sprunglisten-Integration |
+
+### Kompatibilitätseinstellungen
+
+| Einstellung | Beschreibung |
+|------------|-------------|
+| Befehle bis Flood | Verzögerung zwischen Befehlen (340 empfohlen für fremde Server) |
+| Nicht-Standard-Query-Port erlauben | Verbindung zu anderen Ports als 10011 |
+| Löschen wichtiger Gruppen erlauben | Löschen der ersten 5 Server-/4 Channelgruppen erlauben |
+| Verlassen wichtiger Gruppen erlauben | serveradmin darf Admin Server Query verlassen |
+| Machine-ID ändern erlauben | Änderung der Machine-ID ermöglichen |
+
+### SSH-Tunnel-Profile
+SSH-Profile für Server konfigurieren. Bei Verbindung zu einem Server mit passendem SSH-Profil verwendet YaTQA automatisch den Tunnel.
+
+### Kreisdiagramm-Styles
+Auswahl aus 4 verschiedenen Kreisdiagramm-Styles (durch Benutzerabstimmung ausgewählt).
+
+---
+
+## Startparameter
+
+| Parameter | Beschreibung |
+|-----------|-------------|
+| `-a` | Verbindung zum Standardserver |
+| `-b [IP]` | Blacklist-Prüfung |
+| `-c IP Query_Port [User Pass [Voice_Port]]` | Verbindung zum angegebenen Server |
+| `-d` | DNS-Auflösung |
+| `-i` | Iconsammlung |
+| `-p` | Rechtedateien-Editor |
+| `-s [IP]` | Benutzerstatistik |
+| `-debug` | Debug-Logging aktivieren |
+
+---
+
+## Systemanforderungen
+
+### Mindestanforderungen
+- **Betriebssystem:** Windows XP+ (Desktop), Windows 2012+ (Server)
+- **Speicher:** 3 MB für YaTQA (mehr für Konfiguration/Snapshots)
+- **Auflösung:** 960×720 (allgemein), 1024×720 (Serverbaum), 1024×768 (Konsole)
+
+### Fehlende Funktionen unter Windows XP
+- Geist-Modus
+- Nameserver für DNS-Auflösung ändern
+- Einklappbare DNS-Ergebnisse
+- Einklappbare Gruppen im Servergruppenmodus der Benutzer-DB
+
+### Fehlende Funktionen unter Windows Vista/XP
+- Sprunglisten
+
+### Wine/Linux-Einschränkungen
+- Speicherlecks (Wine unterstützt kein Entfernen von Link-Labels)
+- Auch unter XP fehlende Funktionen fehlen unter Wine
+- Zusätzliche Einschränkungen: Keine Array-Gruppierung, keine DNS-Gruppierung, kein Servergruppenmodus in der Benutzer-DB
+- Plink muss manuell installiert werden (Version 0.61+)
+
+---
+
+## Schlüsselkonzepte
+
+### ServerQuery-Interface
+Das TeamSpeak-3-ServerQuery-Interface ist ein textbasiertes Protokoll zur Serververwaltung. YaTQA kapselt diese Schnittstelle in einer GUI mit:
+- Befehlsautovervollständigung
+- Parameterhilfe
+- Werteauswahl
+- Ergebnisanalyse
+
+### Virtueller Server
+Ein virtueller Server ist eine unabhängige TeamSpeak-Serverinstanz, die auf einem einzelnen physischen Serverprozess läuft. Mehrere virtuelle Server können auf einer Instanz laufen.
+
+### Instanz
+Der Serverprozess, der einen oder mehrere virtuelle Server hostet. Verwaltet über den „serveradmin"-Account.
+
+### Snapshot
+Ein vollständiges Backup der Einstellungen eines virtuellen Servers (ohne Port und ID). Enthält keine Dateien, Icons oder Avatare.
+
+### Pseudo-Snapshot
+Ein vom Benutzer manipulierter Snapshot, der zum Kopieren von Servern ohne Beibehaltung des originalen Keypairs verwendet werden kann.
+
+### Rechtesystem
+TeamSpeak verwendet ein hierarchisches Rechtesystem mit:
+- Servergruppen
+- Channelgruppen
+- Client-Rechte
+- Rechte-Powers (Werte, die steuern, was gesetzt werden kann)
+
+### Anti-Flood
+TeamSpeak-Server begrenzen die Häufigkeit von Query-Befehlen. YaTQA bietet konfigurierbare Verzögerungen und „Befehle bis Flood"-Einstellungen, um Bans zu vermeiden.
+
+### Blacklist / Blacklist2
+TeamSpeak führt Blacklists gebannter IPs (Blacklist1) und Server-UIDs (Blacklist2).
+
+### Abzeichen
+Visuelle Indikatoren im TeamSpeak, die Benutzerstatus, Addon-Creator-Status usw. anzeigen. YaTQA kann Abzeichen konfigurieren.
+
+### DNS-Auflösung
+TeamSpeak-Clients lösen Serveradressen über mehrere Methoden auf: A-Einträge, CNAME, SRV-Einträge und TSDNS. YaTQA visualisiert diesen Prozess.
+
+---
+
+## Bekannte Einschränkungen
+
+- **Channel-Passwörter:** YaTQA sendet grundsätzlich keine Channel-Passwörter. Erfordert `b_channel_join_ignore_password` und `b_ft_ignore_password`-Rechte.
+- **Unicode:** Nur Basic Multilingual Plane (BMP) unterstützt (TeamSpeak-Einschränkung).
+- **Integrierte DNS-Auflösung:** Nur A- und CNAME-Einträge (TSDNS und SRV im integrierten Resolver nicht unterstützt).
+- **Geist-Modus:** Viele Funktionen funktionieren nicht; Geist hat nur Query-Gast-Rechte.
+- **Konsole:** Nur die üblichen Einschränkungen des TS3-Servers.
+
+---
+
+## IPv6-Unterstützung
+
+Eckige Klammern `[]` um die Serveradresse schreiben. Unterstützt seit v1.4/2.0-pre für Query-Verbindungen. IPv4-Tunnel (z.B. `[::ffff:7f00:1]`) werden nicht unterstützt.
+
+---
+
+## Projekthistorie
+
+- **10.04.2011:** Entwicklungsbeginn (ursprünglich „TS3Telnet" genannt)
+- **29.06.2011:** Erste Alpha-Version veröffentlicht
+- **18.04.2014:** v2.0 führte Registrierungserfordernis für einige Funktionen ein
+- **22.08.2019:** YaTQA wieder uneingeschränkt Freeware
+- **01.03.2023:** v3.9.9b veröffentlicht (Zeitlimit dauerhaft entfernt)
+
+### Namensherkunft
+„Yet Another TeamSpeak³ Query App" — benannt, weil es beim Entwicklungsbeginn bereits viele Query-Tools gab, aber keines auf dem Rechner des Autors funktionierte.
+
+### Aussprache
+[jatka] in IPA-Lautschrift — auch als deutsches Wort aussprechbar.
+
+---
+
+## Globale Tastenkürzel
+
+| Kürzel | Aktion |
+|--------|--------|
+| Strg+F | Filtern (Rechte, Log) oder Suchen |
+| Strg+Alt+F | In Listen suchen |
+| F3 | Weiter suchen |
+| Strg+A | Alles auswählen |
+| Strg+C | Kopieren oder ausgewählte Daten speichern |
+| Strg+Alt+A | Spalten automatisch anpassen |
+| F2 | Umbenennen |
+| F5 | Tab aktualisieren |
+| NUM + | Ausgewählte Checkbox-Elemente aktivieren |
+| NUM - | Ausgewählte Checkbox-Elemente deaktivieren |
+| Strg+Leertaste | Parameterwert auswählen (Konsole) |
+| Strg+E | Ausgewählten Text escapen (Konsole) |
+| Strg+S | Diagramm als Bild speichern |
+
+---
+
+## Ressourcen
+
+- **Website:** https://yat.qa/
+- **Download:** https://dl.yat.qa/stable/
+- **Funktionen:** https://yat.qa/funktionen/
+- **Anleitung:** https://yat.qa/manual/ (nur Englisch)
+- **Changelog:** https://yat.qa/changelog/ (nur Englisch)
+- **FAQ:** https://yat.qa/haeufige-fragen/
+- **Support:** https://yat.qa/unterstuetzung/
+- **Ressourcen:** https://yat.qa/ressourcen/
+- **Über:** https://yat.qa/ueber/
+
+---
+
+## Übersetzung
+
+YaTQAs Originalsprache ist Deutsch. Die Übersetzung erfolgt mit OmegaT und XLIFF-Dateien. Den Autor vorher kontaktieren. Das Übersetzungssystem verwendet:
+- `%s` — Zeichenketten-Platzhalter
+- `%d` — Dezimalzahl-Platzhalter
+- `&` — Tastenkürzel
+- `&&` — Tatsächliches Kaufmanns-Und
+- `|` — Senkrechter Strich (Hinweistext-Trennzeichen)
+- `\r\n` — Neue Zeile
+- `\t` — Tabulator