← Torna al blog
Aicirca 6 min di lettura

Un grafo di conoscenza cinese per la K12 con 1,644 nodi e gli archi che lo rendono utile

Pubblicato 13 nov 2026
Un grafo di conoscenza cinese per la K12 con 1,644 nodi e gli archi che lo rendono utile

Un repository chiamato `cn-math-taxonomy` ha raccolto circa 8,000 stelle da quando è comparso il 18 ottobre, e il nome lo fa sembrare molto meno di quello che è. È nato come mappa della matematica scolastica cinese e ora copre l'inglese dalla terza elementare, la fisica delle medie e la biologia delle medie.

I numeri spiegano le stelle. 1,644 punti di conoscenza. 2,403 archi di prerequisito. 6,723 domande. Allineate capitolo per capitolo ai programmi del 2022, revisionati nel 2025.

Cosa c'è davvero dentro

Il grafo è costruito dai libri di testo, non da un riassunto del programma. La matematica segue la serie della Casa Editrice Popolare di Educazione dalla prima alla nona classe, più l'edizione A del 2019 con due volumi obbligatori e tre opzionali per le superiori. L'inglese segue PEP dalla terza classe, la serie Go for it! alle medie e il set del 2019 per le superiori. La fisica copre separatamente i volumi di ottava e nona classe, poi le sequenze obbligatorie e opzionali delle superiori.

Questa scelta, il libro di testo invece del programma, è ciò che rende usabile lo strumento. Un programma dice che uno studente deve capire le funzioni lineari entro una certa classe. Un libro di testo dice che il capitolo diciannove le introduce dopo il capitolo diciotto sulle equazioni di secondo grado, e quell'ordine è esattamente ciò di cui ha bisogno un motore diagnostico.

Nella struttura ci sono decisioni deliberate che vale la pena leggere con attenzione. L'inglese è un grafo separato e non si collega per niente alla matematica. L'inglese delle medie si riallaccia a quello delle elementari, e quello delle superiori soprattutto a quello delle medie. Anche la fisica ha il suo grafo, e la matematica da cui dipende un concetto di fisica sta in un campo `mathLinks` invece che in un arco di prerequisito. Il ragionamento dell'autore resta implicito ma regge: a uno studente di fisica che non sa risolvere un'equazione di secondo grado non manca un prerequisito nel senso della teoria dei grafi, gli manca uno strumento, e confondere le due cose manda la diagnosi nella materia sbagliata.

La diagnosi è il prodotto

La funzione di punta è la diagnosi adattiva dei prerequisiti, e funziona come il grafo suggerisce.

Uno studente sbaglia una domanda delle superiori. Il sistema risale gli archi di prerequisito, controlla i concetti sotto e continua a camminare finché arriva a un punto di conoscenza preciso delle elementari che è davvero la radice dell'errore. Non "devi ripassare le funzioni". Piuttosto "sei debole sul rapporto tra frazioni e divisione, per questo la semplificazione dell'espressione razionale è saltata".

È un prodotto diverso da un archivio di esercizi con etichette di difficoltà. È più vicino a come pensa un bravo insegnante di ripetizioni, e funziona solo se l'insieme degli archi è abbastanza completo da poterci camminare sopra. Con 1,644 nodi e 2,403 archi, il grafo ha in media meno di 1.5 archi uscenti per nodo. È rado. Rado è corretto per un DAG di prerequisiti, quasi tutti i concetti dipendono da una o due cose, e significa anche che un solo arco sbagliato manda il cammino in un posto inutile.

La parte che non mi aspettavo

Il README contiene una cosa rara nei progetti di open data: un elenco esplicito di ciò che non è stato possibile verificare.

L'autore ha cercato l'indice ufficiale del libro di matematica 2024 per il secondo quadrimestre della nona classe e non l'ha trovato. La pagina di presentazione dell'editore descrive l'impostazione redazionale senza elencare i capitoli, e la pagina intitolata a quel volume mostra una copertina vecchia. L'edizione 2024 non dovrebbe entrare in aula prima della primavera 2027.

Così il repository etichetta l'elenco dei capitoli come "l'inferenza più affidabile", avverte che non è il testo ufficiale, cita la pagina di sussidiario di terzi da cui ha attinto e chiede ai lettori di controllare sul libro cartaceo. Segnala anche dove il nome di un capitolo è cambiato, da una sezione sulla probabilità a una sugli eventi casuali, e indica quali edizioni dei libri non sono ancora pubblicate e vengono sostituite dalla versione precedente.

Quasi tutti i progetti di questa scala riempiono quei buchi e vanno avanti. Documentarli non costa nulla e risparmia a ogni utente a valle di costruire su una supposizione che non sapeva essere tale.

La licenza, prima di costruire un business

Codice e dati sono sotto CC BY-NC 4.0. Studio personale, didattica e ricerca sono liberi. Corsi a pagamento, app a pagamento e qualsiasi servizio in cui un ente incassa denaro richiedono un'autorizzazione separata, che l'autore gestisce direttamente per messaggio o email.

Per chi è fuori dalla Cina e vuole usarlo, quella clausola è tutta la conversazione. Una licenza non commerciale su un grafo di conoscenza va bene per un prototipo di ricerca ed è un muro per un prodotto. I dati stessi poi hanno una connotazione geografica difficile da trasferire: la struttura degli archi codifica l'ordine in cui i libri cinesi introducono i concetti, e quell'ordine non corrisponde a come un programma statunitense o britannico sequenzia lo stesso materiale.

Perché conta anche fuori dalla Cina

Due ragioni, e nessuna riguarda la tecnologia educativa come mercato.

Primo, è un esempio pulito di ciò per cui i grafi di conoscenza servono davvero. Seguire i vincoli. Un DAG di prerequisiti permette di rispondere a "cosa deve sapere questo studente perché la domanda abbia senso", e quella domanda ha una risposta definita che un modello linguistico approssima volentieri e ogni tanto sbaglia. Il grafo la dà in una traversata.

Secondo, mostra dove sta il valore in un prodotto di dati. Le 6,723 domande sono merce comune. I 1,644 nodi sono una settimana di lavoro accurato. I 2,403 archi, e le decisioni su quale dipendenza diventa arco e quale diventa campo, sono la parte che ha richiesto giudizio vero. Oggi chiunque può generare domande. Quasi nessuno si siede a discutere con se stesso se la dipendenza matematica di un concetto di fisica appartenga al grafo.

Ridefinisce anche quanto vale un archivio di esercizi. Seimila domande sembrano la parte difficile, e dieci anni fa lo erano. Oggi un modello ne produce migliaia in un pomeriggio, etichettate per argomento. Quello che non può produrre è l'ordine: l'affermazione che questo concetto dipende da quello, fatta da qualcuno che ha insegnato entrambi e sa dove gli studenti si rompono davvero. Quell'affermazione è l'input scarso, ed è ciò che protegge una licenza non commerciale.

Se stai valutando il grafo per il tuo uso, un test ti dice quasi tutto. Prendi un concetto in alto in una materia, scendi la sua catena di prerequisiti fino in fondo e leggila ad alta voce. Se ogni passo suona come qualcosa che direbbe un insegnante, gli archi li ha costruiti qualcuno che badava ai dettagli. Se un passo salta dalla scomposizione delle equazioni di secondo grado alla comprensione dei numeri negativi senza niente in mezzo, hai trovato dove il grafo finisce le prove e comincia a inferire.

Se vuoi provarlo, il repository e il sito demo math.pansgo.com sono i punti d'ingresso, e i dati sono abbastanza semplici da caricarli in qualsiasi cosa che parli di grafi. Leggi prima la sezione su ciò che è provvisorio. È quella che ti dice quanto fidarti del resto.

Articoli correlati