feat(agent): make assistant opt-in with product-focused editing flow

Author: chaxus

.gitignore

@@ -236,3 +236,10 @@ public/pt/index.html
 
 # Temporary ignore lists used by archive-aware quality checks.
 /.archive-quality-*.ignore
+
+# Generated AI assistant product guides.
+/public/ai-document-assistant.html
+/public/*/ai-document-assistant.html
+
+# Local implementation plans and verification logs.
+/.superpowers/

.prettierignore

@@ -190,3 +190,10 @@ public/pt/index.html
 
 # Hash-pinned generated CPU runtime and upstream source patches.
 packages/agent-core/vendor/wllama-count/
+
+# Local implementation plans and verification logs.
+/.superpowers/
+
+# Generated assistant guides.
+/public/ai-document-assistant.html
+/public/*/ai-document-assistant.html

CLAUDE.md

@@ -1132,3 +1132,7 @@ E2E 回归套件覆盖**（`pnpm run test:e2e` 的 embed-regression.spec：打
 - `getSavedFileMimeType` / `getNormalizedFile` / `toUint8Array` — 纯计算逻辑
 - `setReadonlyMode` / `getReadonlyMode` — 状态读写
 - `requestSaveDocument` — 所有拒绝路径（无编辑器、只读、并发、超时、不支持 downloadAs）
+
+### AI assistant product entry
+
+`lib/agent-entry.ts` owns the discoverable entry and browser-local default-off preference. URL `agent` flags do not enable it. Opening restores only UI/preferences; loading a model or connecting a service requires an explicit user action. Generated writing must be reviewed before applying. Developer transport and provider details belong in developer references, not product onboarding.

bin/pages/pages.mjs

@@ -8,6 +8,7 @@ import { ROOT } from './constants.mjs';
 import { LOCALES } from './locales.mjs';
 
 export const LANDING_SLUGS = [
+  'ai-document-assistant',
   'offline-document-editor',
   // en + zh only, on purpose: this one targets people searching for ONLYOFFICE
   // itself, and the shell derives hreflang and the language switch from the

bin/pages/render-home.mjs

@@ -279,6 +279,16 @@ ${rows}
         </div>
       </div>
 
+      <section class="section wrap assistant-feature" aria-labelledby="assistant-heading">
+        <div class="assistant-feature-copy">
+          <span class="eyebrow">${e(data.sections.assistant.eyebrow)}</span>
+          <h2 id="assistant-heading">${e(data.sections.assistant.h2)}</h2>
+          <p>${e(data.sections.assistant.p)}</p>
+          <a class="assistant-guide" href="${e(data.sections.assistant.href)}">${e(data.sections.assistant.cta)} &rarr;</a>
+        </div>
+        <div class="assistant-feature-example"><span>${e(data.sections.assistant.note)}</span><blockquote>${e(data.sections.assistant.example)}</blockquote></div>
+      </section>
+
       <div class="section wrap">
         <div class="section-head">
           <span class="eyebrow">${e(data.sections.pillars.eyebrow)}</span>

content/de/about.md

@@ -11,7 +11,7 @@ lead: Wer das hier baut, was es wirklich kann — und wie Sie beides selbst übe
 
 Ein **Editor für Office-Dokumente im Browser**. Sie öffnen eine Word- (DOCX), Excel- (XLSX), PowerPoint- (PPTX), CSV- oder PDF-Datei und bearbeiten sie direkt im Browser-Tab.
 
-Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der integrierte KI-Assistent ist noch nicht fertig und keine veröffentlichte Funktion. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
+Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Standardmäßig aus · Nur dieser Browser. [Anleitung](/de/ai-document-assistant). Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
 
 Bei aktivierter automatischer Sicherung bleiben Wiederherstellungskopien in der IndexedDB dieses Browsers für 7 Tage nach dem letzten Bearbeiten oder Öffnen. Das Schließen des Tabs löscht sie nicht. Unter /history können Sie Kopien löschen oder die automatische Sicherung deaktivieren. Browserspeicher kann gelöscht oder verdrängt werden; noch nicht gesicherte Änderungen können verloren gehen. Wiederherstellung ersetzt das Speichern der Datei nicht.
 

content/de/ai-document-assistant.md

@@ -0,0 +1,30 @@
+---
+title: 'KI-Dokumentassistent — Klarer schreiben. Selbst entscheiden.'
+description: 'Text auswählen und umformulieren, zusammenfassen oder übersetzen. Prüfen Sie das Ergebnis, bevor Sie es einfügen. Standardmäßig aus · Nur dieser Browser'
+---
+
+Text auswählen und umformulieren, zusammenfassen oder übersetzen. Prüfen Sie das Ergebnis, bevor Sie es einfügen.
+
+## KI-Assistent aktivieren
+
+Standardmäßig aus · Nur dieser Browser. Nach dem Aktivieren die Nutzung wählen. Den ersten Download starten Sie selbst und können ihn abbrechen. Panel schließen und weiter bearbeiten. Ausschalten in den Einstellungen stoppt Aufgaben. Gespräche bleiben standardmäßig nur in dieser Sitzung; Speicherung im Verlauf ausdrücklich aktivieren.
+
+## KI-Nutzung
+
+**Auf diesem Computer nutzen** — Der Text wird auf diesem Gerät verarbeitet. Die erste Einrichtung lädt Dateien und kann den Computer verlangsamen; Abbruch ist möglich.
+
+**Eigenen KI-Dienst nutzen** — Gesendeter Text geht an den gewählten Dienst. Eigene Zugangsdaten sind erforderlich; es können Kosten entstehen.
+
+## Anleitung
+
+Eine Passage auswählen, dann umformulieren, zusammenfassen oder übersetzen. Aufgaben füllen nur den Entwurf und senden nicht automatisch.
+
+> Diesen Absatz kürzen und alle Daten und Zahlen erhalten.
+
+Original und Ergebnis vergleichen und das Ersetzen bestätigen. Kopieren ist ebenfalls möglich. Bei Bedarf im Editor rückgängig machen. Eine geänderte Auswahl erfordert einen neuen Vorschlag.
+
+Einrichtung und Generierung lassen sich stoppen. Fehler behalten den Entwurf. Schreibgeschützte Dokumente lassen sich nicht ändern. Offline-Nutzung erfordert bereits vorbereitete Dateien.
+
+KI kann Fakten auslassen oder verändern. Daten, Zahlen und Namen prüfen. Umformulieren, Zusammenfassen und Übersetzen unterstützen derzeit Word-Auswahlen; andere Dokumente unterstützen bestehende ausdrückliche Aktionen.
+
+[Anleitung](/de/help)

content/de/convert/csv-to-xlsx.md

@@ -33,7 +33,7 @@ Kundenlisten, Buchhaltungsexporte, Log-Auszüge — je weniger Sie sie einem fre
 
 ### Wird meine Datei zum Umwandeln hochgeladen?
 
-Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der integrierte KI-Assistent ist noch nicht fertig und keine veröffentlichte Funktion. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
+Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der KI-Assistent ist standardmäßig aus. Aktivieren Sie ihn im Editor; Downloads und Verbindungen starten Sie selbst. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
 
 ### Brauche ich Excel oder ein Konto?
 

content/de/convert/docx-to-pdf.md

@@ -33,7 +33,7 @@ Das ist die praktische Wahl, wenn das Dokument nicht Ihres ist, um es weiterzuge
 
 ### Wird meine Datei zum Umwandeln hochgeladen?
 
-Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der integrierte KI-Assistent ist noch nicht fertig und keine veröffentlichte Funktion. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
+Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der KI-Assistent ist standardmäßig aus. Aktivieren Sie ihn im Editor; Downloads und Verbindungen starten Sie selbst. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
 
 ### Brauche ich Word oder ein Konto?
 

content/de/convert/pptx-to-pdf.md

@@ -33,7 +33,7 @@ Das ist die praktische Wahl, wenn das Dokument nicht Ihres ist, um es weiterzuge
 
 ### Wird meine Datei zum Umwandeln hochgeladen?
 
-Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der integrierte KI-Assistent ist noch nicht fertig und keine veröffentlichte Funktion. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
+Das Öffnen, Bearbeiten und Konvertieren im Kerneditor erfolgt lokal im Browser, ohne einen erforderlichen Dokument-Upload. Der KI-Assistent ist standardmäßig aus. Aktivieren Sie ihn im Editor; Downloads und Verbindungen starten Sie selbst. Eine einbettende Anwendung kann exportierte Dateien empfangen und nach ihrer eigenen Richtlinie hochladen.
 
 ### Brauche ich PowerPoint oder ein Konto?