Honnêteté et provenance
Studium dit à l'apprenant qui a écrit chaque clé de réponse, si quelque chose a réellement évalué sa réponse, et si un enseignant a validé la leçon. Cette page explique comment : classes de clé, juge, auto-évaluation, avis, citations des sources, registre d'approbation, et la règle selon laquelle aucun contenu n'atteint les étudiants sans un enseignant.
Ce que déclare chaque leçon
start_lesson_session, get_operator_context (et donc le task.md du canal fichier) et chaque présentation portent un bloc authoring. Le panneau VS Code affiche son avis en bannière.
| Champ | Signification |
|---|---|
mode |
teacher (par défaut) ou self_study |
author_is_learner |
l'apprenant a écrit la leçon |
validated |
vrai seulement quand un registre d'approbation correspond à ce lesson.json exact ; jamais pour une leçon d'auto-apprentissage ; le texte de validated_by ne le donne jamais |
judge |
un juge modèle est configuré sur ce serveur |
notice |
le texte montré à l'apprenant pour une leçon d'auto-apprentissage ; null pour une leçon d'enseignant |
approval |
si un registre d'approbation existe (approval.json à côté de la leçon, ou le membre approval.json d'une leçon .zip), s'il correspond à ce lesson.json exact, et son relecteur (reviewer) |
L'auteur de la rédaction vient de metadata.authoring.drafted_by (teacher, learner ou agent) ; un bundle d'auto-apprentissage qui ne le précise pas est considéré comme rédigé par l'apprenant.
Le registre d'approbation est la seule source du statut validé. Chaque surface (premier écran de la
conversation, panneaux, list_lessons, page de la carte des notions) distingue trois états :
| État | Quand | Ce que lit l'apprenant |
|---|---|---|
| Approuvée | un registre correspond au sha256 du lesson.json chargé |
« Leçon validée par |
| Modifiée depuis l'approbation | un registre existe et ne correspond pas | un avis au premier écran : la leçon a été modifiée depuis son approbation |
| Aucun registre | pas de registre, ou un registre mal formé ou étranger | « Aucune approbation enregistrée pour cette leçon. » / "No approval is recorded for this lesson." |
La contribution d'un apprenant relue par un enseignant (mode: "teacher", drafted_by: "learner")
se lit comme proposée par une personne de la classe (« Leçon proposée par une personne de la classe,
validée par validated_by, sans registre, n'apparaît nulle part comme une validation.
Classes de clé
Chaque type de scène appartient à l'une des quatre classes de clé (key-class.ts). experience_packet.py check les affiche sur sa ligne Key classes: et le lint les reprend.
| Classe | Types de scènes | Qui détient la clé | Dans une leçon d'auto-apprentissage |
|---|---|---|---|
ungraded |
intro, concept, meta_checkpoint |
personne | rien n'est évalué |
author_keyed |
quiz, spot_the_flaw |
l'auteur de la leçon | livre ouvert quand l'auteur est l'apprenant ; non vérifiée quand un agent l'a rédigée |
production |
explain_back, comparison, summary_audit, prompt_practice, communication_sim, discussion, ai_critique |
un juge modèle, s'il est configuré | sans juge, la référence est montrée et rien n'est évalué |
externally_grounded |
reproduction |
une exécution, vérifiée par rapport à son manifeste | la seule clé qu'aucun auteur n'a écrite |
Le juge
Le juge est un modèle que le serveur joint via LITELLM_BASE_URL. get_server_info indique model_backend: configured ou none. Seule une évaluation dont la source est le modèle certifie une réponse rédigée ; une note de 0,6 ou plus compte comme juste.
Studium n'évalue plus les textes par mots-clés. Chercher des mots indices n'importe où dans une réponse mesure le vocabulaire, pas la compréhension : comparée à un enseignant sur une vraie leçon, cette méthode inversait 11 réponses sur 12. Sans juge, le retour montre la référence à laquelle se comparer et n'affiche aucun décompte.
Qui a évalué une réponse
Chaque verdict dit qui a évalué la réponse dans assessed_by : key (la clé de l'auteur, pour un quiz ou un jeu de verdicts), judge (le modèle juge) ou none (personne : une réponse rédigée sans juge, un simple acquittement). graded signifie seulement qu'une réponse a été soumise. Le texte montré à l'apprenant ne marque ✓ que si correct vaut true et ✗ que s'il vaut false ; une réponse que personne n'a évaluée est affichée comme enregistrée.
Après la réponse, un verdict porte sa référence sous forme de données, étiquetée par reference_kind : les points clés qu'une réponse devrait couvrir, les défauts glissés, les affirmations qu'une critique devrait contester, ou correct_choice, le texte du bon choix quand un quiz a reçu une mauvaise réponse (« La bonne réponse »). Comme les passages cités, la référence n'est communiquée que lorsque l'apprenant quitte la scène pour de bon ; une nouvelle tentative sur le même item la retient.
Auto-évaluation
Après une réponse rédigée qu'aucun juge n'a évaluée, l'apprenant note son rappel : again (à revoir), hard (difficile), good (bien) ou easy (facile). Cette note fixe la prochaine révision (FSRS) de chaque notion de la scène notée et ne modifie jamais la maîtrise. Son enregistrement porte source: "self_rated", ce qui permet à un rapport de la distinguer d'une preuve évaluée. Voir Modèle de l'apprenant.
Avis
Une leçon d'auto-apprentissage commence par un avis dans sa langue (en français pour une leçon française, en anglais sinon). Il réunit une phrase sur l'auteur des clés et une phrase sur ce qui est évalué.
| Rédigée par | Première phrase |
|---|---|
| l'apprenant | « Leçon auto-rédigée : les quiz et les défauts à repérer ont une clé écrite par l'apprenant (livre ouvert). » |
| un agent | « Leçon rédigée par l'IA à partir de tes sources, non vérifiée par un enseignant : chaque question cite son passage ; signale à l'agent une clé qui te semble fausse. » |
| Juge | Seconde phrase |
|---|---|
| aucun | « Sans juge modèle, les scènes de production ne sont pas évaluées : compare ta réponse à la référence affichée et note ton rappel ; cette note règle tes révisions, jamais ta maîtrise. » |
| configuré | « Les scènes de production sont évaluées par le modèle. » |
Une leçon qui contient une reproduction ajoute une troisième phrase : « Les reproductions exécutées portent une évaluation externe. »
Les textes sont définis dans authoring.ts.
Sources et citations
Une leçon qu'un assistant rédige avec create_lesson cite un passage source pour chaque question évaluée. Chaque citation doit figurer dans le passage qu'elle nomme et compter de 15 à 500 caractères. Seul ce qu'une copie par un chat ou une page web modifie sans qu'on le voie est neutralisé : les espaces insécables et les suites d'espaces deviennent une seule espace, les apostrophes typographiques deviennent '. Les accents, la casse et le reste de la ponctuation, guillemets « » compris, restent significatifs. Une citation qui ne correspond pas est refusée, avec l'endroit où elle diverge, et la leçon n'est pas écrite.
La licence indiquée pour chaque source est recopiée dans les citations de la leçon (evidence.bibliographic_refs[].license) et affichée après le titre de la source ; une source préparée sans licence n'a pas de champ de licence.
Les passages cités d'une scène évaluée ne sont communiqués qu'après la réponse, quand l'apprenant quitte la scène pour de bon.
Une citation exacte prouve un lien textuel, pas que la question l'utilise correctement. C'est pourquoi l'avis des leçons rédigées par un agent invite l'apprenant à signaler à l'agent une clé qui lui semble fausse.
Constats du lint sur l'autorat
node tools/bundle_lint.mjs ajoute ces constats quand metadata.authoring est présent. WARN et INFO ne font pas échouer l'exécution.
| Code | Niveau | Quand |
|---|---|---|
self_study_authoring |
INFO | toujours en auto-apprentissage : mode, rédacteur, classes de clé |
self_study_open_book |
WARN | scènes à clé d'auteur dont l'apprenant a écrit la clé |
self_study_agent_key |
WARN | scènes à clé d'auteur dont un agent a rédigé la clé ; vérifiez chacune avec son passage |
self_study_no_external_key |
WARN | aucune scène de production ni ancrée dans une exécution |
learner_authored_validated |
INFO | la leçon d'un apprenant diffusée comme bundle d'enseignant |
Le registre d'approbation
Un enseignant enregistre l'approbation d'une leçon terminée avec :
.venv/bin/python tools/experience_packet.py approve --bundle chemin/vers/lesson.json --validated-by "Nom de l'enseignant"
La commande refuse une leçon qui contient encore des marqueurs à remplir, des erreurs de lint, ou qui est en mode auto-apprentissage (ce qui inclut les leçons rédigées avec create_lesson). Elle renseigne validated_by et validated_at, puis écrit approval.json (schéma studium-approval/1) à côté de la leçon, avec l'empreinte SHA-256 des octets exacts de lesson.json, le relecteur, la date, une liste de contrôle facultative (--checklist CLE=VALEUR ...) et le résumé du lint.
Le serveur lit ce registre et indique approval.matches : toute modification de lesson.json après l'approbation le rend faux. Une leçon diffusée en .zip porte son registre dans le membre approval.json, lié aux octets du membre lesson.json. Le registre est un fichier modifiable par quiconque a accès en écriture ; il documente une relecture, ce n'est pas une signature. L'outil MCP review_lesson permet à l'enseignant d'examiner un brouillon sans en voir les clés. Voir Relire et approuver.
Règle 003, un enseignant avant toute diffusion
La règle 003 du projet impose une validation humaine stricte : aucun contenu n'est diffusé aux étudiants sans validation par un enseignant. En pratique :
- un bundle d'enseignant ne se lit comme validé qu'avec un registre d'approbation lié à ses octets exacts (
approveécrit aussi le nom dansvalidated_by, qui seul n'accorde rien) ; - une leçon d'auto-apprentissage ou rédigée par un agent est destinée à l'apprenant qui l'a produite, et son avis le dit ;
- la contribution d'un apprenant n'atteint d'autres apprenants qu'après la décision d'un enseignant, voir Contributions des apprenants.
Studium rend la provenance visible ; il ne certifie pas qu'une leçon est juste. La page Confidentialité et limites précise ce que prouvent, ou non, les empreintes, les citations et les contrôles d'exécution.