SPB Git

Repository Public

AUTOMATION.md 4.8 KB

# Automatisation et extensions — SP Browser

# Catalogue de commandes

Chaque action du navigateur a un identifiant stable (CommandID, dans SPBrowser/Core/Automation/Commands.swift). Menus, raccourcis, palette ⌘K et App Intents passent tous par BrowserWindowState.perform(_:). Les raccourcis se modifient dans Réglages › Clavier ; les conflits y sont signalés.

Catégorie Identifiants (raccourci par défaut)
Fichier newTab ⌘T · newWindow ⌘N · newPrivateWindow ⇧⌘N · openFile ⌘O · openLocation ⌘L · closeTab ⌘W · closeWindow ⇧⌘W · savePageAsPDF · capturePage · printPage ⌘P · sharePage · openSettings ⌘,
Édition findInPage ⌘F · findNext ⌘G · findPrevious ⇧⌘G
Présentation reload ⌘R · hardReload ⇧⌘R · stopLoading ⌘. · zoomIn ⌘= · zoomOut ⌘- · zoomReset ⌘0 · toggleSidebar ⌃⌘S · toggleTabLayout · toggleFocusMode ⇧⌘F · toggleReader ⌥⌘R · toggleFullScreen ⌃⌘F · commandPalette ⌘K · toggleSplitView ⌘\ · swapSplit
Historique goBack ⌘[ · goForward ⌘] · goHome ⇧⌘H · reopenClosedTab ⇧⌘T · showHistory ⌘Y · clearHistory
Onglets nextTab ⇧⌘] · previousTab ⇧⌘[ · searchTabs ⇧⌘A · duplicateTab ⇧⌘D · pinTab · newTabGroup · moveTabToNewWindow · closeOtherTabs ⌥⌘W · suspendTab · nextWorkspace ⌃⌥⌘→ · previousWorkspace ⌃⌥⌘← · ⌘1…⌘9
Signets addBookmark ⌘D · showBookmarks ⌥⌘B · importBookmarks · exportBookmarks
Outils showDownloads ⌥⌘L · showNotes · showSessions · saveSession · toggleIntelligence ⇧⌘I · pageInfo ⌘I · toggleBlockerForSite · clearSiteData · viewSource ⌥⌘U · pageMetadata · changeUserAgent

Dans la palette : > limite aux commandes, @ aux onglets, # aux signets.

# App Intents (app Raccourcis, Spotlight)

Intent Effet
Ouvrir une adresse dans SP Browser Ouvre une adresse http(s) dans un nouvel onglet
Rechercher sur le web dans SP Browser Recherche avec le moteur par défaut
Nouvelle fenêtre privée dans SP Browser Ouvre une fenêtre privée

Ils ne lisent ni contenu de page, ni historique, ni cookies, et n'agissent sur aucun site. Aucune API réseau locale n'est ouverte et aucun schéma d'URL personnalisé n'expose de commandes. Ces intents compilent et sont déclarés dans l'application ; ils n'ont pas été exercés depuis l'app Raccourcis.

# Scripts utilisateur

Réglages › Scripts utilisateur. Désactivés par défaut. Chaque script déclare ses sites (exemple.com = ce site et ses sous-domaines ; *.exemple.com = sous-domaines seulement) ; il n'existe pas de joker « tous les sites ». Le code est enveloppé dans une garde qui revérifie l'hôte, injecté dans un monde JavaScript isolé (accès au DOM, aucun objet partagé avec la page ni avec le navigateur), jamais en fenêtre privée. Aucune API privilégiée n'est offerte aux scripts : pas d'équivalent de GM_xmlhttpRequest.

# Extensions : état réel

  • Extensions Chrome, Firefox ou Safari : non prises en charge. SP Browser ne peut pas installer d'extension depuis une boutique et ne l'annonce pas.
  • Ce qui existe dans l'API publique : depuis macOS 15.4, WebKit fournit WKWebExtension, WKWebExtensionContext et WKWebExtensionController, qui permettent à une application d'héberger des Web Extensions (format WebExtensions) dans ses WKWebView. C'est la seule voie légitime. Elle n'est pas utilisée ici parce que la cible minimale est macOS 14 et parce que charger du code tiers demande un modèle de permissions complet (hôtes autorisés, permissions par extension, interface de consentement, mises à jour, révocation) qui n'a pas été conçu ni testé.
  • Conséquence : la colonne « Extensions » de la matrice est à « Non pris en charge », pas à « Partiel ».

# Esquisse d'une architecture de plugins (non implémentée)

Si elle devait être construite, elle reposerait sur WKWebExtension plutôt que sur un format maison :

  1. Manifeste : manifest.json WebExtensions, validé à l'installation ; refus des permissions <all_urls> et natives par défaut.
  2. Capacités minimales : scripts de contenu limités aux hôtes déclarés et acceptés un par un ; pas d'accès à l'historique, aux signets, aux cookies d'autres sites ni au Trousseau.
  3. Cycle de vie : installation explicite depuis un fichier, désactivée tant que les permissions ne sont pas acceptées, désactivation et suppression en un clic, aucune mise à jour silencieuse, jamais active en fenêtre privée sans accord distinct.
  4. Isolement : le code tiers ne s'exécute que dans les processus WebKit, jamais dans le processus de l'application ; aucun chargement de bundle ou de bibliothèque tiers.
Files main
Menu

Theme