From a1e04773f475a2eaf069f238e6fff789b4b655d4 Mon Sep 17 00:00:00 2001 From: Friederich Loheide Date: Sat, 3 Oct 2026 06:01:46 +0000 Subject: [PATCH] =?UTF-8?q?Leichte=20Sprache:=20Arbeitsweise=20=E2=80=9EMi?= =?UTF-8?q?t=20Pr=C3=BCfung=E2=80=9C=20mit=20Knopf=20in=20der=20Redaktion?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Neue Einstellung „Arbeitsweise“: „Mit Prüfung“ (Standard) oder „Automatisch für Leser“ - Knopf „Mit KI erstellen“ im Editor: Entwurf aus dem aktuellen, auch ungespeicherten Text (auch vor der Veröffentlichung der Meldung), live mit Abbrechen; Hinweis „KI-Entwurf – noch nicht veröffentlicht“; erst „Speichern“ macht ihn zur Fassung für Leser - Eingefügt wird nur die bereinigte Fassung (Server schickt sie am Ende des Streams), die rohe Modell-Ausgabe nie als HTML - Im Modus „Mit Prüfung“ lösen Leser keine KI aus, es gibt keine Hintergrund-Übertragung und Leser sehen nur geprüfte Texte - Im Modus „Automatisch“ zusätzlich „Zur Prüfung übernehmen“ - Datenschutz-Vorlage beschreibt beide Arbeitsweisen Co-Authored-By: Claude Opus 5.5 (1M context) --- README.md | 7 +- src/lib/admin/AiSettings.svelte | 27 ++- src/lib/admin/EasyLanguageField.svelte | 172 +++++++++++++++--- src/lib/easy-language.ts | 2 + src/lib/server/content.ts | 6 +- src/lib/server/easy-auto.ts | 37 +++- src/lib/server/legal.ts | 4 +- src/lib/settings.ts | 5 +- src/routes/admin/(panel)/+layout.server.ts | 3 + .../(panel)/einstellungen/+page.server.ts | 1 + .../(panel)/meldungen/[id]/+page.server.ts | 2 +- .../admin/(panel)/seiten/[id]/+page.server.ts | 2 +- .../admin/api/leichte-sprache/+server.ts | 55 ++++++ src/routes/api/leichte-sprache/+server.ts | 5 +- 14 files changed, 284 insertions(+), 44 deletions(-) create mode 100644 src/routes/admin/api/leichte-sprache/+server.ts diff --git a/README.md b/README.md index 1a51763..982dca4 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,8 @@ Tablet und Desktop. - Termine & Schließzeiten, gruppiert nach Monat, mit Kalender-Abo (`/termine.ics`) - Ansprechpartner-Verzeichnis, Kontaktformular, Volltextsuche - **Barrierearm:** klare Schrift (Montserrat, selbst gehostet), 3 Schriftgrößen, Hell/Dunkel, - **Leichte Sprache** pro Seite/Meldung – eigene geprüfte Fassung oder automatisch per KI übertragen - (live beim ersten Aufruf bzw. vorab beim Speichern, gekennzeichnet, mit „Fehler melden“) + **Leichte Sprache** pro Seite/Meldung – geprüfte Fassung (auch als KI-Entwurf erstellt) oder, wenn so + eingestellt, automatisch per KI übertragen (gekennzeichnet, mit „Fehler melden“) - **Vorlesen** jeder Seite (Knopf in der Kopfzeile) oder eines Artikels: satzweise, der gelesene Satz wird markiert und mitgescrollt, mit Pause, Satz vor/zurück und langsamem Tempo - **Push-Benachrichtigungen** zu Neuigkeiten und Schließzeiten (Themen frei wählbar, jederzeit abbestellbar) @@ -36,7 +36,8 @@ Tablet und Desktop. Startseiten-Bereiche, Mediathek, Postfach - Text-Editor mit Formatierungen, Links und Bildern - **Leichte Sprache per KI** (Einstellungen): Anbieter Anthropic (Claude), OpenAI, DeepSeek oder Ollama, - Modell wählbar, Schlüssel verschlüsselt gespeichert, Verbindungstest, Tageslimit + Modell wählbar, Schlüssel verschlüsselt gespeichert, Verbindungstest, Tageslimit. Arbeitsweise + **„Mit Prüfung“** (Knopf „Mit KI erstellen“ → Entwurf prüfen → speichern) oder **„Automatisch für Leser“** - Bilder werden automatisch gedreht, verkleinert und als WebP gespeichert - **Benachrichtigungen:** beim Erscheinen einer Meldung (auch zeitgesteuert), automatisch am Vortag einer Schließzeit, oder von Hand – mit Vorschau und Verlauf diff --git a/src/lib/admin/AiSettings.svelte b/src/lib/admin/AiSettings.svelte index b1a909b..00ca844 100644 --- a/src/lib/admin/AiSettings.svelte +++ b/src/lib/admin/AiSettings.svelte @@ -58,12 +58,27 @@
- + + +
+ Arbeitsweise +
+ + +
+
diff --git a/src/lib/admin/EasyLanguageField.svelte b/src/lib/admin/EasyLanguageField.svelte index cb12ee6..840eba6 100644 --- a/src/lib/admin/EasyLanguageField.svelte +++ b/src/lib/admin/EasyLanguageField.svelte @@ -1,40 +1,161 @@ -
- + + + {#if aiReady} + {#if busy} + + {:else} + + {/if} + {/if} +
diff --git a/src/lib/easy-language.ts b/src/lib/easy-language.ts index 5e30518..40a3c14 100644 --- a/src/lib/easy-language.ts +++ b/src/lib/easy-language.ts @@ -1,2 +1,4 @@ /** Markiert einen Fehler mitten im Stream der KI-Antwort (Server und Browser) */ export const STREAM_ERROR = '\u0000FEHLER:'; +/** Danach folgt die bereinigte, endgültige Fassung (nur sie wird als HTML verwendet) */ +export const STREAM_DONE = '\u0000FERTIG:'; diff --git a/src/lib/server/content.ts b/src/lib/server/content.ts index 8ee9a56..3e5f45c 100644 --- a/src/lib/server/content.ts +++ b/src/lib/server/content.ts @@ -4,7 +4,7 @@ import { contacts, events, media, pages, posts, type Attachment, type Media, typ import { mediaUrl, thumbUrl } from './uploads'; import type { AttachmentItem, ContactCard, EventItem, MediaItem, PageCard, PostCard } from '$lib/types'; import { today } from '$lib/dates'; -import { isFresh, needsAuto } from './easy-auto'; +import { needsAuto, readerAuto } from './easy-auto'; export function toMediaItem(m: Media): MediaItem { return { @@ -116,7 +116,7 @@ export function getPost(slug: string) { teaser: post.teaser, content: post.content, contentEasy: post.contentEasy, - contentEasyAuto: isFresh(post) ? post.contentEasyAuto : '', + contentEasyAuto: readerAuto(post), easyAutoPending: needsAuto(post), videoUrl: post.videoUrl, publishedAt: post.publishedAt.toISOString(), @@ -170,7 +170,7 @@ export function getPage(slug: string) { color: page.color, content: page.content, contentEasy: page.contentEasy, - contentEasyAuto: isFresh(page) ? page.contentEasyAuto : '', + contentEasyAuto: readerAuto(page), easyAutoPending: needsAuto(page), cover: getMedia(page.coverId), attachments: attachmentsOf(page.attachments), diff --git a/src/lib/server/easy-auto.ts b/src/lib/server/easy-auto.ts index 331b400..ec1baf1 100644 --- a/src/lib/server/easy-auto.ts +++ b/src/lib/server/easy-auto.ts @@ -93,9 +93,16 @@ function load(kind: EasyKind, id: number): Row | undefined { export const isFresh = (r: Pick) => !!r.contentEasyAuto && r.contentEasyAutoHash === sourceHash(r.title, r.content); -/** Braucht der Text eine (neue) automatische Fassung? */ +/** Werden ungeprüfte KI-Fassungen an Leser ausgeliefert? (Modus „automatisch“) */ +export const autoForReaders = () => aiReady() && getSettings().aiMode === 'auto'; + +/** Braucht der Text eine (neue) automatische Fassung für Leser? */ export const needsAuto = (r: Pick) => - aiReady() && !r.contentEasy.trim() && !!htmlToStructuredText(r.content) && !isFresh(r); + autoForReaders() && !r.contentEasy.trim() && !!htmlToStructuredText(r.content) && !isFresh(r); + +/** Automatische Fassung, die Lesern gezeigt werden darf (nur im Modus „automatisch“) */ +export const readerAuto = (r: Pick) => + autoForReaders() && isFresh(r) ? r.contentEasyAuto : ''; // ─── Erzeugen ──────────────────────────────────────────────────────────────── @@ -183,10 +190,34 @@ async function work() { /** Stand der automatischen Fassung für die Anzeige in der Redaktion */ export function autoStatus(r: { title: string; content: string; contentEasyAuto: string; contentEasyAutoHash: string; contentEasyAutoModel: string; contentEasyAutoAt: Date | null }) { return { - enabled: getSettings().aiEnabled, + enabled: autoForReaders(), html: r.contentEasyAuto, fresh: isFresh(r), at: r.contentEasyAutoAt?.toISOString() ?? null, model: r.contentEasyAutoModel }; } + +// ─── Entwurf per Knopf in der Redaktion ────────────────────────────────────── + +/** + * Entwurf aus dem (auch ungespeicherten) Text des Editors – wird nicht gespeichert, + * sondern nach Prüfung von der Redaktion als eigene Fassung übernommen. + */ +export async function* streamDraft(title: string, html: string, signal?: AbortSignal): AsyncGenerator { + if (!aiReady()) throw new AiError('Die KI ist nicht eingerichtet (Einstellungen → Leichte Sprache mit KI).'); + const text = htmlToStructuredText(html); + if (!text) throw new AiError('Bitte zuerst oben den normalen Text schreiben.'); + if (text.length > MAX_INPUT_CHARS) throw new AiError('Der Text ist zu lang. Bitte in kürzeren Abschnitten übertragen.'); + if (dailyUsage() >= getSettings().aiDailyLimit) throw new AiError('Das Tageslimit für KI-Übertragungen ist erreicht.'); + record('ki-tag'); + yield* streamText( + currentConfig(), + systemPrompt(getSettings().easyAddress), + `Übertrage diesen Text in Leichte Sprache.\n\n${title}\n\n\n${text}\n`, + signal + ); +} + +/** Modell-Ausgabe bereinigen (Code-Block entfernen, nur erlaubte Tags) */ +export const cleanDraft = (out: string) => cleanHtml(out.replace(/^\s*```(?:html)?\s*/i, '').replace(/```\s*$/, '')); diff --git a/src/lib/server/legal.ts b/src/lib/server/legal.ts index 5373c41..595e589 100644 --- a/src/lib/server/legal.ts +++ b/src/lib/server/legal.ts @@ -64,11 +64,11 @@ export function privacyTemplate(s: AppSettings): string { '

Die Vorlesefunktion nutzt die Sprachausgabe deines Geräts. Wir bevorzugen Stimmen, die direkt auf dem Gerät arbeiten. Steht nur eine Online-Stimme des Browsers zur Verfügung, kann der vorgelesene Text vom Browser-Anbieter verarbeitet werden. Wir selbst erhalten dabei keine Daten.

', s.aiEnabled - ? `

7. Automatische Leichte Sprache

Texte, die es noch nicht in Leichter Sprache gibt, überträgt eine KI automatisch. Dafür werden die veröffentlichten Texte der App an ${ + ? `

7. Leichte Sprache mit KI

${s.aiMode === 'auto' ? 'Texte, die es noch nicht in Leichter Sprache gibt, überträgt eine KI automatisch. Dafür werden die veröffentlichten Texte der App' : 'Fassungen in Leichter Sprache entstehen mit Hilfe einer KI und werden vor der Veröffentlichung von der Redaktion geprüft. Dafür werden die Texte der App'} an ${ s.aiProvider === 'ollama' ? 'einen KI-Dienst auf einem eigenen Server des Verantwortlichen' : `den Anbieter ${esc(AI_PROVIDERS[s.aiProvider].label)} (Verarbeitung auch außerhalb der EU möglich, auf Grundlage eines Auftragsverarbeitungsvertrags)` - } übermittelt. Von dir als Leserin oder Leser werden dabei keine Daten übermittelt. Automatisch übertragene Texte sind in der App gekennzeichnet.

` + } übermittelt. Von dir als Leserin oder Leser werden dabei keine Daten übermittelt.${s.aiMode === 'auto' ? ' Automatisch übertragene Texte sind in der App gekennzeichnet.' : ''}

` : '', `

${s.aiEnabled ? 8 : 7}. Eingebettete Videos

`, '

Videos von YouTube (im erweiterten Datenschutzmodus, youtube-nocookie.com) oder Vimeo werden erst geladen, wenn du auf „Video abspielen“ tippst. Erst dann wird eine Verbindung zum jeweiligen Anbieter hergestellt, der dabei u. a. deine IP-Adresse erhält und Daten auch in den USA verarbeiten kann (Einwilligung, Art. 6 Abs. 1 lit. a DSGVO).

', diff --git a/src/lib/settings.ts b/src/lib/settings.ts index 908d9c2..a0e2a34 100644 --- a/src/lib/settings.ts +++ b/src/lib/settings.ts @@ -62,8 +62,10 @@ export type AppSettings = { /** Wie viele Meldungen/Termine die Startseite zeigt */ /** Administratoren müssen die Zwei-Faktor-Anmeldung einrichten */ require2faAdmins: boolean; - /** Automatische Leichte Sprache per KI für Leser */ + /** Leichte Sprache per KI eingeschaltet */ aiEnabled: boolean; + /** review = Entwurf per Knopf, Redaktion prüft; auto = automatisch für Leser */ + aiMode: 'review' | 'auto'; aiProvider: AiProvider; aiModel: string; /** Adresse des Dienstes (Ollama oder eigener Endpunkt), leer = Standard des Anbieters */ @@ -115,6 +117,7 @@ export const DEFAULT_SETTINGS: AppSettings = { }, require2faAdmins: false, aiEnabled: false, + aiMode: 'review', aiProvider: 'anthropic', aiModel: '', aiBaseUrl: '', diff --git a/src/routes/admin/(panel)/+layout.server.ts b/src/routes/admin/(panel)/+layout.server.ts index eb94855..42aefd2 100644 --- a/src/routes/admin/(panel)/+layout.server.ts +++ b/src/routes/admin/(panel)/+layout.server.ts @@ -1,8 +1,11 @@ import { eq, sql } from 'drizzle-orm'; import { db } from '$lib/server/db'; import { messages } from '$lib/server/db/schema'; +import { aiReady } from '$lib/server/ai'; +import { getSettings } from '$lib/server/settings'; export const load = ({ locals }) => ({ user: locals.user!, + ai: { ready: aiReady(), mode: getSettings().aiMode }, unread: db.select({ n: sql`count(*)` }).from(messages).where(eq(messages.read, false)).get()?.n ?? 0 }); diff --git a/src/routes/admin/(panel)/einstellungen/+page.server.ts b/src/routes/admin/(panel)/einstellungen/+page.server.ts index 15d2751..01e7de2 100644 --- a/src/routes/admin/(panel)/einstellungen/+page.server.ts +++ b/src/routes/admin/(panel)/einstellungen/+page.server.ts @@ -47,6 +47,7 @@ function read(form: FormData): Partial | string { require2faAdmins: f.bool('require2faAdmins'), easyAddress: f.str('easyAddress') === 'Sie' ? 'Sie' : 'du', aiEnabled: f.bool('aiEnabled'), + aiMode: f.str('aiMode') === 'auto' ? 'auto' : 'review', aiProvider: (f.str('aiProvider') in AI_PROVIDERS ? f.str('aiProvider') : 'anthropic') as AiProvider, aiModel: f.str('aiModel', 120), aiBaseUrl: f.str('aiBaseUrl', 300), diff --git a/src/routes/admin/(panel)/meldungen/[id]/+page.server.ts b/src/routes/admin/(panel)/meldungen/[id]/+page.server.ts index 09fd696..30ae22d 100644 --- a/src/routes/admin/(panel)/meldungen/[id]/+page.server.ts +++ b/src/routes/admin/(panel)/meldungen/[id]/+page.server.ts @@ -18,7 +18,7 @@ export const load = ({ params }) => { if (id === 'new') { return { isNew: true, - easyAuto: { enabled: getSettings().aiEnabled, html: '', fresh: false, at: null, model: '' } as ReturnType, + easyAuto: { enabled: getSettings().aiEnabled && getSettings().aiMode === 'auto', html: '', fresh: false, at: null, model: '' } as ReturnType, subscribers: subscriberCounts().byTopic.news, contactOptions, post: { diff --git a/src/routes/admin/(panel)/seiten/[id]/+page.server.ts b/src/routes/admin/(panel)/seiten/[id]/+page.server.ts index ddd3703..9c3cc77 100644 --- a/src/routes/admin/(panel)/seiten/[id]/+page.server.ts +++ b/src/routes/admin/(panel)/seiten/[id]/+page.server.ts @@ -25,7 +25,7 @@ export const load = ({ params, url }) => { const parent = Number(url.searchParams.get('parent')) || null; return { isNew: true, contactOptions, parentOptions, - easyAuto: { enabled: getSettings().aiEnabled, html: '', fresh: false, at: null, model: '' } as ReturnType, + easyAuto: { enabled: getSettings().aiEnabled && getSettings().aiMode === 'auto', html: '', fresh: false, at: null, model: '' } as ReturnType, page: { id: 0, parentId: parent, title: '', slug: '', teaser: '', icon: 'file-text', color: 'sky', content: '', contentEasy: '', published: true, cover: null as MediaItem | null, attachments: [] as ReturnType, contactIds: [] as number[] diff --git a/src/routes/admin/api/leichte-sprache/+server.ts b/src/routes/admin/api/leichte-sprache/+server.ts new file mode 100644 index 0000000..a28a653 --- /dev/null +++ b/src/routes/admin/api/leichte-sprache/+server.ts @@ -0,0 +1,55 @@ +import { error } from '@sveltejs/kit'; +import { allow } from '$lib/server/ratelimit'; +import { AiError } from '$lib/server/ai'; +import { cleanDraft, streamDraft } from '$lib/server/easy-auto'; +import { STREAM_DONE, STREAM_ERROR } from '$lib/easy-language'; + +/** + * Knopf „Mit KI erstellen“ in der Redaktion: streamt einen Entwurf aus dem + * aktuellen Text. Gespeichert wird erst, wenn die Redaktion ihn geprüft hat. + */ +export const POST = async ({ request, locals }) => { + if (!allow(`ki-entwurf:${locals.user!.id}`, 30, 3600e3)) error(429, 'Zu viele Anfragen. Bitte warte etwas.'); + const body = await request.json().catch(() => null); + const title = typeof body?.title === 'string' ? body.title.slice(0, 300) : ''; + const html = typeof body?.html === 'string' ? body.html : ''; + + const generator = streamDraft(title, html, request.signal); + // Ersten Abschnitt abwarten, damit Eingabefehler als normaler Fehler-Status ankommen + let first: IteratorResult; + try { + first = await generator.next(); + } catch (e) { + error(400, e instanceof AiError ? e.message : 'Die KI ist gerade nicht erreichbar.'); + } + + const encoder = new TextEncoder(); + const stream = new ReadableStream({ + async start(controller) { + let out = ''; + try { + if (!first.done) { + out += first.value; + controller.enqueue(encoder.encode(first.value)); + } + for await (const chunk of generator) { + out += chunk; + controller.enqueue(encoder.encode(chunk)); + } + const clean = cleanDraft(out); + controller.enqueue(encoder.encode(clean ? STREAM_DONE + clean : STREAM_ERROR + 'Die KI hat keinen Text geliefert.')); + } catch (e) { + const name = (e as Error)?.name ?? ''; + if (name !== 'APIUserAbortError' && name !== 'AbortError') + controller.enqueue(encoder.encode(STREAM_ERROR + (e instanceof AiError ? e.message : 'Unerwarteter Fehler bei der KI.'))); + } + controller.close(); + }, + cancel() { + generator.return(undefined); + } + }); + return new Response(stream, { + headers: { 'Content-Type': 'text/plain; charset=utf-8', 'Cache-Control': 'no-store', 'X-Accel-Buffering': 'no' } + }); +}; diff --git a/src/routes/api/leichte-sprache/+server.ts b/src/routes/api/leichte-sprache/+server.ts index 95671d5..37a27ee 100644 --- a/src/routes/api/leichte-sprache/+server.ts +++ b/src/routes/api/leichte-sprache/+server.ts @@ -3,7 +3,7 @@ import { and, eq, lte } from 'drizzle-orm'; import { db } from '$lib/server/db'; import { pages, posts } from '$lib/server/db/schema'; import { AiError } from '$lib/server/ai'; -import { generate, isFresh, needsAuto, type EasyKind } from '$lib/server/easy-auto'; +import { generate, needsAuto, readerAuto, type EasyKind } from '$lib/server/easy-auto'; import { allow } from '$lib/server/ratelimit'; import { STREAM_ERROR } from '$lib/easy-language'; @@ -29,7 +29,8 @@ export const POST = async ({ request, getClientAddress }) => { const row = find(kind, slug); if (!row) error(404, 'Text nicht gefunden.'); if (row.contentEasy.trim()) return json({ html: row.contentEasy, auto: false }); - if (isFresh(row)) return json({ html: row.contentEasyAuto, auto: true }); + const ready = readerAuto(row); + if (ready) return json({ html: ready, auto: true }); if (!needsAuto(row)) error(503, 'Leichte Sprache ist für diesen Text gerade nicht verfügbar.'); // Kostenschutz: pro Gerät höchstens 20 neue Übertragungen pro Stunde