Skip to content

Schnellleiste: NSPanel-Workaround absichern - #15

Merged
bl0rb merged 1 commit into
mainfrom
codex/nspanel-absichern
Nov 19, 2026
Merged

bl0rb merged 1 commit into
mainfrom
codex/nspanel-absichern

Conversation

@bl0rb

@bl0rb bl0rb commented Nov 18, 2026

Copy link
Copy Markdown
Owner

Was

Der Klassentausch, der die Schnellleiste unter macOS zum nicht aktivierenden NSPanel macht, ist jetzt abgesichert (neues Modul src-tauri/src/quick_panel.rs):

  • Laufzeitprüfung vor dem Tausch: Klassenname, Oberklasse NSWindow, Ivars (nur focusable), Overrides (nur die bekannten tao-Methoden), Instanzgröße sowie Offset und Typ der Ivar werden gegen das geprüfte tao 0.37.1 verglichen. Weicht etwas ab, bleibt die Schnellleiste ein gewöhnliches schwebendes Fenster (Anzeigen aktiviert dann die App); kein unsicherer Tausch, kein Absturz.
  • KVO-Unterklasse: Zur Laufzeit ist das Fenster tatsächlich NSKVONotifying_TaoWindow (WebKit/AppKit beobachten contentLayoutRect, titlebarAppearsTransparent, _windowLayerContext). Das hat der bisherige Code unbemerkt mitgetauscht. Zulässig ist es jetzt nur, solange die Unterklasse ausschließlich setContentView: überschreibt (gemessen unter macOS 27).
  • tao-sendEvent:: Wird beim Tausch verworfen. Das ist nur für Fenster relevant, die über den Hintergrund verschiebbar sind, deshalb lehnt make_panel solche ab.
  • Aktivierung beim Klick: Nach dem Tausch setzt setStyleMask: das WindowServer-Flag „prevents activation“ nicht. Unter macOS 27 aktivierte ein Klick ins Panel deshalb die App. Jetzt wird der private Selektor _setPreventsActivation: aufgerufen, nur wenn AppKit ihn hat (wie tauri-nspanel PR #139).
  • Stolperdraht: Der Test tao_version_is_the_audited_one schlägt an, sobald sich tao in Cargo.lock ändert. Dependabot-PRs der Tauri-Gruppe brauchen dann eine bewusste Prüfung von TaoWindow.
  • Dokumentierte Grenze: Die Schnellleiste darf nie geschlossen oder zerstört werden, sonst wirft Foundation beim Entfernen der alten Beobachter eine Ausnahme. Heute versteckt Schließen nur, und Beenden baut keine Fenster ab.

Geprüft

  • cargo test --locked: 22 Tests grün, davon 15 neu mit synthetischen Klassen für zulässiges Layout und die Ablehnungsfälle.
  • cargo clippy --all-targets: ohne Warnungen.
  • Lokal unter macOS 27.2.1 gestartet (temporäre Debug-Ausgabe, wieder entfernt): Die Klasse wird OpenVizPilotQuickPanel, und _preventsActivation ist gesetzt.
  • Adversariales Review aus vier Blickwinkeln, jeder Befund einzeln gegengeprüft. Die bestätigten Punkte sind eingearbeitet: Kommentar, Test, Aktivierungs-Flag.

Nicht geprüft

  • Echter Klick ins Overlay über einer Vollbild-App.
  • Windows-Build: lokal nicht cross-kompilierbar, das prüft die CI.
  • macOS 14/15: Weicht die KVO-Unterklasse dort ab, greift der Rückfall auf ein gewöhnliches Fenster; der Grund landet nur auf stderr.

🤖 Generated with Claude Code

Der Klassentausch des Overlay-Fensters zum NSPanel prüft jetzt vorher die
Laufzeitklasse gegen das geprüfte tao-Layout (0.37.1): Name, Oberklasse,
Ivars, Overrides, Größe und Ivar-Offset. Die KVO-Unterklasse
NSKVONotifying_TaoWindow, die zur Laufzeit tatsächlich vorliegt, ist
ausdrücklich zugelassen, solange sie nur setContentView: überschreibt.
Weicht etwas ab, bleibt die Schnellleiste ein gewöhnliches Fenster statt
eines unsicheren Tauschs.

Zusätzlich setzt make_panel das WindowServer-Flag über den privaten
Selektor _setPreventsActivation: (nur wenn vorhanden), sonst aktiviert
ein Klick ins Panel unter macOS 27 die App (vgl. tauri-nspanel #139).
Ein Test schlägt an, sobald sich tao in Cargo.lock ändert.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@bl0rb
bl0rb merged commit 4ba86f8 into main Nov 19, 2026
3 checks passed
@bl0rb
bl0rb deleted the codex/nspanel-absichern branch November 19, 2026 10:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant