SPB Git

Repository Public

AUTOMATION.md 4.8 KB 47 lines markdown

1# Automatisation et extensions — SP Browser23## Catalogue de commandes45Chaque 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.67| Catégorie | Identifiants (raccourci par défaut) |8|---|---|9| Fichier | `newTab` ⌘T · `newWindow` ⌘N · `newPrivateWindow` ⇧⌘N · `openFile` ⌘O · `openLocation` ⌘L · `closeTab` ⌘W · `closeWindow` ⇧⌘W · `savePageAsPDF` · `capturePage` · `printPage` ⌘P · `sharePage` · `openSettings` ⌘, |10| Édition | `findInPage` ⌘F · `findNext` ⌘G · `findPrevious` ⇧⌘G |11| Présentation | `reload` ⌘R · `hardReload` ⇧⌘R · `stopLoading` ⌘. · `zoomIn` ⌘= · `zoomOut` ⌘- · `zoomReset` ⌘0 · `toggleSidebar` ⌃⌘S · `toggleTabLayout` · `toggleFocusMode` ⇧⌘F · `toggleReader` ⌥⌘R · `toggleFullScreen` ⌃⌘F · `commandPalette` ⌘K · `toggleSplitView` ⌘\ · `swapSplit` |12| Historique | `goBack` ⌘[ · `goForward` ⌘] · `goHome` ⇧⌘H · `reopenClosedTab` ⇧⌘T · `showHistory` ⌘Y · `clearHistory` |13| Onglets | `nextTab` ⇧⌘] · `previousTab` ⇧⌘[ · `searchTabs` ⇧⌘A · `duplicateTab` ⇧⌘D · `pinTab` · `newTabGroup` · `moveTabToNewWindow` · `closeOtherTabs` ⌥⌘W · `suspendTab` · `nextWorkspace` ⌃⌥⌘→ · `previousWorkspace` ⌃⌥⌘← · ⌘1…⌘9 |14| Signets | `addBookmark` ⌘D · `showBookmarks` ⌥⌘B · `importBookmarks` · `exportBookmarks` |15| Outils | `showDownloads` ⌥⌘L · `showNotes` · `showSessions` · `saveSession` · `toggleIntelligence` ⇧⌘I · `pageInfo` ⌘I · `toggleBlockerForSite` · `clearSiteData` · `viewSource` ⌥⌘U · `pageMetadata` · `changeUserAgent` |1617Dans la palette : `>` limite aux commandes, `@` aux onglets, `#` aux signets.1819## App Intents (app Raccourcis, Spotlight)2021| Intent | Effet |22|---|---|23| Ouvrir une adresse dans SP Browser | Ouvre une adresse http(s) dans un nouvel onglet |24| Rechercher sur le web dans SP Browser | Recherche avec le moteur par défaut |25| Nouvelle fenêtre privée dans SP Browser | Ouvre une fenêtre privée |2627Ils 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.2829## Scripts utilisateur3031Ré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`.3233## Extensions : état réel3435- **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.36- **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é.37- **Conséquence** : la colonne « Extensions » de la matrice est à « Non pris en charge », pas à « Partiel ».3839## Esquisse d'une architecture de plugins (non implémentée)4041Si elle devait être construite, elle reposerait sur `WKWebExtension` plutôt que sur un format maison :42431. **Manifeste** : `manifest.json` WebExtensions, validé à l'installation ; refus des permissions `<all_urls>` et natives par défaut.442. **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.453. **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.464. **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.47
Files main
Menu

Theme