Fehler eingrenzen, ohne Schutzschritte zu überspringen.

Prüfe zuerst, ob AYVI im Menüleistenbereich läuft und ob macOS AYVI nicht durch Gatekeeper blockiert hat. Ein Menüleistenprogramm zeigt nicht zwingend ein Dock-Fenster. Wenn die App keinen Accessibility-Zugriff hat, öffnet sie möglicherweise die Berechtigungserklärung statt der normalen Hilfe.

Standard ist ⌥ Space; in AYVI Einstellungen den Shortcut ansehen und auf einen Konflikt mit anderer Software prüfen. Nach einer Änderung teste mit einer harmlosen Textauswahl. Shortcut-Zustellung wurde hier nicht interaktiv auf diesem Mac abgenommen.

Öffne Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen. Prüfe, ob das aktuelle /Applications/AYVI.app eingeschaltet ist. Falls die App nach einem Build weiterhin um Zugriff bittet, entferne nur den veralteten AYVI-Eintrag und füge das aktuelle App-Bundle neu hinzu. Beende und starte AYVI neu. Siehe Installationsschritt 4.

Accessibility-Unterstützung hängt von der Ziel-App, dem fokussierten Element und der Textart ab. Prüfe zunächst in einer anderen einfachen Text-App. Manche Chromium-/Electron-Ansichten stellen Auswahl oder Bereich unvollständig bereit. AYVI liest nicht automatisch das ganze Dokument. Der Clipboard-Weg muss sichtbar gewählt und separat bestätigt werden.

AYVI bricht bei geänderter App, geändertem fokussierten Element, abweichendem Text/Fingerprint oder nicht mehr passendem Bereich ab. Das ist ein Schutzverhalten: Ergebnis bleibt kopierbar; erfasse die Auswahl erneut. Für Clipboard-Einfügen ist eigene Zustimmung erforderlich. Teste nicht zuerst an wichtigen Dokumenten.

Der Provider benötigt macOS 26 oder neuer, unterstützte Hardware sowie Apple Intelligence und ein bereites Systemmodell. Einstellungen oder Onboarding zeigen die Verfügbarkeitsursache. Prüfe die Apple-Intelligence-Einstellungen und warte, wenn macOS das Modell noch lädt; AYVI fordert keine separate Berechtigung an und wechselt nicht still zur Cloud. Bis dahin kannst du Mock oder einen anderen bewusst gewählten Provider nutzen.

Die Bildschirm-OCR ist standardmäßig ausgeschaltet. Nach Aktivierung unter Einstellungen → Datenschutz wird die Berechtigung erst nach Klick auf „Bereich erfassen“ und einer Erklärung angefragt. Wenn macOS sie verweigert, prüfe Datenschutz & Sicherheit → Bildschirmaufnahme, aktiviere AYVI und starte die App erneut. Ziehe einen ausreichend großen, lesbaren Bereich; PDF-/Video- oder niedrig aufgelöste Texte können unvollständig bleiben. Du kannst den Text vor Nutzung bearbeiten; die OCR-Auswahl kann nicht ersetzt werden.

Aktiviere es unter Einstellungen → Allgemein (Standard: aus). Der Button erscheint nur unter fertigen Antworten mit einem Java-, Swift- oder Python-Codeblock. Meldet AYVI „Compiler nicht gefunden“: Für Swift und Python installierst du die Command Line Tools mit xcode-select --install, für Java ein JDK (Prüfung mit javac -version). AYVI installiert nichts automatisch. Der erste Swift-Lauf kann bis zu 30 Sekunden dauern. Code ausführen kann AYVI weiterhin nicht.

AYVI zeigt sie nur mit validierter Auswahl und aktuellen AXBoundsForRange-Daten. Bei fehlenden oder unvollständigen Bounds, einer geänderten Auswahl oder einem App-Wechsel werden Marker nicht angezeigt bzw. geschlossen; nutze dann die Liste „Zeilenerklärungen“ im Panel, die auch ohne Marker und mit Tastatur und VoiceOver funktioniert. Scroll-/Editorpositionierung ist für Ziel-Apps noch nicht manuell freigegeben.

Der Eintrag erscheint nur bei markiertem Text und erst, wenn macOS die installierte App registriert hat. Starte /Applications/AYVI.app einmal und führe dann /System/Library/CoreServices/pbs -update aus oder melde dich ab und wieder an. Prüfe, ob der Eintrag unter Systemeinstellungen → Tastatur → Tastaturkurzbefehle → Dienste aktiviert ist. Text aus dem Dienste-Menü ist nur lesbar.

Sie muss zunächst in Einstellungen → Allgemein eingeschaltet werden. Bei der ersten Nutzung erscheint eine Erklärung; erst nach „Berechtigungen anfragen“ fragt macOS Mikrofon- und Spracherkennungszugriff an. Prüfe die entsprechenden Schalter in Systemeinstellungen → Datenschutz & Sicherheit. Ein kurzer Shortcut-Klick bleibt die normale AYVI-Aktion; halte ihn mindestens 0,4 Sekunden. On-device Speech muss für die gewählte Sprache verfügbar sein; AYVI nutzt keinen Server-Fallback. Reale Mikrofonaufnahme und Hotkey-Freigabe wurden in diesem Build nicht interaktiv verifiziert.

Prüfe unter Einstellungen → Lernen, ob der standardmäßig ausgeschaltete Lernpfad aktiviert wurde. Die Erkennung arbeitet nur mit Java-markierten Auswahlen und ist eine begrenzte Heuristik; sie wertet keine Kommentare oder String-Literale als Code aus und kann Konzepte verpassen. Ein Konzept wird nicht allein durch Auswahl oder Ansicht gespeichert: nutze eine explizite Statusaktion. Wenn ein Speicherfehler angezeigt wird, prüfe den lokalen Application Support-Zugriff. Beim Cloud-Erklären erscheinen Lernmetadaten nur, wenn sowohl der Lernpfad als auch der getrennte Prompt-Kontext-Schalter aktiv sind.

Prüfe, ob Ollama läuft, die konfigurierte Base URL und der Port stimmen und das ausgewählte Modell installiert ist. In AYVI kann der Verbindungstest unter Einstellungen → KI helfen. Fehlermeldungen aus dem lokalen Test sind nicht mit einem getesteten Modellverhalten gleichzusetzen.

401 weist meist auf falschen/fehlenden Schlüssel, falsches Konto oder nicht freigeschaltetes Modell hin; prüfe Provider-Einstellungen und das Provider-Konto. Bei Rate Limits gelten Limits des jeweiligen Providers; warte, reduziere Anfragen oder prüfe dein Kontingent. Gib API-Schlüssel niemals in Supporttext oder Auswahl ein.

Prüfe Netzwerk, Anbieterstatus, Base URL und Modell. Es gibt keinen stillen Wechsel zu einem anderen Provider. Das angezeigte Ergebnis kann unvollständig sein; wende unvollständige Antworten nicht an. Die Website-Demo ist fest und nicht mit einem Netzwerkdienst verbunden.

Prüfe, ob der Build erfolgreich endete und /Applications/AYVI.app existiert. Dieses Entwicklungsbundle ist lokal selbstsigniert oder ad-hoc signiert und nicht notarisiert. Wir empfehlen nicht, Gatekeeper-Schutz pauschal zu deaktivieren oder Quarantäneattribute blind zu entfernen. Prüfe Repository/Herkunft und folge bei bewusster Ausführung nur offiziellen Apple-Hinweisen.

AYVI positioniert relativ zur erkannten Auswahl, wenn die Ziel-App Bounds liefert; andernfalls kann eine Maus-/Bildschirm-Fallbackposition verwendet werden. Mehrschirm-Positionierung ist durch Unit-Tests für Geometrie abgedeckt, nicht durch eine vollständige manuelle Matrix realer Monitor-Konfigurationen.

Native App-Animationen berücksichtigen die macOS-Einstellung für reduzierte Bewegung und eine eigene Option. Diese Kombination wurde nicht in einem manuellen Accessibility-Test abgenommen.

History ist nach einer Erststart-Information standardmäßig aktiv. Nutze die History-/Einstellungenansicht der App und deren Löschen-Funktion; Speicherung lässt sich unter Datenschutz ausschalten. Provider-Schlüssel verwaltest du unter Einstellungen → KI; entferne nur das Credential des gewünschten Providers. Website-Einstellungen enthalten keine Schlüssel.