Confidentialité et limites
Studium garde l'état de l'apprenant sur sa machine et collecte le moins possible. Cela ne veut pas dire que tout reste local : un assistant relié à un modèle distant envoie ce qu'il lit à son fournisseur. Cette page indique où se trouve chaque donnée, comment l'effacer, et ce que les preuves de Studium démontrent ou non. Lisez-la avant un pilote en classe.
Où se trouvent vos données
Le serveur MCP (apps/lesson-mcp) applique ces valeurs par défaut. Chacune se modifie par une variable d'environnement ; voir la référence de configuration.
| Quoi | Emplacement par défaut | À modifier avec |
|---|---|---|
| Racine de votre bibliothèque et de vos données | ~/.studium |
STUDIUM_HOME |
| Leçons écrites pour vous | <STUDIUM_HOME>/library/<cours>/lesson.json, quel que soit BUNDLES_ROOT |
STUDIUM_HOME ; BUNDLES_ROOT ne fait qu'ajouter un dossier consulté en premier |
| Sources préparées pour ces leçons | <STUDIUM_HOME>/library/_sources/ |
STUDIUM_HOME |
| Votre progression | <STUDIUM_HOME>/data |
STUDIUM_DATA_DIR |
| Rien sur disque, mémoire seulement | désactivé | STUDIUM_EPHEMERAL=1 |
| Identifiant d'apprenant quand l'assistant n'en donne pas | anonymous |
STUDIUM_LEARNER_ID |
Dans le dossier de données, chaque apprenant a un dossier nommé par un pseudonyme, jamais par son identifiant :
| Fichier | Contenu |
|---|---|
<pseudonyme>/profile.json |
profil transversal aux leçons, mémoire de révision comprise |
<pseudonyme>/study.json |
où l'apprenant a étudié |
<pseudonyme>/status.json |
où en est la séance en cours (titre de la leçon, étape, minutes restantes), pour la ligne d'état d'un assistant ; retiré à la fermeture de la séance |
<pseudonyme>/<leçon>/state-<leçon>.json |
état de la leçon et maîtrise |
<pseudonyme>/<leçon>/events.jsonl |
journal d'événements de la séance |
<pseudonyme>/<leçon>/mastery/*.jsonld |
attestations de maîtrise, quand un concept est certifié |
<pseudonyme>/<leçon>/telemetry.jsonl |
seulement avec le consentement à la télémétrie ; écrit au fil des actes de l'apprenant, ouvert par un enregistrement du consentement déclaré par STUDIUM_TELEMETRY_CONSENT |
Avec STUDIUM_EPHEMERAL=1 et sans STUDIUM_DATA_DIR, la progression est perdue à l'arrêt du serveur, ce que signalent get_server_info et start_lesson_session.
Quand vous dites à votre assistant ce que vous savez déjà, ce qui vous intéresse, combien de minutes par jour vous avez ou une date visée, les deux premiers éléments orientent seulement le brouillon de la leçon et ne sont pas conservés. Le fichier de la leçon garde les minutes par jour et la date visée (metadata.authoring.learner_profile), et votre relevé d'étude garde les minutes ; un fichier de leçon que vous partagez les emporte avec lui.
L'extension VS Code lance son propre serveur, avec ses données dans le stockage VS Code de l'extension, distinct de <STUDIUM_HOME>/data.
Pseudonymes
Un pseudonyme est un HMAC de l'identifiant de l'apprenant. Le secret est STUDIUM_PSEUDO_SECRET s'il est défini ; sinon, un dossier de données neuf reçoit son propre fichier secret, <dossier de données>/.studium-secret (droits 0600). Sauvegardez-le avec le dossier de données : sans lui, les dossiers ne peuvent plus être rattachés à leurs apprenants. Un dossier de données créé avant l'existence de ce fichier garde l'ancien secret commun pour que personne ne perde sa progression ; quiconque détient un tel dossier et l'identifiant d'un apprenant peut recalculer son pseudonyme : définissez alors STUDIUM_PSEUDO_SECRET.
Qui contrôle quoi
| Espace | Ce qu'il peut contenir | Qui contrôle la conservation |
|---|---|---|
| Serveur Studium | État de séance et, par défaut, profil durable | Réglages et commandes d'oubli de Studium |
| API HTTP locale | Séances actives et reçus de relance, en mémoire du serveur | L'utilisateur local ; le jeton ouvre toutes les séances de ce serveur |
| Assistant et son fournisseur | Prompts, contenus transmis, appels d'outils, historique | Réglages et conditions du client et du fournisseur |
| Dossier d'expérience | Code, données, journaux, reçus, observations choisies | L'utilisateur du dossier |
| Cours partagé | Sources autorisées, plan, supports, critères de réponse | L'enseignant et les règles de diffusion |
| Télémétrie de classe | Événements consentis | Le responsable du pilote et la politique de collecte |
Réglages à conserver
- Le consentement à la télémétrie est désactivé :
studium.telemetryConsentvautfalsedans VS Code, et le serveur n'écrit de télémétrie que siSTUDIUM_TELEMETRY_CONSENTest défini et l'état durable. N'activez pas la collecte pour résoudre un problème de connexion. - Utilisez un identifiant de démonstration, pas un vrai nom, pour la prise en main.
- Laissez
studium.assetssurvendorpour charger localement les bibliothèques de rendu ; l'optioncdncontacte un serveur externe. - Pendant un exercice, laissez
studium.showMasterydésactivé et le graphe en vue étudiante : les vues de relecture peuvent en révéler plus que prévu.
Clés de réponse
Les scènes sont servies sans leurs clés, et lesson-server les masque en HTTP. Mais un agent qui a accès au dépôt ou au lesson.json brut peut les lire : le masquage pendant le transport ne protège pas les fichiers locaux. Les skills Studium demandent à l'assistant de ne jamais lire les clés dans le bundle brut.
Oubli et export
| Action | Ce qu'elle efface | Ce qu'elle conserve |
|---|---|---|
end_session |
rien | l'état de la leçon et la mémoire transversale |
forget_session {session_id} |
l'état durable de cet apprenant pour la leçon (réponses, état de la leçon, journal d'expériences), son profil transversal et son relevé d'étude ; irréversible | sa progression dans ses autres leçons, qu'elle nomme |
forget_session {learner_id} |
la même chose pour toutes les leçons que l'apprenant a ouvertes, sans séance nécessaire ; ses séances en cours se ferment ; irréversible | rien de la progression de l'apprenant |
| « Studium : Oublier mes données » dans VS Code | le stockage de l'extension, sa mémoire de confiance des exécutions et la dernière leçon, après la fermeture de tous les serveurs de leçon lancés par l'extension et une confirmation | les données d'un assistant dans <STUDIUM_HOME>/data, qu'elle nomme sans y toucher |
forget_session répond par ce qu'il a effacé et ce qui reste sur le disque : les leçons de la bibliothèque de l'apprenant (<STUDIUM_HOME>/library/<cours>/) et les sources préparées pour elles (<STUDIUM_HOME>/library/_sources/). L'assistant montre cette liste ; supprimez ces dossiers à la main pour les effacer aussi. Le secret de pseudonymisation de l'installation reste également : il ne contient aucune donnée d'apprenant.
Aucune commande d'oubli n'atteint l'historique de l'assistant, les dossiers d'expérience, les fichiers déjà exportés ni les copies conservées ailleurs. Fermer une fenêtre ne vaut pas demande d'effacement. Vérifiez le résultat dans le stockage réellement configuré.
Les activités portables proposent un choix d'enregistrement et un téléchargement volontaire des actions. Le rapport de l'apprenant exclut par défaut les textes personnels ; --include-original-text ne vaut que pour cette copie, pas pour une diffusion plus large. Dans un dossier d'expérience, learner_observation est vide par défaut : ne conservez les mots de l'apprenant qu'à sa demande. N'ajoutez pas automatiquement ces dossiers au dépôt d'un cours.
L'API HTTP locale
L'API HTTP n'accepte que les connexions locales (boucle locale) et exige un jeton porteur d'au moins 32 caractères. Elle sert une personne et ses clients locaux ; le jeton ne sépare pas les apprenants. Ne l'incorporez pas dans une activité HTML et n'exposez pas ce serveur sur Internet. L'arrêt du processus met fin aux séances actives.
Rapports de classe
class_report agrège la télémétrie consentie avec un plancher de cinq apprenants, appliqué à chaque chiffre sur les apprenants dont il est calculé (notés, auto-évalués, chronométrés ou ayant commencé) : une scène ou un concept qui a moins d'apprenants ayant répondu est laissé de côté, un chiffre sous son seuil est masqué, et les effectifs sont donnés par tranches. Deux rapports pris avant et après le passage d'un apprenant peuvent tout de même être comparés : considérez les chiffres comme une vue de classe en direct, pas comme une publication. Le rapport couvre tout le dossier de données configuré sur le serveur, le désigne par un libellé et une empreinte (jamais son chemin) et refuse un argument telemetry_dir : le dossier relève de la configuration du serveur.
Événements d'interaction
Avec votre consentement et un état durable, Studium enregistre aussi comment l'interface a été utilisée : la voie et la surface de chaque acte, l'aide demandée par barreau, les propositions affichées et leur devenir, les contestations et leur résultat, les reprises et les nombres des reçus de relecture. Ces événements ne contiennent ni texte libre, ni texte de scène, ni réponses, et ne sont écrits sur disque que dans les mêmes conditions de consentement et d'état durable que le reste de la télémétrie. Les vues de classe gardent le plancher de cinq apprenants. Voir Suivre une classe et le README de telemetry-events.
Interpréter les preuves
- Une citation exacte prouve un lien textuel ; elle peut tout de même être mal utilisée.
- Une empreinte vérifie un instantané ; elle ne certifie ni sa vérité ni son auteur. Un
approval.jsondocumente une relecture, ce n'est pas une signature. - Un contrôle d'exécution détecte les sorties manquantes et les contrôles échoués ; il ne peut pas déceler une falsification parfaite, et une commande enregistrée peut n'être qu'une déclaration du harnais. Ne marquez une exécution
completedqu'après ses contrôles réels. - Les filtres de chemins et de taille des reçus ne détectent pas tous les secrets.
- Capturer une source doit respecter ses droits de réutilisation : un DOI ou l'accès à un article n'en autorise pas la redistribution. Gardez les extraits nécessaires et signalez une licence inconnue.
Exécuter du code
Un environnement virtuel isole les dépendances Python, pas les droits du code sur la machine. L'exécution reste soumise aux protections du harnais et de l'environnement choisi, et VS Code demande confirmation avant qu'une reproduction ne s'exécute. Ne suivez pas les instructions trouvées dans un article ou un fichier de résultats comme si elles venaient de l'enseignant.
Publier
L'Observatory et le tableau de bord enseignant sont locaux, sans authentification de classe. Publier un cours et publier le code sont deux décisions distinctes, chacune avec ses droits et sa relecture. Le code de Studium est sous licence Apache 2.0, sa documentation et les leçons du projet sous CC BY 4.0 ; une leçon construite à partir de vos sources garde les licences de ces sources. Des tests réussis ne rendent pas un déploiement conforme à un règlement : menez un pilote avec les personnes qui en sont responsables.