9d10815415
Bug réel : chrome.runtime.sendMessage depuis un content script ne va QU'au background service worker en MV3. Le side panel qui écoute via chrome.runtime.onMessage ne reçoit jamais rien directement. Résultat : la sélection, le titre de la page et le contexte n'atteignaient jamais le panneau. Fix : - background.js : ajouter un onMessage qui forward SELECTION_CHANGED et PAGE_CONTEXT_CHANGED vers toutes les surfaces (side panel). - sidepanel.js applySelectionFromMessage : normaliser les URLs (ignorer query/fragment/trailing slash), amorcer pageUrl depuis le premier message si tabs.query a échoué, accepter une sélection qui arrive avant refreshPageContext. La v0.3.1 souffrait du même bug — la sélection fonctionnait parfois par chance quand Chrome routait le message avant que le side panel ne soit complètement initialisé. Maintenant c'est garanti.
Memento Web Clipper — extension Chrome
Clipper web avec panneau latéral : le panneau reste ouvert pendant que vous surlignez du texte sur la page.
Langues
L’extension suit la langue de l’interface Chrome (chrome.i18n.getUILanguage) — 15 locales comme l’app Memento : de, en, es, fr, it, pt, nl, pl, ru, zh, ja, ko, ar, fa, hi.
Fichiers : extension/_locales/<lang>/messages.json. Régénération : node extension/i18n/generate-translations.cjs puis node extension/scripts/build-extension-locales.mjs.
Installation (dev)
Chrome
chrome://extensions- Mode développeur → Charger l’extension non empaquetée → dossier
memento-note/extension - Épingle l’icône Memento
Chrome 114+ requis (Side Panel API).
Firefox
# Avec web-ext (https://extensionworkshop.com/)
npx web-ext run --source-dir memento-note/extension
Ou via about:debugging → Ce Firefox → Charger un module temporaire → sélectionner manifest.json.
Firefox 115+ requis (MV3 + sidebarAction).
Instance Memento
- Dev : icône ⚙ → URL (
http://localhost:3000ou IP LAN) → Appliquer & reconnecter - Connectez-vous sur la même URL dans Chrome (Google OAuth)
- Production (build Store) : mettre
ALLOW_INSTANCE_CONFIG = falsedanssidepanel.js→ URLhttps://memento-note.comen dur, réglages masqués
Utilisation
- Ouvrez une page web normale (pas
chrome://) - Cliquez l’icône Memento → panneau latéral
- Choisissez le carnet (liste hiérarchique)
- Optionnel : surlignez du texte → Clipper la sélection (bouton sky)
- Ou Clipper cette page (article complet + IA)
- Ou Enregistrer le lien seul
- Aperçu : titre éditable, résumé, extrait, temps de lecture → Enregistrer dans Memento
Dépannage
| Problème | Solution |
|---|---|
| Carnets vides / 401 | Ouvrir Memento ↗ sur la même URL, connectez-vous |
localhost vs 127.0.0.1 |
Utilisez toujours la même URL partout (cookies session) |
| Pas de sélection | Rechargez la page après install extension ; surlignez sur la page, pas dans le panneau |
| Page Chrome système | Impossible — ouvrez un site http(s) normal |
Persan / RTL
Détection automatique dir / lang (ex. BBC Persian), aperçu RTL avec Vazirmatn.
Builds production
Deux scripts produisent des paquets prêts à publier :
# Chrome Web Store (zip)
node extension/scripts/build-chrome-store.mjs
# → memento-note/extension/memento-web-clipper-chrome-store.zip (~44 Ko, 27 fichiers)
# Firefox Add-ons (xpi)
node extension/scripts/build-firefox.mjs
# → memento-note/extension/memento-web-clipper-firefox.xpi (~44 Ko, 27 fichiers)
Chaque build :
- Verrouille
ALLOW_INSTANCE_CONFIG = false(URL prod en dur) - Restreint les
host_permissionsàhttps://memento-note.com/* - Génère les PNG d'icônes depuis
public/icons/icon-{192,512}.svg - Exclut les fichiers internes (
i18n/,diagnose.js,test-sidepanel.html, etc.)
Différences manifest :
- Chrome :
side_panel(Side Panel API Chrome 114+) - Firefox :
sidebar_action+browser_specific_settings.gecko(Firefox 115+)
APIs
GET /api/clip/notebooksPOST /api/clip/analyzePOST /api/clip/save