From 8862a095c036009ddfde72859070fc84b910a101 Mon Sep 17 00:00:00 2001 From: Friederich Loheide Date: Sat, 3 Oct 2026 05:34:32 +0000 Subject: [PATCH] Leichte Sprache per KI (Claude) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Knopf „Mit KI erstellen“ bei Seiten und Meldungen: überträgt den aktuellen (auch ungespeicherten) Text in Leichte Sprache – Regeln nach Netzwerk Leichte Sprache / DIN SPEC 33429 als Anweisung, Ausgabe als einfaches HTML - Claude Opus 5 über das offizielle Anthropic-SDK, gestreamt mit Live-Vorschau und Abbrechen; server-seitiger Fallback bei Ablehnung - Hinweis „KI-Entwurf – bitte prüfen“, Nachfrage vor dem Überschreiben, verständliche Fehlermeldungen (Ablehnung, Schlüssel, Auslastung) - Anrede du/Sie in den Einstellungen, Status der Einrichtung sichtbar - Ohne ANTHROPIC_API_KEY bleibt die Funktion ausgeblendet; lange Texte werden nicht abgeschnitten, sondern abgelehnt (Hinweis auf Abschnitte) - Sperre: 30 Anfragen pro Person und Stunde Getestet gegen eine nachgebaute Claude-API (Streaming-Format). Co-Authored-By: Claude Opus 5.5 (1M context) --- .env.example | 3 + README.md | 4 + docker-compose.yml | 1 + package-lock.json | 72 ++++++++++ package.json | 1 + src/lib/admin/EasyLanguageField.svelte | 133 ++++++++++++++++-- src/lib/admin/RichEditor.svelte | 8 ++ src/lib/easy-language.ts | 2 + src/lib/server/easy-language.ts | 115 +++++++++++++++ src/lib/settings.ts | 3 + src/routes/admin/(panel)/+layout.server.ts | 2 + .../(panel)/einstellungen/+page.server.ts | 4 +- .../admin/(panel)/einstellungen/+page.svelte | 16 +++ .../admin/api/leichte-sprache/+server.ts | 46 ++++++ 14 files changed, 399 insertions(+), 11 deletions(-) create mode 100644 src/lib/easy-language.ts create mode 100644 src/lib/server/easy-language.ts create mode 100644 src/routes/admin/api/leichte-sprache/+server.ts diff --git a/.env.example b/.env.example index 788715e..15a8df4 100644 --- a/.env.example +++ b/.env.example @@ -16,6 +16,9 @@ SMTP_USER= SMTP_PASS= SMTP_FROM="Werkstatt-App " +# Leichte Sprache mit KI (Claude von Anthropic). Ohne Schlüssel ist der Knopf ausgeblendet. +ANTHROPIC_API_KEY= + # Push-Benachrichtigungen: Schlüssel werden beim ersten Start automatisch erzeugt und # in der Datenbank gespeichert. Nur setzen, wenn eigene Schlüssel verwendet werden sollen # (erzeugen mit: npx web-push generate-vapid-keys). diff --git a/README.md b/README.md index a0f54de..9635c47 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,9 @@ Tablet und Desktop. - Meldungen (Entwurf, geplante Veröffentlichung, anheften), Seitenbaum, Termine, Startseiten-Bereiche, Mediathek, Postfach - Text-Editor mit Formatierungen, Links und Bildern +- **Leichte Sprache per KI:** „Mit KI erstellen“ schreibt aus dem normalen Text einen Entwurf nach den + Regeln für Leichte Sprache (Claude Opus 5, live gestreamt, Anrede du/Sie einstellbar) – zum Prüfen + und Speichern - 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 @@ -88,6 +91,7 @@ Ohne Docker: `npm ci && npm run build && ORIGIN=https://… BODY_SIZE_LIMIT=30M | `ADMIN_EMAIL` / `ADMIN_PASSWORD` | Erster Admin, wird angelegt, solange es noch keinen Benutzer gibt | | `BODY_SIZE_LIMIT` | Max. Upload-Größe (im Docker-Image auf 30M gesetzt) | | `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM` | E-Mail-Versand für „Passwort vergessen“. Ohne SMTP steht der Link im Server-Log | +| `ANTHROPIC_API_KEY` | Für „Leichte Sprache mit KI“ (Claude). Ohne Schlüssel ist die Funktion ausgeblendet | | `VAPID_PUBLIC_KEY` / `VAPID_PRIVATE_KEY` | Optional – sonst werden die Push-Schlüssel automatisch erzeugt und gespeichert | ## Erweitern diff --git a/docker-compose.yml b/docker-compose.yml index 469c0ef..e0d4697 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -8,6 +8,7 @@ services: ORIGIN: ${ORIGIN:-http://localhost:3000} ADMIN_EMAIL: ${ADMIN_EMAIL:-} ADMIN_PASSWORD: ${ADMIN_PASSWORD:-} + ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-} SMTP_HOST: ${SMTP_HOST:-} SMTP_PORT: ${SMTP_PORT:-587} SMTP_SECURE: ${SMTP_SECURE:-false} diff --git a/package-lock.json b/package-lock.json index 685fa47..b87b2c6 100644 --- a/package-lock.json +++ b/package-lock.json @@ -8,6 +8,7 @@ "name": "werkstaetten-app", "version": "0.1.0", "dependencies": { + "@anthropic-ai/sdk": "^0.131.0", "better-sqlite3": "^13.0.3", "drizzle-orm": "^0.45.3", "nodemailer": "^10.0.13", @@ -45,6 +46,36 @@ "node": ">=22" } }, + "node_modules/@anthropic-ai/sdk": { + "version": "0.131.0", + "resolved": "https://registry.npmjs.org/@anthropic-ai/sdk/-/sdk-0.131.0.tgz", + "integrity": "sha512-9+PepoU7qVMmM70jSahdnfcMHAvAnzhMOLv2W9WjRLO+OG/MAiBETkwKZqv7KIJ1Cj5h8eZ019bHzZaq+Mbepw==", + "license": "MIT", + "dependencies": { + "json-schema-to-ts": "^3.1.1", + "standardwebhooks": "^1.0.0" + }, + "bin": { + "anthropic-ai-sdk": "bin/cli" + }, + "peerDependencies": { + "zod": "^3.25.0 || ^4.0.0" + }, + "peerDependenciesMeta": { + "zod": { + "optional": true + } + } + }, + "node_modules/@babel/runtime": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz", + "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, "node_modules/@drizzle-team/brocli": { "version": "0.10.2", "resolved": "https://registry.npmjs.org/@drizzle-team/brocli/-/brocli-0.10.2.tgz", @@ -2382,6 +2413,12 @@ "win32" ] }, + "node_modules/@stablelib/base64": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@stablelib/base64/-/base64-1.0.1.tgz", + "integrity": "sha512-1bnPQqSxSuc3Ii6MhBysoWCg58j97aUjuCSZrGSmDxNqtytIi0k8utUenAwTZN4V5mXXYGsVUI9zeBqy+jBOSQ==", + "license": "MIT" + }, "node_modules/@standard-schema/spec": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz", @@ -4383,6 +4420,12 @@ "dev": true, "license": "MIT" }, + "node_modules/fast-sha256": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/fast-sha256/-/fast-sha256-1.3.0.tgz", + "integrity": "sha512-n11RGP/lrWEFI/bWdygLxhI+pVeo1ZYIVwvvPkW7azl/rOy+F3HYRZ2K5zeE9mmkhQppyv9sQFx0JM9UabnpPQ==", + "license": "Unlicense" + }, "node_modules/fdir": { "version": "6.5.0", "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", @@ -4592,6 +4635,19 @@ "jiti": "lib/jiti-cli.mjs" } }, + "node_modules/json-schema-to-ts": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-3.1.1.tgz", + "integrity": "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.18.3", + "ts-algebra": "^2.0.0" + }, + "engines": { + "node": ">=16" + } + }, "node_modules/jwa": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz", @@ -5660,6 +5716,16 @@ "source-map": "^0.6.0" } }, + "node_modules/standardwebhooks": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/standardwebhooks/-/standardwebhooks-1.1.1.tgz", + "integrity": "sha512-bCbX9ZEyFkWPsRz7Bl3NuQUJohmwGSev/yhr7vhaGPlc4AfIrspIRa6cPTBuI1ItmrTDJ4d/S2hCsfe4+vQGnQ==", + "license": "MIT", + "dependencies": { + "@stablelib/base64": "^1.0.0", + "fast-sha256": "^1.3.0" + } + }, "node_modules/string-width": { "version": "4.2.3", "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", @@ -5809,6 +5875,12 @@ "node": ">=6" } }, + "node_modules/ts-algebra": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-2.0.0.tgz", + "integrity": "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw==", + "license": "MIT" + }, "node_modules/tslib": { "version": "2.8.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", diff --git a/package.json b/package.json index 59b903f..d69345c 100644 --- a/package.json +++ b/package.json @@ -18,6 +18,7 @@ "node": ">=22" }, "dependencies": { + "@anthropic-ai/sdk": "^0.131.0", "better-sqlite3": "^13.0.3", "drizzle-orm": "^0.45.3", "nodemailer": "^10.0.13", diff --git a/src/lib/admin/EasyLanguageField.svelte b/src/lib/admin/EasyLanguageField.svelte index b932005..6ad8df1 100644 --- a/src/lib/admin/EasyLanguageField.svelte +++ b/src/lib/admin/EasyLanguageField.svelte @@ -1,28 +1,141 @@ -
- - + + {#if data.ai} +

Eingerichtet. In Seiten und Meldungen gibt es bei „Leichte Sprache“ den Knopf „Mit KI erstellen“.

+ {:else} +

Noch nicht eingerichtet: Auf dem Server fehlt ANTHROPIC_API_KEY in der .env.

+ {/if} +
+ Anrede in den Entwürfen +
+ {#each ['du', 'Sie'] as a (a)} + + {/each} +
+
+
+ { + if (!easyLanguageAvailable()) error(503, 'Die KI-Funktion ist nicht eingerichtet (ANTHROPIC_API_KEY fehlt).'); + if (!allow(`ki-leichte-sprache:${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 = streamEasyLanguage({ title, html }, request.signal); + // Ersten Abschnitt abwarten, damit Eingabefehler als normaler Fehler-Status ankommen + let first: IteratorResult; + try { + first = await generator.next(); + } catch (e) { + if (e instanceof EasyLanguageError) error(400, e.message); + throw e; + } + + const encoder = new TextEncoder(); + const stream = new ReadableStream({ + async start(controller) { + try { + if (!first.done) controller.enqueue(encoder.encode(first.value)); + for await (const chunk of generator) controller.enqueue(encoder.encode(chunk)); + } catch (e) { + const message = e instanceof EasyLanguageError ? e.message : 'Unerwarteter Fehler bei der KI.'; + if (!(e instanceof EasyLanguageError)) console.error('[leichte-sprache]', e); + controller.enqueue(encoder.encode(STREAM_ERROR + message)); + } + 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' } + }); +};