Project Files
WARNING.md
Ce dispositif est une démonstration technique et pédagogique. Il n'est ni un produit fini, ni un outil de formation validé, ni un substitut à un enseignement humain. Avant de l'utiliser avec un·e lycéen·ne, prenez le temps de comprendre ce qu'il fait et ce qu'il ne fait pas.
Un·e élève qui clique sur A/B/C sans réfléchir n'apprendra rien. La mécanique du livre-dont-vous-êtes-le-héros est un échafaudage (scaffolding) qui ne porte ses fruits que si l'élève s'engage activement dans les choix qu'il fait. Sans cet engagement, le dispositif n'est qu'un générateur de texte interactif de plus.
Le dispositif révèle la structure d'une dissertation argumentée. Il n'enseigne ni la maturité d'un développement, ni la finesse interprétative d'un auteur, ni la pratique d'une copie de quatre heures sous pression. Le prof reste central. Cet outil n'a de sens que si un·e enseignant·e l'accompagne ou si un parent en discute ensuite avec son enfant.
Le corpus actuel couvre une fraction du programme bac avec une poignée de citations bien sourcées par notion. Il est solide (double-source vérifiée), pas exhaustif. Tout sujet sortant des notions et auteurs couverts donnera des réponses faibles ou vides.
Même avec les garde-fous techniques (corpus fermé, validation automatique des citations, validation des alignements pédagogiques), le narrateur reste un modèle de langage. Sur l'interprétation fine d'un texte, sur la nuance historique, sur les choix dialectiques subtils, il peut se tromper sans s'en rendre compte. L'élève doit garder son esprit critique et confronter ce qu'il lit à ses cours.
Aucun support client, aucun engagement de disponibilité, aucune garantie. Le code est ouvert, livré tel quel. Si vous l'installez et l'utilisez, vous le faites sous votre responsabilité.
L'élève peut ressortir d'une session avec l'impression d'avoir compris la dissertation parce qu'il en a vu le squelette. Une dissertation se rédige en quatre heures, pas en cinq clics. Le squelette qu'il aura construit n'est pas une copie de bac — c'est une carte qui doit ensuite être parcourue à pied.
Le dispositif produit des squelettes argumentés avec citations. Un élève qui copie-colle ce contenu dans une copie de bac sans le retravailler livrera un texte plus moyen qu'il ne pourrait l'écrire lui-même, et apprendra à se reposer sur une béquille au lieu de développer sa propre voix. À utiliser comme révélateur de structure, jamais comme générateur de contenu pré-mâché.
Le validateur automatique attrape :
Il n'attrape pas :
Conséquence concrète : un correcteur du bac humain pénaliserait des choses que notre validateur ne voit pas. Toujours relire avec un œil critique.
Le code est ouvert et chaque session est auditable
(~/.livre-heros-bac/sessions/, vue /admin). Mais en pratique,
peu de parents ou d'enseignants iront lire les transcripts détaillés
ou auditer le corpus. La transparence existe, son usage effectif
n'est pas garanti.
La qualité dépend du modèle LLM utilisé (configurable dans le plugin). Un Qwen3-14B donnera des résultats nettement inférieurs à un Qwen3-30B ou un GPT-OSS-120B. Sur un petit modèle, attendez-vous à des sessions où :
Les garde-fous serveur compensent partiellement, pas totalement.
~/.livre-heros-bac/sessions/ (format JSONL).Cochez idéalement :
README.md et compris l'architecture générale.Le code est ouvert, sans support. Si vous identifiez un bug, un
misuse philosophique récurrent, une citation mal sourcée, ou un
comportement inattendu : ouvrez une issue ou une PR sur le dépôt
du projet. La maintenance dépend de la communauté qui se formera
autour, pas d'un fournisseur unique. Voir README.md section
« Vision communautaire ».
127.0.0.1 (loopback
uniquement). Si vous le bindez sur le réseau local (bind=lan),
toute machine du LAN peut accéder aux pages /, /play,
/admin sans authentification. N'utilisez le mode LAN que sur
un réseau de confiance, et de préférence jamais sur du wifi
public.