KI-AGENT: Gmail-Download mit Debugausgaben erweitern

docs/bedienung/gmail-anhaenge-herunterladen.md

@@ -17,7 +17,8 @@ GMAIL_APP_PASSWORD="dein-app-passwort" \
 python3 scripts/download-gmail-attachments.py \
   --email name@gmail.com \
   --output gmail-anhaenge \
-  --group-by-message
+  --group-by-message \
+  --debug
 ```
 
 Nur Anhänge ab einem bestimmten Datum herunterladen:
@@ -48,12 +49,14 @@ python3 scripts/download-gmail-attachments.py \
   --list-mailboxes
 ```
 
-Wenn `--password` nicht gesetzt ist und `GMAIL_APP_PASSWORD` fehlt, fragt das Skript das Passwort interaktiv ab.
+Wenn `--password` nicht gesetzt ist und `GMAIL_APP_PASSWORD` fehlt, fragt das Skript das Passwort interaktiv ab. Mit `--debug` zeigt das Skript unter anderem den Aufbau der TLS-Verbindung, den erfolgreichen Login, das ausgewählte Postfach, die Suche und die Verarbeitung jeder Mail an. Das Passwort selbst wird nie ausgegeben.
 
 ## Häufige Optionen
 
-- `--mailbox "[Gmail]/All Mail"` durchsucht standardmäßig alle Mails.
+- Ohne `--mailbox` erkennt das Skript das sprachabhängige Gmail-Postfach für alle Nachrichten automatisch.
+- `--mailbox "Postfachname"` überschreibt die automatische Auswahl.
 - `--list-mailboxes` zeigt alle verfügbaren Gmail-IMAP-Postfächer an.
+- `--debug` aktiviert detaillierte Statusausgaben inklusive Login-Erfolg.
 - `--group-by-message` legt pro Mail einen Unterordner an.
 - `--overwrite` überschreibt vorhandene Dateien.
 - `--since YYYY-MM-DD` und `--before YYYY-MM-DD` grenzen den Zeitraum ein.