TeachAnyHEPBL

Que fait TeachAnyHEPBL ?

Transformez un objectif de projet universitaire (+ discipline / cours / livrable optionnels) en :

1. Image longue PNG — décomposition HE-PBL structurée + graphe du système de connaissances du cours
2. Page web interactive — page de décomposition interactive identique au contenu de l'image longue, avec un cahier des charges en ligne, un champ d'informations d'équipe, et soumission par email à l'enseignant (norme dans references/interactive-webpage.md)
3. URL d'édition — https://www.teachany.cn/pbl?... pour affiner par chat, ajuster les nœuds, créer des supports de cours

La décomposition utilise le pipeline en six étapes de TeachAny sur teachany.cn (LLM + index des programmes). N'inventez pas vous-même les nœuds de connaissances – alignez-vous sur le syllabus du cours cible (课程大纲 / 培养方案) plutôt que de fabriquer une structure par chapitres.

Flux de travail

1. Analysez l'objectif du projet universitaire et les champs optionnels (voir references/parameters.md). Par défaut --grade university.
2. Exécutez le CLI inclus depuis ce répertoire de compétence (où se trouve SKILL.md) :

python3 scripts/hepbl-decompose.py \
  --goal "Texte original de la tâche du projet de l'utilisateur" \
  --grade university \
  --subject computer-science \
  -o ./pbl-output

3. Lors de la première exécution, installez les dépendances manquantes : pip install playwright && playwright install chromium
4. Rédigez le plan HE-PBL selon references/course-blueprint.md – objectifs tridimensionnels, niveaux de Bloom, chaîne de prérequis, flux de travail académique. Utilisez references/examples.md comme référence stylistique.
5. Calibrage autoritaire du plan (obligatoire si le document de plan existe, ne pas sauter) : Extrayez mot à mot un overlay JSON du plan de conception → exécutez scripts/calibrate_hepbl.py pour reconstruire la page web et l'image longue (voir ci-dessous « Calibrage autoritaire du plan » et « Normes de visualisation du parcours technique »).
6. Répondez avec le chemin de l'image PNG, le chemin de la page web interactive, le nombre de nœuds du JSON, les objectifs tridimensionnels, et edit_url (ne jamais inclure auto=1 dans les liens que vous donnez aux utilisateurs).
7. Si Playwright échoue, suivez references/fallback.md – renvoyez toujours un lien d'édition.

Script de remplacement local (conservez l'original, utilisez le remplacement en cas d'échec)

scripts/hepbl-decompose-local.py est une version de remplacement du script original (l'original hepbl-decompose.py reste inchangé), conçue pour les problèmes locaux vérifiés suivants :

1. Téléchargement de Chromium par Playwright bloqué (CDN inaccessible) → repli automatique sur channel="msedge" (Edge système)
2. Délai de 360s insuffisant → TIMEOUT_MS = 900_000 (l'index unifié localStorage de la page pbl dépasse le quota, chaque reconstruction complète prend environ 100–180s, le processus complet prend 8–11 minutes, exécutez-le en arrière-plan)
3. goto émet parfois net::ERR_NETWORK_CHANGED → 3 tentatives automatiques (intervalle de 5s)

# Utilisation identique au script original (le modèle reste relativement positionné par rapport à ../assets/hepbl-report.html, ne pas déplacer)
python scripts/hepbl-decompose-local.py --goal "..." --grade university --subject mathematics -o ./pbl-output

Dépannage rapide : image longue présente mais page web interactive manquante = script copié ailleurs exécuté sans trouver le modèle ../assets/ (ignore silencieusement, replacez le modèle dans le même répertoire) ; SciPy local bloqué par la politique de contrôle des applications Windows (DLL _trlib), les projets de type LP utilisent PuLP(CBC) comme principal, SciPy est optionnel via try/except pour validation croisée (NumPy/PuLP fonctionnent normalement).

Normes de plan HE-PBL (obligatoires dans la sortie)

Chaque plan DOIT inclure :

• 知识目标 / 能力目标 / 素质目标 (objectifs tridimensionnels)
• Niveau de la taxonomie de Bloom (记忆 / 理解 / 应用 / 分析 / 评价 / 创造) par objectif
• 知识前置要求 (chaîne de prérequis vers les cours / chapitres antérieurs)
• 核心概念与难点 mappés au système de connaissances du cours
• 项目流程 : recherche documentaire → conception de la solution → mise en œuvre et vérification → présentation des résultats
• 可评估产出 avec normes académiques (rapport de laboratoire / document de conception / soutenance)

Voir references/course-blueprint.md pour la norme complète.

Calibrage autoritaire du plan (obligatoire)

Lorsqu'un document de plan de conception (par ex. « PBL 项目设计方案 » md) existe, la décomposition par le moteur n'est qu'un brouillon, la livraison finale doit passer par le calibrage autoritaire :

1. Extraction mot à mot de l'overlay : noms des nœuds, objectifs tridimensionnels, chiffres de contrainte, résultats de référence (x*/Z*/prix fictif), heures par phase – tout est extrait mot à mot du document de plan de conception, sans fabrication ni réécriture.
2. Suppression des nulls polluants : les champs inventés par le moteur (techRoute/pathPlan/projectBlueprint/stats) sont mis à null dans l'overlay, supprimés lors du deep_merge ; les clés de métadonnées préfixées par _ sont extraites.
3. Image longue = page web : utilisez scripts/calibrate_hepbl.py pour reconstruire la page web et l'image longue (capture d'écran pleine page Playwright, device_scale_factor=2), vérifiez vous-même avant livraison (noms des nœuds cohérents avec le plan de conception, payload sans résidu, résumé cohérent avec le nombre de nœuds).
4. Titre unifié : l'overlay doit contenir le champ title (identique mot à mot au titre du plan de conception) – le héros de la page web, l'onglet, le rapport exporté, le titre de l'image longue proviennent tous de DATA.title (repli sur goal si absent).
5. Entrée pour continuer l'édition : le bouton « Ouvrir dans TeachAnyHE » sur la page web copie en un clic la commande d'invocation de la compétence @skill:TeachAnyHE (coller dans la boîte de dialogue WorkBuddy pour continuer l'édition dans le contexte de l'enseignement supérieur) ; le lien teachany.cn du moteur est rétrogradé en petit lien « Brouillon du moteur TeachAny » conservé (DATA.edit_url).

Normes de visualisation du parcours technique

• La page web privilégie le rendu de techStages[] (stage/hours/tasks[]/output) + toolChain[] (name/use) en diagramme de flux hiérarchique : puces de la chaîne d'outils → flèches de connexion → cartes de phase (points numérotés + lignes de connexion + badge d'heures + liste de tâches + livrable de phase) ; en cas d'absence, repli sur la liste en quatre phases de projectPhases.
• Voir le contrat de données et la structure des blocs dans references/interactive-webpage.md ; un exemple complet d'overlay est dans references/calibration-example-lp.json.

Modèle de sortie

## HE-PBL 课程设计拆解

**Projet** : {title}

![Décomposition du chemin de connaissances du cours]({png_path})

- **Nœuds du graphe** : {nodeCount} (aligné sur programme {matched} · extensions {external})
- **知识目标** : {...}
- **能力目标** : {...}
- **素质目标** : {...}
- **Niveau de Bloom** : {...}
- **Page web interactive** : [Ouvrir la page de décomposition du projet]({html_path}) (cahier des charges en ligne, informations d'équipe, soumission par email à l'enseignant)
- **Continuer l'édition** : bouton « Ouvrir dans TeachAnyHE » sur la page web copie la commande d'invocation de la compétence (coller dans WorkBuddy pour continuer l'édition dans le contexte HE) · Lien du brouillon du moteur : {edit_url}

La commande copiée par le bouton « Ouvrir dans TeachAnyHE », collée dans la boîte de dialogue WorkBuddy, permet de continuer la conversation pour modifier la décomposition, ajuster les points de connaissances, et créer en un clic des supports de cours.

Affichez l'image PNG dans le chat lorsque l'environnement prend en charge les images.

Pourquoi ne pas écrire le graphe à la main ?

TeachAny met en correspondance les nœuds avec les index de programme, effectue une vérification de pertinence et construit les arêtes de dépendance. Une simple liste LLM manque d'alignement sur le programme et produit des identifiants de nœuds factices.

Exemples

Voir references/examples.md pour une bibliothèque complète d'exemples HE-PBL dans les cours de mathématiques / informatique / communication / électrotechnique. Exemples rapides :

Exemple 1 — Structures de données : python3 scripts/hepbl-decompose.py --goal "Concevoir un système de plus court chemin pour le campus..." --grade university --subject computer-science --deliverable engineering-prototype -o ./pbl-output

Exemple 2 — Signaux et systèmes : python3 scripts/hepbl-decompose.py --goal "Conception de filtre FIR et analyse spectrale..." --grade university --subject communications --deliverable simulation-report -o ./pbl-output

Ressources supplémentaires

• Référence des paramètres : references/parameters.md
• Norme de plan HE-PBL : references/course-blueprint.md
• Spécification de la page web interactive : references/interactive-webpage.md
• Bibliothèque d'exemples : references/examples.md
• Playwright indisponible : references/fallback.md