Browser-Erweiterung

#Einrichten

1. Lege in Flowplan unter Einstellungen → API & KI-Assistenten (oder Einstellungen → Web-Clipper → Token anlegen) ein persönliches API-Token an und wähle als Recht Nur Browser-Erweiterung. Ein solches Token kann nichts anderes: Es öffnet weder die API noch MCP und kann nichts lesen außer der Liste deiner Ziele.
2. Installiere die Erweiterung (siehe unten) und klicke auf ihr Symbol.
3. Trage die Adresse deiner Instanz ein, zum Beispiel https://flowplan.example.com, und das Token. Der Browser fragt jetzt einmal nach dem Zugriff auf genau diese Adresse – auf andere Seiten greift die Erweiterung nie zu.

Abmelden im Fenster der Erweiterung löscht das Token aus dem Browser und gibt den Zugriff auf die Instanz wieder ab. Widerrufen kannst du das Token jederzeit in den Einstellungen.

#Speichern

Klicke auf das Symbol der Erweiterung oder drücke Alt+Umschalt+F. Wähle das Ziel – die Erweiterung merkt es sich – und optional Tags:

• Ganze Seite: Die Erweiterung sucht den eigentlichen Artikel und lässt Navigation, Werbung, Cookie-Hinweise, Kommentare und Seitenleisten weg. Links und Bilder zeigen weiter auf die Originalseite. Oben auf der neuen Seite steht der Link zur Quelle.
• Auswahl: Nur der markierte Teil der Seite, mit Formatierung und Links.
• Nur Lesezeichen: Titel, Adresse, Beschreibung und Favicon landen in der Datenbank Lesezeichen des Bereichs (siehe Web-Clipper). Doppelte Links werden abgelehnt.

Je nach Ziel entsteht:

Tags landen in einer Eigenschaft namens Tags (oder Schlagwörter, Labels), wenn die Datenbank eine hat; neue Tags werden als Optionen ergänzt. In der Lesezeichen-Datenbank legt die Erweiterung die Eigenschaft Tags beim ersten Mal an. Auf Seiten stehen die Tags als #tag unter dem Quell-Link.

Der Inhalt wird auf dem Server noch einmal bereinigt: Skripte, Formulare, eingebettete Fremdseiten und Ereignis-Attribute fallen weg, so wie beim Einfügen in den Editor.

#Markierungen

Markiere Text auf einer Webseite und wähle im Kontextmenü In Flowplan markieren (oder drücke Alt+Umschalt+H). Die Stelle wird als Zitat mit einem Link zur Quelle angehängt:

• Ist das Ziel eine Seite, landen alle Markierungen untereinander auf dieser Seite.
• Ist das Ziel ein Bereich, legt die erste Markierung einer Webseite eine neue Seite für diese Quelle an; weitere Markierungen derselben Webseite kommen auf dieselbe Seite.
• Ist das Ziel eine Datenbank, wird jede Markierung ein Eintrag.

Ein grünes Häkchen am Symbol bestätigt das Speichern, ein rotes Ausrufezeichen meldet einen Fehler (etwa ein abgelaufenes Token).

Die Tastenkürzel änderst du in Chrome unter chrome://extensions/shortcuts, in Firefox unter Add-ons → Zahnrad → Tastenkombinationen für Erweiterungen verwalten.

#Installieren

Die Erweiterung liegt im Quellcode unter extensions/browser/ und braucht keinen Build-Schritt.

• Chrome, Edge, Brave: chrome://extensions öffnen, Entwicklermodus einschalten, Entpackte Erweiterung laden und den Ordner extensions/browser wählen.
• Firefox: about:debugging#/runtime/this-firefox öffnen und Temporäres Add-on laden → extensions/browser/manifest.json. Für eine dauerhafte Installation die ZIP-Datei bei addons.mozilla.org signieren lassen.
• Paket bauen: npm run extension:zip schreibt extensions/browser/dist/flowplan-<version>.zip – diese Datei lädst du im Chrome Web Store, bei Edge Add-ons oder addons.mozilla.org hoch.

#Datenschutz und Rechte

• Die Erweiterung liest eine Seite nur, wenn du sie aufrufst (Symbol, Kontextmenü oder Tastenkürzel) – sie läuft nicht im Hintergrund auf jeder Seite mit.
• Rechte: activeTab (die aktuelle Seite, nur nach deinem Klick), scripting (um sie dann zu lesen), contextMenus, storage (Adresse, Token, zuletzt gewähltes Ziel) und der Zugriff auf genau deine Flowplan-Adresse, erst beim Verbinden erfragt.
• Sie sendet nur an deine Instanz. Cookies werden nicht mitgeschickt; die Anmeldung ist allein das Token.
• Ende-zu-Ende-verschlüsselte Bereiche erscheinen nicht als Ziel: Der Server schreibt nie Klartext hinein.
• Der Server erlaubt Anfragen von Browser-Erweiterungen (CORS) nur für die beiden Clipper-Adressen /api/clipper/targets und /api/clipper/save und nur mit Token – siehe API und Webhooks.