Dovecot trennt mit „.“: „uptimerobot.com“ wurde zu com unter einem nicht existierenden „uptimerobot“, Verschieben scheiterte mit TRYCREATE. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| _locales/de | ||
| icons | ||
| scripts | ||
| src | ||
| tests | ||
| .gitignore | ||
| manifest.json | ||
| package.json | ||
| README.md | ||
FlessingLabs MailLotse
Thunderbird-Add-on (MailExtension, Manifest V3) für viele bereits eingerichtete Mailkonten. Zielversion: Thunderbird 159 (64-Bit) unter Linux.
MailLotse prüft beim Start von Thunderbird alle neuen und seit dem letzten Lauf ungeprüften Mails und danach jede neu eintreffende Mail. Es zeigt in einem eigenen Tab „Wichtige Mails“, was zu tun ist, und räumt Werbung und Spam auf, und zwar immer im Konto der jeweiligen Mail. Den Mailabruf übernimmt weiter Thunderbird mit den vorhandenen Kontoeinstellungen.
Funktionen
- Automatischer Startlauf (
runtime.onStartup) und Verarbeitung neuer Mails (messages.onNewMailReceived, nach Thunderbirds Filtern und Junk-Erkennung). Alle 30 Minuten gibt es einen Kontrolllauf, fehlgeschlagene Konten werden nach 5 Minuten erneut versucht. - Bestandslauf (manuell) über alle Ordner außer Papierkorb, Junk, Gesendet, Entwürfe und Vorlagen.
- Status pro Konto: Prüfstatus, letzte erfolgreiche Prüfung, Fehler. Jedes Konto läuft für sich mit eigenem Zeitlimit, ein nicht erreichbares Konto hält die anderen nicht auf.
- Keine Doppelarbeit: Jede Mail wird über Konto + Message-ID erkannt. Wiederholte Abrufereignisse lösen weder eine zweite KI-Anfrage noch eine zweite Aktion aus.
- Statusseite „Wichtige Mails“ mit den Bereichen Handlungsbedarf, Wichtige neue Mails, Warten auf Antwort und Zur Prüfung. Zu jeder Mail stehen dort Konto, Absender, Betreff, der Grund der Einstufung und eine ausdrücklich genannte Frist. Ein Klick öffnet die Originalmail. Die Ansicht lässt sich nach Konto filtern. Einträge kann man erledigen, zurückstellen oder auf Wiedervorlage setzen, und sie bleiben sichtbar, auch wenn die Mail gelesen wurde. Wiedervorlage geht auch per Rechtsklick in der Mailliste.
- Reihenfolge: Kontopriorität (hoch/normal/niedrig) plus Dringlichkeit. Eine konkrete Frist für morgen in einem niedrig priorisierten Konto steht vor einer Mail ohne Frist aus einem hoch priorisierten Konto.
- Spam: Thunderbird-Junk-Markierung und Rspamd-Header des eigenen Mailservers. Diese Header zählen nur, wenn der oberste
Received-Header von einem eingetragenen Server stammt. Eindeutiger Spam kann in den Junk-Ordner des Kontos verschoben werden, unklare Fälle kommen auf „Zur Prüfung“. - Werbung & Angebote: Newsletter mit Abmeldelink und Werbebegriffen. Rechnungen, Bestellungen, persönliche und wichtige Mails sind von der Werbesortierung ausgenommen.
- Regeln: gemeinsame Standardregeln mit Überschreibungen pro Konto (aktiv, automatisch). Sie starten im Vorschaumodus: Geplante Aktionen stehen mit Grund und Zielordner pro Konto da, einzelne Treffer lassen sich abwählen. Automatisches Verschieben schaltest du je Regel und je Konto ausdrücklich ein, und es greift nur bei eindeutiger lokaler Einstufung. Der Papierkorb ist die letzte Stufe, gelöscht wird nie.
- Spam-Button an jeder Mail in der Übersicht: Die Mail kommt sofort in den Junk-Ordner ihres Kontos und wird in Thunderbird als Junk markiert (bei IMAP mit Junk-Schlagwort, Mailserver können daraus lernen). MailLotse merkt sich den Absender. Bei zwei Absendern derselben Domain merkt es sich die ganze Domain, außer bei Freemail-Anbietern und eigenen Domains. Weitere offene Mails dieses Absenders werden sofort nachsortiert. Ein Klick auf „Rückgängig“ verschiebt die Mail zurück und vergisst den Absender. „In Ordnung“ bei Spam-Verdacht merkt sich den Absender als kein Spam. Gelerntes lässt sich in den Einstellungen ansehen und löschen. Bei Konten mit OpenRouter-Freigabe bekommt die KI die letzten Korrekturen dieses Kontos als Beispiele.
- Unwichtig (veraltet): Einträge zu Mails von vor dem 01.01.2026 und zu Mails, deren Frist seit über 14 Tagen abgelaufen ist, stehen eingeklappt in einem eigenen Bereich am Ende der Übersicht, auch wenn sie Handlungsbedarf hätten. Verschoben wird dabei nichts. „Doch wichtig“ holt einen Eintrag zurück, Wiedervorlagen sind ausgenommen. „Alle aus der Liste entfernen“ räumt den Bereich leer. Beide Grenzen lassen sich unter Einstellungen → Prüfläufe ändern oder abschalten.
- Altbestand bleibt schlank: Für Mails vor dem Stichtag legt der Bestandslauf keine Übersichtseinträge an. Er lädt ihren Inhalt nur bei Newslettern herunter, für die Werbeerkennung. Spam- und Werbe-Aktionen plant er trotzdem.
Leistung
- Höchstens 4 Konten werden gleichzeitig geprüft.
- Speichervorgänge innerhalb einer Sekunde werden zusammengefasst, die Oberfläche wird höchstens alle 2 Sekunden benachrichtigt. Ein im Hintergrund liegender Tab lädt erst beim Zurückwechseln neu.
- Die Übersicht zeichnet je Bereich 50 Karten („Weitere anzeigen“), die Aufräumen-Tabelle 200 Zeilen. Ausgeführt werden trotzdem alle ausgewählten Aktionen.
- Ausgeführte Aktionen werden nach 30 Tagen aus der Liste entfernt. Im Index bleibt vermerkt, dass die Regel schon gewirkt hat.
- Zurückholen („Keine Werbung“): Falsch einsortierte Mails holst du unter „Aufräumen“ zurück (Button bei Vorschau und bei ausgeführten Werbe-/Spam-Aktionen) oder direkt in Thunderbird per Rechtsklick in der Mailliste → „MailLotse: Keine Werbung – zurückholen …“. Im Dialog wählst du den Zielordner: Vorgeschlagen ist der Ordner, aus dem die Mail kam, zur Wahl stehen nur Ordner desselben Postfachs, oder du legst einen neuen Ordner an, direkt im Postfach oder als Unterordner. MailLotse merkt sich den Absender als „keine Werbung“ (in den Einstellungen sichtbar und löschbar). Auf Wunsch legt es eine Regel „Absender → Ordner“ nur für dieses Postfach an, die wie jede neue Regel in der Vorschau startet.
- „In Ordner …“ an jedem Eintrag: Die Mail kommt in einen bestehenden oder neuen Ordner desselben Postfachs und der Eintrag gilt als erledigt. Danach verschiebt keine Regel sie mehr. Auf Wunsch entsteht eine Regel „Absender → Ordner“ (startet in der Vorschau). Spam-Button und „In Ordner …“ gibt es auch bei empfangenen Mails unter „Warten auf Antwort“, nur nicht bei eigenen gesendeten.
- „Weitere Mails genauso behandeln?“: Nach „Spam“, „In Ordner …“ oder „Zurückholen“ sucht MailLotse weitere Mails desselben Absenders im selben Postfach, ohne Papierkorb, Junk, Gesendet und den Zielordner, höchstens 200. Es zeigt sie zum Abhaken an. Verschoben wird erst nach Bestätigung, jede Mail einzeln mit Kontoprüfung.
- Als gelesen markieren: Standard „Nur aussortierte“, also Spam, Werbung und veraltete Mails. Mit „Alles ohne offenen Eintrag“ wird alles gelesen markiert, was nicht in „Wichtige Mails“ auf dich wartet. Mails mit offenem Eintrag bleiben ungelesen, bis du sie mit „Erledigt“ abhakst (abschaltbar). Einstellung unter Prüfläufe.
- Fehlende Zielordner anlegen: Buttons unter „Aufräumen“ und „Konten“ legen von Regeln benötigte Ordner wie „Werbung & Angebote“ im jeweiligen Postfach an. Optional geht das auch automatisch (Einstellung „Fehlende Zielordner automatisch anlegen“). Junk und Papierkorb legt MailLotse nie an.
- Regeln in Alltagssprache: Ein lokaler Übersetzer versteht einfache Sätze, OpenRouter (falls eingerichtet) auch freiere Formulierungen. Die erzeugte Regel wird mit Bedingungen und Aktion angezeigt und erst nach Bestätigung übernommen.
Postfächer bleiben getrennt
Die Statusseite ist nur eine Ansicht auf die Originalnachrichten. Erzwungen wird das im Code an einer einzigen Stelle (src/lib/folders.js):
- Zielordner (Werbung, Junk, Papierkorb) werden nur unter den Ordnern des Quellkontos gesucht. Fehlt ein Ziel oder ist es mehrdeutig, wird die Aktion für dieses Konto mit Begründung übersprungen und unter „Aufräumen“ angezeigt.
- Neue Ordnernamen dürfen kein „.“ und kein „/“ enthalten, weil viele Server (z. B. Dovecot) damit Unterordner trennen: aus „uptimerobot.com“ würde „com“ unter einem nicht existierenden „uptimerobot“. Die Oberfläche schlägt dann „uptimerobot-com“ vor. Legt der Server trotzdem etwas anderes an als gewünscht, verschiebt MailLotse nicht dorthin.
- Bei mehrdeutigen Zielen (z. B.
/Trashund/INBOX/Trash, beide als Papierkorb markiert) legst du unter „Aufräumen“ einmal pro Postfach fest, welcher Ordner gilt. Die übersprungenen Aktionen kommen danach zurück in die Vorschau. moveWithinAccountliest vor jeder Verschiebung den aktuellen Ort der Nachricht neu und bricht ab, wenn Nachricht, Zielordner und Konto nicht zusammenpassen (AccountBoundaryError).- Die KI liefert nur Kategorie, Grund und Frist. Ordnerwahl und Verschiebungen entscheidet ausschließlich der lokale Regelcode.
OpenRouter (optional)
- Einstellungen: API-Schlüssel, Modell, Verbindungstest, Zero Data Retention (Standard: an, sendet
provider: { zdr: true, data_collection: "deny" }). - Freigabe pro Konto: Aus (Standard), Absender und Betreff, zusätzlich kurzer Textauszug (höchstens 600 Zeichen). Anhänge werden nie übertragen.
- Thunderbird fragt beim Einschalten nach der optionalen Datenfreigabe „Persönliche Kommunikation“. Ohne diese Freigabe wird nichts gesendet.
- Gefragt wird nur bei lokal unklaren Fällen. Mailtexte gehen als JSON-Daten mit der Anweisung raus, darin enthaltene Befehle zu ignorieren. Antworten werden streng gegen ein festes Schema geprüft und andernfalls verworfen.
- Bei API-Fehlern laufen die lokalen Regeln weiter. Der Fall bleibt unter „Zur Prüfung“ sichtbar und wird später automatisch erneut versucht.
- Der API-Schlüssel liegt nur im Thunderbird-Profil (
storage.local). Er steht weder im Repository noch in Logs, und auch die Oberfläche bekommt ihn nicht zu sehen.
Installation
- Bauen (siehe unten) oder die fertige
dist/maillotse-0.9.1.xpiverwenden. - Thunderbird → Extras → Add-ons und Themes → Zahnrad → Add-on aus Datei installieren … →
.xpiauswählen. - Die Berechtigungen bestätigen. MailLotse läuft dann sofort einen ersten Startlauf (Mails der letzten 3 Tage). Ein Update installierst du genauso, die Einstellungen und das Gelernte bleiben dabei erhalten.
- Der Button MailLotse in der Werkzeugleiste öffnet den Tab „Wichtige Mails“.
Die .xpi ist nicht von Mozilla signiert. Thunderbird installiert sie trotzdem, eventuell mit Warnhinweis.
Einrichtung
- Einstellungen (im Tab oben rechts oder unter Add-ons → MailLotse → Einstellungen):
- Konten: Priorität setzen, nicht gewünschte Konten deaktivieren. Automatische Aktionen und OpenRouter bleiben zunächst aus.
- Rspamd: Häkchen setzen und den eigenen Server eintragen, so wie er im
Received: … by <server>steht (z. B.mx.example.de). Der Server muss X-Spamd-/X-Rspamd-Header von außen entfernen oder überschreiben. - Werbeordner: Unter „Wichtige Mails → Konten“ mit „Regelordner anlegen“ einrichten oder in den Einstellungen das automatische Anlegen einschalten.
- Wichtige Mails → Konten → „Bestand aller aktiven Konten prüfen“ startet den Bestandslauf für den Altbestand.
- Aufräumen (Vorschau) prüfen, falsche Treffer abwählen, „Ausgewählte ausführen“.
- Wenn die Vorschau stimmt: In den Einstellungen bei der Regel „Automatisch ausführen“ wählen und beim Konto „Automatische Aktionen“ einschalten.
Erster Test (etwa 10 Minuten)
- Zwei Testkonten wählen, zum Beispiel ein Familien- und ein eBay-Postfach. Das eine auf Priorität hoch setzen, das andere auf niedrig. Nur im ersten Konto „Werbung & Angebote“ anlegen.
- Testmails schicken: eine an das niedrig priorisierte Konto mit „Deine Rückgabefrist endet morgen“, eine normale persönliche Mail an das hohe Konto und einen Newsletter mit Abmeldelink an beide Konten.
- „Wichtige Mails“ öffnen: Die Rückgabefrist steht oben unter Handlungsbedarf, mit Frist „morgen fällig“.
- „Aufräumen“: Der Newsletter im ersten Konto zielt auf dessen „Werbung & Angebote“. Im zweiten Konto steht „Zielordner fehlt in diesem Konto“.
- Ausführen und in Thunderbird prüfen, dass jede Mail in ihrem eigenen Konto liegt.
- Optional: OpenRouter-Schlüssel eintragen, „Verbindung testen“, ein Konto auf „Absender und Betreff“ stellen.
Entwicklung
npm test # Unit- und Ablauftests mit simulierter Thunderbird-API (Node ≥ 20)
npm run check # Syntax, API-Abgleich gegen die installierten Thunderbird-Schemas, Schlüssel-Scan
npm run lint # web-ext lint (meldet Thunderbird-Berechtigungen als „unbekannt“ – erwartbar)
npm run build # reproduzierbarer Build nach dist/maillotse-<version>.xpi (gibt SHA-256 aus)
npm run smoke # Abnahme im echten Thunderbird: temporäres Profil, headless, zwei Testkonten
npm run smoke legt ein Wegwerfprofil mit zwei POP3-Testkonten ohne Server an und importiert die synthetischen Mails aus tests/smoke/. Dann prüft es Startlauf, Priorität und Frist, Vorschau und Verschiebung innerhalb des Kontos, den Bestandslauf, die Oberflächen und einen zweiten, normalen Thunderbird-Start. Das eigene Profil bleibt unberührt. Thunderbird darf dabei nicht laufen, weil der Test mit --no-remote startet.
Aufbau
| Datei | Aufgabe |
|---|---|
src/background.js |
Ereignisse (Start, neue Mail, Alarm, Menü), Nachrichten von der Oberfläche |
src/lib/engine.js |
Läufe, Dedup, Einträge, Vorschau, Aktionen, Kontostatus |
src/lib/classify.js |
lokale Einstufung, Spam-/Rspamd-Signale |
src/lib/deadline.js |
ausdrücklich genannte Fristen (deutsch) |
src/lib/priority.js |
Sortierung: Frist vor Kontopriorität |
src/lib/rules.js |
Regelmodell, Validierung, lokaler Übersetzer |
src/lib/folders.js |
Zielauflösung im Quellkonto, abgesicherte Verschiebung |
src/lib/openrouter.js |
OpenRouter-Client, Schema-Prüfung |
src/ui/ |
Tab „Wichtige Mails“ und Einstellungen |