zotero-AI-Butler : lire un PDF par procuration, sans quitter sa bibliothèque Zotero
【Zotero AI 管家】调用大模型，自动精读论文库里的论文，总结为Zotero笔记。支持主流大模型平台！您只需像往常一样把文献丢进 Zotero， 管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！
En bref
- De quoi s’agit-il ?
- Un plugin Zotero sous licence AGPL-3.0 qui envoie les PDF de votre bibliothèque vers un modèle de langage et range la réponse sous forme de note Markdown. Le point à trancher n'est pas la génération de texte, c'est ce que le plugin fait de vos fichiers et de votre clé API.
- À qui s’adresse-t-il ?
- Le plugin convient à ceux qui accumulent des PDF dans Zotero et veulent une note Markdown attachée à chaque entrée, avec une clé API qu'ils contrôlent. Il ne convient pas à qui refuse d'envoyer un PDF entier à un fournisseur externe, ni à qui veut une sortie identique d'une exécution à l'autre : la note générée est un artefact de modèle, pas un résumé vérifié.
- Puis-je l’utiliser commercialement ?
- Oui, sous conditions strictes. AGPL-3.0 est une licence à copyleft réseau : si des personnes utilisent une version modifiée via un réseau, par exemple comme service hébergé, vous devez leur proposer son code source sous la même licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 1 jour.
- En quel langage est-il écrit ?
- Principalement TypeScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Le problème visé : la pile de PDF que personne ne rouvre
Le README ouvre sur une formule qui résume la cible : les articles s'accumulent plus vite qu'ils ne se lisent. Le plugin ne cherche pas à améliorer la lecture, il cherche à produire un artefact consultable à la place du texte intégral. Concrètement, il génère une note Markdown enregistrée sous l'entrée Zotero correspondante, au même niveau que les notes natives, ce qui permet de l'ouvrir côte à côte avec le PDF. Le public visé est donc étroit et identifiable : des personnes qui utilisent déjà Zotero comme bibliothèque principale, qui y déposent des PDF, et qui acceptent de payer ou de configurer un accès à un modèle de langage. Une troisième condition, moins visible dans la description, pèse lourd : il faut être à l'aise avec l'idée qu'un document de recherche parte vers un service tiers. Le README affirme que le plugin ne collecte, ne stocke et ne transmet aucune donnée personnelle, aucun article et aucune clé API à l'auteur du plugin, et que les requêtes partent directement de la machine locale vers le fournisseur configuré. Cette affirmation porte sur le plugin, pas sur le fournisseur. C'est une distinction que le texte ne fait pas à la place du lecteur.
Ce qui circule réellement entre Zotero et le fournisseur
Deux modes de traitement des PDF coexistent, et le choix change la nature des données envoyées. Le mode texte extrait le contenu de la page avant l'appel ; le mode Base64 encode le PDF lui-même et l'envoie au modèle. Le README présente le second comme plus fidèle pour les formules, les tableaux et les mises en page complexes, et indique qu'il permet de traiter des PDF purement image. C'est cohérent : un modèle multimodal voit la page au lieu d'en lire une reconstruction textuelle. Mais c'est aussi le mode où le document brut sort de la machine, ce que le mode extraction évite en partie. Le README précise que le mode Base64 suppose un modèle multimodal, et que le mode texte s'adresse aux modèles qui ne le sont pas. Ce n'est donc pas un réglage de confort, c'est un arbitrage entre fidélité de lecture et quantité d'information transmise. Le plugin ne propose pas, d'après le matériel disponible, de traitement local obligatoire : même avec Ollama, le README mentionne le passage par extraction de texte ou par MinerU, ce qui laisse entendre que le PDF n'est pas envoyé tel quel dans cette configuration. Rien dans le matériel fourni ne permet de confirmer ce que MinerU fait exactement des fichiers.
Une file de tâches en producteur-consommateur, pas un bouton magique
Le README décrit explicitement un modèle producteur-consommateur pour l'analyse des articles, avec une page dédiée à la file de tâches où l'on suit les états en attente, en cours, terminés ou échoués. Trois modes d'alimentation existent. Le clic droit sur une entrée envoie une tâche immédiate et ouvre une vue détaillée de la réponse du modèle. L'analyse automatique des nouveaux documents, désactivée par défaut selon le README, s'active dans le tableau de bord via l'option d'analyse automatique des nouvelles références ; le plugin attend alors que Zotero termine la récupération des métadonnées avant de lancer l'analyse. Le troisième mode scanne la bibliothèque à la recherche des articles sans note générée et les présente selon l'arborescence des collections, pour un ajout en lot à la file. Ce découpage a une conséquence pratique : la vitesse de traitement est plafonnée par un réglage du nombre d'articles traités par minute, présenté comme un moyen d'éviter de dépasser les limites d'appel de l'API. Un utilisateur qui pousse cent PDF dans la file ne doit donc pas s'attendre à un résultat immédiat, et le README ne donne aucune estimation de durée.
Mise en route : clé, fournisseur, mode PDF, modèle de prompt
L'installation suit le circuit habituel des plugins Zotero, et le README renvoie à un wiki externe hébergé sur GitHub Pages pour la configuration et l'usage détaillés. L'interface principale s'ouvre de deux façons : par le menu d'édition de Zotero, onglet du plugin, ou par un clic droit sur une entrée vers le tableau de bord. La configuration des accès se fait dans la page de réglages rapides, avec quatre familles annoncées : OpenAI, Gemini, Anthropic, et un mode compatible OpenAI destiné aux services tiers. Le README mentionne aussi des entrées pour 火山方舟 et Ollama. Une fois la clé saisie, un bouton de test de connexion permet de vérifier qu'elle fonctionne. Deux réglages déterminent ensuite le comportement : la vitesse de traitement par minute, et le mode de traitement du PDF (Base64 ou extraction de texte). Les prompts sont modifiables, avec des variables du type {{title}} et {{authors}} et un aperçu en direct de leur substitution. Le point à retenir pour un lecteur francophone : toute la documentation de référence est en chinois et en anglais, et les libellés d'interface cités dans le README sont en chinois. Il faut donc s'attendre à naviguer dans des menus dont les intitulés ne correspondent pas mot pour mot aux traductions que l'on trouve dans les tutoriels.
Le mode multi-tours et la question du déterminisme
Le plugin propose un mode de relecture en plusieurs passes, déclenché par un clic droit, avec deux variantes décrites comme multi-tours concaténé et multi-tours résumé. La première enchaîne des tours portant sur des aspects distincts (contexte et problématique, méthode, protocole expérimental et résultats, conclusion) puis agrège le tout ; la seconde résume à chaque étape. Le README précise que cette opération écrase la note existante. C'est un choix assumé, mais il mérite d'être dit : relancer une analyse sur un article déjà traité détruit la version précédente sans conservation apparente. Il n'y a pas, dans le matériel fourni, de mention d'un historique ou d'une comparaison entre deux générations de notes. Pour un travail de recherche où l'on veut conserver une trace de ce que le modèle avait produit à une date donnée, c'est une limite réelle. Elle s'ajoute à une autre : la sortie dépend du modèle, de sa version et du prompt. Le README recommande Gemini 3 pro pour le résumé et pour l'explication, ce qui est une recommandation d'auteur, pas un résultat mesuré. Rien dans le matériel fourni ne compare la qualité des notes entre fournisseurs.
AGPL-3.0 : ce que cela implique pour un usage en laboratoire
Le dépôt est publié sous AGPL-3.0. Pour un chercheur qui installe le plugin dans son Zotero personnel, la contrainte est faible : la licence s'applique au code, pas aux notes produites ni aux articles analysés. La situation change si le plugin est modifié puis exposé à des utilisateurs sur un réseau, cas que l'AGPL traite plus strictement que la GPL. Un service de laboratoire qui envelopperait le plugin dans une interface web devrait examiner cette clause avant diffusion. Je ne donne pas d'avis juridique ici, et le fichier de licence du dépôt reste la référence à lire. Un autre point mérite attention : le README indique que le plugin n'offre aucun service de proxy vers un modèle et qu'il n'existe aucun canal de paiement. Le coût d'usage est donc entièrement porté par la clé API de l'utilisateur, facturée par le fournisseur selon ses propres tarifs. Le README mentionne par ailleurs un quota gratuit quotidien chez 火山方舟 et renvoie à un projet tiers, gcli2api, pour obtenir un accès Gemini. Ces pistes sont extérieures au dépôt et ne bénéficient d'aucune garantie de stabilité.
L'alternative : rester dans Zotero sans plugin d'analyse
L'alternative la plus directe n'est pas un autre plugin, c'est le flux manuel : exporter le PDF, l'envoyer à une interface de chat, coller le résumé dans une note Zotero. Ce flux a un mérite que le plugin ne peut pas revendiquer : on choisit document par document ce qui sort de la machine, et on lit la réponse avant de la conserver. Le coût est le temps passé à copier-coller, précisément le point que le README met en avant. La différence d'approche est donc nette : le plugin automatise la chaîne complète, y compris pour des articles qu'on n'aurait peut-être jamais ouverts, tandis que le flux manuel filtre à l'entrée. Il existe une troisième voie, déjà présente dans Zotero : les plugins de traduction et de prise de notes qui n'appellent aucun modèle distant. Ils ne produisent pas de synthèse, mais ils ne transmettent rien. Le choix se joue là, entre automatisation de masse et maîtrise de ce qui est envoyé.
Maintenance, versions bêta et coût de suivi
Le dépôt n'est pas archivé et le dernier envoi de code date de septembre 2026. Les versions récentes listées sont des bêta : v4.1.0-beta.2, v4.1.0-beta.1 et v4.0.3-beta.8, toutes publiées entre la fin juillet et début septembre 2026. Autrement dit, la branche active au moment de la rédaction est une branche de préversion, ce qui implique un risque de régression entre deux mises à jour et un rythme de publication soutenu. Pour un utilisateur qui installe une version stable et ne la touche plus, la question ne se pose pas. Pour celui qui suit les publications, chaque montée de version peut modifier le format des notes, les paramètres de prompt ou le comportement de la file de tâches. Le README ne documente pas de procédure de migration entre versions, et le wiki externe est la seule source de configuration détaillée. La dépendance à un service tiers ajoute une seconde couche de fragilité : un changement d'identifiant de modèle chez le fournisseur, comme le passage de gemini-3-pro-preview à une autre référence, casse la configuration sans que le plugin en soit responsable.
Conclusion éditoriale
Le plugin convient à ceux qui accumulent des PDF dans Zotero et veulent une note Markdown attachée à chaque entrée, avec une clé API qu'ils contrôlent. Il ne convient pas à qui refuse d'envoyer un PDF entier à un fournisseur externe, ni à qui veut une sortie identique d'une exécution à l'autre : la note générée est un artefact de modèle, pas un résumé vérifié. Avant d'adopter, vérifiez deux choses concrètes dans le dépôt : le contenu exact du fichier de licence AGPL-3.0, et le comportement du mode Base64 sur un PDF de votre corpus, puisque c'est ce mode qui transmet le document brut.
Notes de la communauté