dsh-think-translate 1.2.14 → 1.2.17

package/README.de.md

@@ -1,127 +1,219 @@
-<div align="center">
+<p align="center">
+  <img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/hero.de.png?v=1.2.17" alt="dsh-think-translate — KI-Gedanken in deiner Sprache" width="100%" />
+</p>
 
-# 🐋 dsh-think-translate
+<p align="center">
+  <b>Übersetzung der Anzeigeebene für DeepSeek Harness.</b><br />
+  Gedanken lesen, Aufgaben verfolgen und Antworten verstehen. Originale bleiben erhalten; Übersetzungen gelangen nicht in den Modellkontext.
+</p>
 
-**Sprachen:** [English](README.md) · [中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md)
+<p align="center">
+  <img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/badge-mit.de.svg?v=1.2.17" alt="MIT-Lizenz" />
+  <img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/badge-local.de.svg?v=1.2.17" alt="Lokales Ollama" />
+  <img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/badge-original.de.svg?v=1.2.17" alt="Originale erhalten" />
+</p>
 
-[![npm version](https://img.shields.io/npm/v/dsh-think-translate?color=4D6BFE&label=npm)](https://www.npmjs.com/package/dsh-think-translate)
-[![license](https://img.shields.io/npm/l/dsh-think-translate?color=4D6BFE)](LICENSE)
-[![dsh](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)
+<p align="center">
+  <a href="README.zh-CN.md">中文</a> · <a href="README.md">English</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.es.md">Español</a> · <a href="README.fr.md">Français</a> · <b>Deutsch</b> · <a href="README.ru.md">Русский</a> · <a href="README.pt.md">Português</a>
+</p>
 
-<img src="demo/demo.gif?v=2" width="46%" alt="dsh-think-translate demo" style="border:1px solid #4D6BFE;border-radius:8px;margin:4px" />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<img src="demo/demo2.gif?v=2" width="41%" alt="dsh-think-translate demo 2" style="border:1px solid #4D6BFE;border-radius:8px;margin:4px" />
-
-</div>
+<p align="center">
+  <a href="#quick-start"><img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/nav-quick-start.de.svg?v=1.2.17" alt="Installation" height="24" /></a> &nbsp;·&nbsp; <a href="#demo"><img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/nav-demo.de.svg?v=1.2.17" alt="Live-Demos" height="24" /></a> &nbsp;·&nbsp; <a href="#features"><img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/nav-features.de.svg?v=1.2.17" alt="Funktionen" height="24" /></a> &nbsp;·&nbsp; <a href="#comparison"><img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/nav-comparison.de.svg?v=1.2.17" alt="Vergleich" height="24" /></a> &nbsp;·&nbsp; <a href="#faq"><img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/nav-faq.de.svg?v=1.2.17" alt="Fragen" height="24" /></a>
+</p>
 
 ---
 
-Übersetzung auf Anzeigeebene für die Web-Oberfläche von [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): Die **Gedankenkette (Think-Zeile), Aufgabenkarten und der Antworttext** werden in der gewählten Zielsprache angezeigt, während die Originale im Verlauf unverändert bleiben und der übersetzte Text **nie in den Modellkontext gelangt**.
+<a id="demo"></a>
+## Gedanken beim Entstehen erleben
+
+<table>
+<tr>
+<td width="50%" align="center" valign="bottom">
+<img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/demo/demo.gif?v=1.2.17" alt="Demo 1 · Gedanken und Antworten" width="100%" />
+</td>
+<td width="50%" align="center" valign="bottom">
+<img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/demo/demo2.gif?v=1.2.17" alt="Demo 2 · Weitere Bedienung" width="100%" />
+</td>
+</tr>
+<tr>
+<td align="center" valign="top"><sub>Demo 1 · Gedanken und Antworten</sub></td>
+<td align="center" valign="top"><sub>Demo 2 · Weitere Bedienung</sub></td>
+</tr>
+</table>
 
-## ✨ Funktionen
+<a id="comparison"></a>
+## Vergleich mit dem offiziellen Übersetzungsplugin
 
-Modelle der DeepSeek-Familie denken oft auf Chinesisch — oder in der Sprache, in der sie gerade denken. dsh-think-translate zeigt die Think-Zeile, Aufgabenkarten und die Antwort live in *Ihrer* Sprache an, wie Untertitel für das Denken des Modells.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/UncleK/dsh-think-translate/main/docs/assets/translation-comparison.de.png?v=1.2.17" alt="Vergleich mit dem offiziellen Übersetzungsplugin" width="100%" />
+</p>
 
-- **Ablehnungsgründe der automatischen Prüfung** — ergänzt die Genehmigungskarte asynchron um eine Übersetzung, behält das Original und bietet einen eigenen Schalter.
-- **🕵️ Jede Gedankenkette lesbar** — Reasoning, Gedankenkette, Aufgabenkarten und Antworten in Echtzeit übersetzt, in Stapeln gestreamt
-- **8 Zielsprachen** — 中文 / English / 日本語 / 한국어 / Español / Français / Deutsch / Русский
-- **Einsprachige Oberfläche** — Einstellungsbereich, Denkzeilen und Aufgabenkarten folgen der Zielsprache (kein zh/en-Gemisch); die Auswahl bleibt erhalten
-- **Lokales Ollama** — vorhandene Installation und Modelle werden wiederverwendet. Steht aktiviertes Ollama an erster Stelle oder wird Test angeklickt, startet der Dienst bei Bedarf und lädt das Modell. Fehlende Software/Modelle werden erst über die Vorbereitungsschaltfläche installiert/heruntergeladen, mit Fortschrittsanzeige
-- **🧠 Null Kontextkosten** — reine Anzeigeschicht: das Modell sieht weiterhin den Originaltext, und übersetzter Text verbraucht niemals das Kontextfenster
-- **Google / Bing-Fallback** — automatische Umschaltung, wenn das lokale Modell nicht verfügbar ist (google nutzt einen Node-CONNECT-Tunnel über den Systemproxy)
-- **Code-Artefakte übersprungen** — Pfade, Befehle, URLs, Regexes und reine Codezeilen werden nie übersetzt
-- **Satzweise Batch-Übersetzung** — lange Denkketten werden in kleinen Sätzen übersetzt, damit lokale kleine Modelle Qualität behalten
-- **🧩 Absatz- und satzweise Zerlegung** — lange Denkketten werden an Leerzeilen geteilt (Absatzstruktur bleibt erhalten) und zusätzlich satzweise gebündelt, damit kleine lokale Modelle Qualität behalten
-- **Streaming-Ausgabe** — Übersetzungen erscheinen während des Denkens batchweise; Think-Zeile aufklappen zum Vergleich mit dem Original
-- **🎚️ Einstellbarer Übersetzungszeitpunkt** — alles vorübersetzen / alte Ketten lazy laden (Standard) / nur beim Aufklappen
-- **🔗 Dynamische Anbieter-Kette** — die Listenreihenfolge ist die Ausführungsreihenfolge: ziehen zum Sortieren, jede Zeile einzeln ein-/ausschalten. Integriert google gtx / bing / lokales Ollama plus beliebige eigene Endpunkte
-- **🔌 Eigene Anbieter (OpenAI & Anthropic)** — im Panel jeden OpenAI-kompatiblen Endpunkt (`/v1/chat/completions`) oder die **Anthropic Messages API** (Claude) hinzufügen: Typ, Vorlage, Basis-URL, API-Schlüssel, Modell
-- **🪄 DSH-konfigurierte Anbieter übernehmen** — liest schreibgeschützte DSH-Zeilen aus `profiles/<profile>/cordis.patch.yml` / älteres `settings.yaml` (`llm-pi-ai.providers`); eine Schaltfläche liest neu ein und fügt alle der Kette hinzu. Der Schlüssel wird pro Anfrage aus `.credentials.yaml` aufgelöst und nie in der Plugin-Konfiguration gespeichert. Auch die eigene Standardroute des Harness zählt: zeigt `default-model` / `agent-default-model` auf `deepseek-official`, erscheint die offizielle DeepSeek-API als weitere DSH-Zeile
-- **⏱️ Robust** — fehlgeschlagene Übersetzungen werden 30 Sekunden im Arbeitsspeicher zwischengespeichert und danach automatisch erneut versucht; jede Anbieterzeile hat eine Test-Schaltfläche
+Aktiviere dieses Plugin oder den offiziellen Gedankenübersetzer. Beide übernehmen die Gedankenoberfläche.
 
-## 📦 Installation
+<a id="quick-start"></a>
+## Mit einem Befehl starten
 
 ```bash
-# Option 1: npm (empfohlen)
 dsh plugin --profile web add dsh-think-translate
-# dann web neu starten
+```
+
+Starte DSH Web nach der Installation vollständig neu. Wähle unter **Einstellungen → Gedankenübersetzung** die Zielsprache und Anbieter.
 
-# Option 2: GitHub
+<details>
+<summary><b>GitHub-Installation, Updates und weitere Methoden</b></summary>
+
+Von GitHub installieren:
+
+```bash
 dsh plugin --profile web add github:UncleK/dsh-think-translate
+```
+
+Über npm aktualisieren:
 
-# Option 3: manuell (Junction + Patch)
-#  1. Paket in das node_modules des Profils verlinken
-New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\node_modules\dsh-think-translate" `
-  -Target "<Repository-Pfad>"
-#  2. zu "$HOME\.dsh\profiles\web\cordis.patch.yml" hinzufügen:
-# - insert:
-#     - id: dsh-think-translate
-#       name: dsh-think-translate
-#  3. web neu starten
+```bash
+dsh plugin --profile web add dsh-think-translate@latest
 ```
 
-## 🧯 Nach einem DSH-Upgrade
+Starte DSH nach Installation oder Update vollständig neu. Manuell wird das Paket ins Profil verlinkt und in `cordis.patch.yml` eingetragen. Im Alltag sind die obigen Befehle empfohlen.
+
+</details>
+
+<a id="features"></a>
+## Mehr verstehen als nur Gedanken
+
+<table>
+<tr>
+<td width="50%" valign="top">
+<h3>Gedanken live mitlesen</h3>
+<p>Alles vorübersetzen, Verlauf bei Bedarf laden oder nur beim Aufklappen übersetzen</p>
+</td>
+<td width="50%" valign="top">
+<h3>Aufgaben und Antworten gemeinsam</h3>
+<p>Gedanken, Aufgabenkarten und Aufgabenliste im Eingabebereich; Antworten und Ablehnungsgründe der automatischen Prüfung optional</p>
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+<h3>Prüfentscheidungen verstehen</h3>
+<p>Lehnt die automatische Prüfung einen Werkzeugaufruf ab, erscheint der Grund übersetzt neben dem Original. Die vorhandenen Entscheidungsschaltflächen bleiben verfügbar.</p>
+</td>
+<td width="50%" valign="top">
+<h3>Originale und Code erhalten</h3>
+<p>Originale bleiben erhalten; Übersetzungen gelangen nicht in den Modellkontext. Nutzt Markdown-Komponenten; schützt Code, Pfade und Befehle vor der Übersetzung.</p>
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+<h3>Lokale Modelle bei Bedarf laden</h3>
+<p>Manuell, beim Abwählen oder nach Leerlauf freigeben; Laden bei der nächsten Übersetzung</p>
+</td>
+<td width="50%" valign="top">
+<h3>Anbieter in deiner Reihenfolge</h3>
+<p>Automatischer Wechsel in aktivierter Reihenfolge; klar falsche Sprache löst nächsten Anbieter aus; neuer Versuch nach Wartezeit</p>
+</td>
+</tr>
+</table>
+
+### Bereits genutzte Anbieter verbinden
+
+**Ollama · Google · Bing · OpenAI · Anthropic Messages API**
+
+DSH-Anbieter erkennen, ohne Endpunkte und Schlüssel erneut einzugeben. Jede Zeile lässt sich separat testen; die Listenreihenfolge bestimmt die Versuche.
+
+```text
+Erste Wahl → nächster aktiver Anbieter → … → Original, wenn alle scheitern
+```
 
-Client-Plugins von Drittanbietern werden über den Client-Modulgraphen von DSH geladen, und dieser Graph wird **pro Prozess nur einmal** zusammengesetzt – eine fehlgeschlagene Komposition bleibt bis zum Neustart im Speicher. Deshalb passieren direkt nach einem Upgrade meist diese drei Dinge.
+<details>
+<summary><b>Eigene Endpunkte, Zugangsdaten und Wiederholung</b></summary>
 
-- **Der Start aus einem Source-Checkout schlägt fehl** mit `client bundles not found; run \`pnpm run build\` before launch` —— die neuen Client-Pakete sind nicht gebaut: führe `pnpm run build` im Harness-Checkout aus und starte `dsh web` erneut.
-- **Die Plugin-Oberfläche ist verschwunden** (keine übersetzte Think-Zeile, kein Abschnitt *Übersetzung der Gedankenkette* in den Einstellungen) —— **starte `dsh web` einmal neu**; ein bloßes Neuladen der Seite reicht manchmal nicht.
-- **Die Liste der lokalen Modelle ist leer** —— der `ollama`-Dienst bedient dieses Modellverzeichnis nicht: prüfe `ollama list` (oder `GET /api/tags`) und das `OLLAMA_MODELS`, das der laufende Dienst tatsächlich verwendet. Liegen die Modelldateien auf einem anderen Laufwerk, kann ein Verzeichnis-Junction das Standardverzeichnis des Dienstes dorthin zeigen lassen.
+- Unterstützt OpenAI-kompatibles `/v1/chat/completions` und die native Anthropic Messages API.
+- Erkennt Anbieter im aktuellen DSH-Profil und in Überschreibungen. Erneut suchen und zur Übersetzungskette hinzufügen.
+- `apiKeyEnv` wird bei der Anfrage aufgelöst; aufgelöste Schlüssel werden nicht in die Plugin-Konfiguration zurückgeschrieben.
+- Fehler warten 30 Sekunden im Host-Speicher vor neuen Versuchen. Klar falsche Sprache löst den nächsten Anbieter aus.
+- Als Zielsprache erkannter Text wird übersprungen; Anbietertests senden eine echte Anfrage.
 
-Am Plugin ist nichts zu konfigurieren: Es deklariert keine Reihenfolge-Abhängigkeit zu DSH-Interna (es bindet nur den `slots`-Dienst und optional `@deepseek-ai/dsh-client-ui-primitives`) und läuft daher sowohl auf älterem DSH (≤ 0.1.1-rc) als auch auf der aktuellen Linie (≥ 0.1.2-alpha.1, inklusive 0.1.5-rc.1).
+</details>
 
-Für DSH **0.2.0-rc.2** verwenden Sie **dsh-think-translate 1.2.5 oder neuer**. Version 1.2.5 behebt den Registrierungskonflikt des Slots `todo_write` und deklariert den Peer-Versionsbereich 0.2. Führen Sie `dsh plugin --profile web add dsh-think-translate@latest` aus und starten Sie DSH neu; eine Versionsausnahme ist nicht nötig.
+### Lokale Übersetzungsmodelle: bei Bedarf laden und freigeben
 
-**1.2.6** behebt doppelt angezeigte Gedanken und Antworten in DSH 0.2: Der Renderer und die Originaltext-Anzeige bei Fehlern beachten die Gruppen reasoning/response.
+| Deine Aktion | Plugin-Verhalten |
+|---|---|
+| Übersetzen oder testen | Dienst starten und gewähltes Modell bei Bedarf laden |
+| Modellspeicher freigeben | Laufende Übersetzungen abwarten, dann entladen; Dateien, Schalter und Reihenfolge bleiben |
+| Lokalen Anbieter abwählen | Deaktivieren und gewähltes Modell entladen |
+| Erneut aktivieren oder Einstellungen öffnen | Kein Vorladen; Laden bei der nächsten tatsächlichen Übersetzung |
+| Freigabe nach Leerlauf festlegen | Standard: 5 Minuten; 1 / 5 / 10 / 30 / 60 Minuten oder aus |
 
-**1.2.7 lokale Vorbereitung:** Aktiviertes Ollama an erster Stelle oder dessen Test findet vorhandene Installationen und startet/lädt das Modell. Fehlende Software und Modelle werden erst über die Vorbereitungsschaltfläche installiert/heruntergeladen, mit Fortschritt je Phase. Automatische Softwareinstallation unter Windows, sonst offizielle Anleitung. Der aktuelle Anbieter folgt der Priorität aktivierter, geprüfter Anbieter.
+Die Zeit gilt ab der nächsten Nutzung. Ollama überwacht das gewählte Modell; globale Umgebungsvariablen bleiben unverändert. Fehlende Software oder Modelle werden erst nach Klick auf Vorbereiten installiert oder heruntergeladen, mit Fortschrittsanzeige.
 
-**1.2.8 Übertragung und Wiederaufnahme:** Normale HTTP/HTTPS-Übersetzungen nutzen die nativen Netzwerkfunktionen von Node statt eines curl-Prozesses pro Textpaket. SOCKS-Proxys und der Ollama-Installer verwenden weiterhin curl. Fehler bleiben 30 Sekunden im Arbeitsspeicher; danach werden Denk- und Antwortübersetzungen automatisch erneut versucht. Die Zeitlimits berücksichtigen das Laden lokaler Modelle und alternative Anbieter.
+<a id="languages"></a>
+### Deine Sprache bleibt dabei
 
-**1.2.14:** Zielsprachvorgaben und Quelltext werden klar getrennt. Übersetzungen in einer offensichtlich falschen Sprache werden verworfen und der nächste aktivierte Anbieter wird versucht. Ungültige Übersetzungen bleiben nicht als Erfolge im Cache; alte Übersetzungscaches werden gelöscht, Einstellungen, Code, zitierte Begriffe und uneindeutige Kurztexte bleiben erhalten. DSH Web oder Desktop nach dem Update vollständig neu starten. [#14](https://github.com/UncleK/dsh-think-translate/issues/14).
+中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Русский · Português
 
-**1.2.13:** Auto-review-Ablehnungskarten behalten den Originaltext und ergänzen asynchron eine Übersetzung; ein eigener Schalter ist standardmäßig aktiviert. Nach Deaktivierung, Sprachwechsel oder Entfernen der Karte werden alte Ergebnisse verworfen. Nicht englische Gründe werden ebenfalls ins Englische übersetzt. Vielen Dank an [llg1634](https://github.com/llg1634) für den Bericht, den ursprünglichen Patch und die Tests in [#13](https://github.com/UncleK/dsh-think-translate/issues/13). DSH Web oder Desktop nach dem Update vollständig neu starten.
+Neun Ziel-, Einstellungs- und Aufgabensprachen einschließlich Portugiesisch. Die Auswahl bleibt nach dem Neuladen erhalten.
 
-**1.2.12:** Die Anbieterschalter gelten verbindlich; nach einem Host-Fehler fragt der Browser Google nicht mehr direkt ab. Eingezäunter, eingerückter und Inline-Code wird nicht an Übersetzungsdienste gesendet und exakt wiederhergestellt, auch bei unvollständigem Streaming. Alte Übersetzungs-Caches werden entfernt, Einstellungen bleiben erhalten. Nach dem Update DSH Web oder Desktop vollständig neu starten; bloßes Neuladen kann weiterhin alte Client-Ressourcen verwenden.
+<a id="faq"></a>
+## Häufige Fragen
 
-**1.2.11 Bing-Korrekturen:** Der kostenlose Bing-Anbieter bleibt erhalten. Übersetzungsanfragen gehen an den endgültigen Origin der Sitzungsseite, damit die Weiterleitung `www.bing.com` → `cn.bing.com` in Festlandchina den POST-Body nicht verwirft. SOCKS/curl verwendet dieselben Browser-Header wie der native Transport und behebt damit HTTP 401; leere Antworten und Antworten ohne JSON melden klare Fehler.
+<details>
+<summary><b>Nach Installation oder Update fehlt der Übersetzungseintrag</b></summary>
 
-**1.2.10 DSH-Profilkompatibilität:** Die Erkennung folgt dem laufenden Desktop/Web-Profil und liest `profiles/<profile>/cordis.patch.yml` (`id` + `config`), danach die Home-Patches und Start-Overlays. Das ältere `settings.yaml` bleibt unterstützt. Die Standardmodell-Zeile heißt `default-model`; Zugangsdaten bleiben in `.credentials.yaml` im DSH-Home und nur im Arbeitsspeicher. Die Diagnose zeigt die tatsächlich gelesene Datei.
+Starte `dsh web` vollständig neu. Der Modulgraph entsteht beim Prozessstart; Neuladen der Seite reicht eventuell nicht. Unten in den Einstellungen steht die installierte Paketversion.
 
-**1.2.9 Sprachkorrekturen:** Japanische Vokabelhinweise gelten nur für Japanisch; OpenAI/Anthropic erhalten den vollständigen Sprachnamen. Bing nutzt `auto-detect` und `zh-Hans`/`zh-Hant`. Die Erkennung chinesischer Prosa blendet Pfade, Code und JSON aus: vereinfachte Prosa wird übersprungen, häufige traditionelle Schriftzeichen lösen eine Übersetzungsanfrage aus, japanische/koreanische Prosa wird übersetzt. Alte Übersetzungen werden einmalig aus dem Cache entfernt; Einstellungen bleiben erhalten.
+</details>
 
-## 🚀 Verwendung
+<details>
+<summary><b>Die Liste lokaler Modelle ist leer</b></summary>
 
-1. **Einstellungen → Übersetzung der Gedankenkette** öffnen
-2. Die **Zielsprache** wählen (z. B. Deutsch) — Einstellungen, Denkzeilen und Karten wechseln in diese Sprache
-3. Die **Anbieterkette** verwalten (ziehen zum Sortieren, ankreuzen zum Aktivieren):
-   - Integriert: **google gtx / bing** (kostenlos, über den Systemproxy) und **lokales Ollama**; vorhandene Software/Modelle werden wiederverwendet. Fehlende Komponenten werden erst über die Vorbereitungsschaltfläche installiert/heruntergeladen, mit Fortschritt (7b/14b oder eigenes Modell)
-   - **DSH-Anbieter**: in `profiles/<profile>/cordis.patch.yml` / älteres `settings.yaml` konfigurierte Endpunkte erscheinen automatisch (schreibgeschützt; ankreuzen fügt sie der Kette hinzu). Die Schaltfläche **Aus DSH-Konfiguration übernehmen** direkt unter der Liste liest die Konfiguration neu ein und fügt alle auf einmal hinzu – keine baseURL und kein Schlüssel zum Neutippen, denn der Schlüssel wird aus den DSH-Credentials aufgelöst
-   - Der Schlüssel wird eingetippt oder kommt als **`apiKeyEnv`** aus einer Vorlage bzw. einer DSH-Zeile: diese Zeile zeigt das `env:NAME`-Abzeichen, und der Schlüssel wird pro Anfrage aufgelöst und nie in `config.json` geschrieben. Das Bearbeitungsformular hat kein Feld für die Umgebungsvariable (der Wert bleibt erhalten), aber ein geleertes Feld wird wirklich gelöscht (als explizite Löschung gesendet)
-   - Abgewählte Anbieter werden übersprungen. Details stehen in [README.md](README.md)
-4. Nachricht senden und die Think-Zeile aufklappen, um die Übersetzung zu sehen
+Prüfe `ollama list` oder `/api/tags`, das aktive Modellverzeichnis und `OLLAMA_MODELS` des Dienstes. Vorhandene Dateien müssen nicht erneut geladen werden.
 
-## ⚙️ Funktionsweise
+</details>
 
-```
-Browser → POST /_xlate/translate (gleiche Origin, kein CORS)
-  → Anbieterkette im Host (fail-open, umsortierbar):
-      chain: [provider1, provider2, ...]   ← Reihenfolge per Drag in den Einstellungen
-        google / bing / OpenAI-kompatibel / Anthropic
-      Fallback-Kette (optional, standardmäßig aus, in der Config aktivierbar)
-  → Originaltext, wenn alle aktivierten Anbieter fehlschlagen
-```
+<details>
+<summary><b>Client bundles not found nach einem DSH-Update</b></summary>
 
-- Die **Anbieter-Konfiguration** liegt in `config.json` (zur Laufzeit erzeugt, gitignoriert): `chain` (geordnete IDs), `fallback` (enabled + chain, nur Datei), `providers` (je Anbieter `type`/`enabled`/`baseURL`/`apiKey`/`apiKeyEnv`/`model`). Alte `priority`-Konfigurationen werden automatisch migriert; ein Anbieter mit `apiKeyEnv` löst seinen Schlüssel pro Anfrage aus dieser Umgebungsvariable auf (der literale `apiKey` bleibt als Rückfall) und kein aufgelöster Schlüssel wird je in `config.json` zurückgeschrieben; ein `null` in einem Patch löscht das Feld — so leert die Oberfläche eines
-- Die **DSH-Erkennung** liest beim Laden `profiles/<profile>/cordis.patch.yml` / älteres `settings.yaml` (`llm-pi-ai.providers`) und `.credentials.yaml` (`refs`) des Harness; erkannte Anbieter tragen `source: "dsh"`, aufgelöste Schlüssel bleiben im Speicher (nie in `config.json`), und die Route `/_xlate/dsh-scan` liest sie bei Bedarf neu ein
-- **Host-Hälfte** (`lib/index.js`): Anbieteradapter, LRU-Cache (600), `/_xlate/models`, `/_xlate/model/pull` + `pull-status` (automatische Konfiguration am Ende)
-- **Client-Hälfte** (`lib/client.js`): 8-sprachige UI, satzweise Batch-Übersetzung, Streaming-Think-Zeilen, localStorage-Persistenz
-- Reine Anzeigeschicht: Originale bleiben im Verlauf und im Modellkontext erhalten
+Führe `pnpm run build` im DeepSeek-Harness-Repository aus und starte DSH Web neu.
 
-## 🛠 Entwicklung
+</details>
 
-- Kein Build-Schritt: `lib/client.js` ist das Browser-Bundle (Quelle = Artefakt); `lib/index.js` ist das Host-ESM
-- Client-Änderungen greifen nach dem Aktualisieren; Host-Änderungen erfordern einen Web-Neustart
-- Die 8-sprachigen Texte stehen im `UI_TEXT`-Wörterbuch in `lib/client.js`
+<details>
+<summary><b>Beeinflusst ein Übersetzungsfehler das Gespräch?</b></summary>
 
-## 📄 Lizenz
+Scheitern alle aktiven Anbieter, bleibt das Original. Teste einzelne Anbieter und prüfe den letzten Fehler. Nach der Wartezeit können neue Übersetzungsanfragen erneut versuchen.
+
+</details>
+
+<details>
+<summary><b>Änderungen und Kompatibilität</b></summary>
+
+**1.2.17** übernimmt gespeicherte Leerlaufzeiten für bereits geladene Ollama-Modelle, wartet bis zu 120 Sekunden auf lokale Inferenz und zeigt die Restzeit an. Behebt reproduzierbare Teile von Issue #17; langfristiger Speicheranstieg wird weiter untersucht.
+
+**1.2.16** ergänzt Portugiesisch als Ziel- und Oberflächensprache, erneuert alle neun READMEs und Vergleichsbilder und erklärt drei Marktplatzbilder.
+
+**1.2.15** ergänzt lokale Speicherverwaltung und passt Bilder, gruppiertes Einklappen und Originalauswahl an DSH `0.2.2-alpha.2` an.
+
+**1.2.13** übersetzt Ablehnungsgründe der automatischen Prüfung. Danke an [llg1634](https://github.com/llg1634) für Bericht, ersten Patch und Tests.
+
+Weitere Versionen: [GitHub Releases](https://github.com/UncleK/dsh-think-translate/releases).
+
+</details>
+
+<details>
+<summary><b>Entwicklung und Funktionsweise</b></summary>
+
+- `lib/index.js`: Host-Routen, Anbieter, Konfiguration, Cache und lokale Modelle.
+- `lib/client.js`: Einstellungen, Anzeigeübersetzung, Streaming-Batches und Browser-Cache.
+- `lib/config.json`: Laufzeitkonfiguration, von Git und npm ausgeschlossen.
+- Kein zusätzlicher Build: Die Quellen sind das Ergebnis. Nach Host-Änderungen DSH neu starten.
+- Prüfen mit `npm test`. Erkennung und Zugangsdaten: [Wartungsnotizen](https://github.com/UncleK/dsh-think-translate/blob/main/docs/maintenance-notes.md).
+
+</details>
+
+---
 
-MIT
+<p align="center">
+  <b>dsh-think-translate</b><br />
+  <a href="https://github.com/UncleK/dsh-think-translate/issues">Problem melden</a> &nbsp;·&nbsp; <a href="https://github.com/UncleK/dsh-think-translate/releases">Versionen</a> &nbsp;·&nbsp; <a href="https://github.com/UncleK/dsh-think-translate/blob/main/LICENSE">MIT-Lizenz</a>
+</p>