tchMaterial-parser : ce que le dépôt permet vraiment
PDF. L'outil de téléchargement de manuels électroniques de la Plateforme nationale d'éducation intelligente pour les écoles primaires et secondaires vous aide à obtenir l'URL du fichier PDF du manuel électronique à partir de la plateforme d'éducation intelligente et à le télécharger, vous permettant d'obtenir le contenu du manuel plus facilement.
En bref
- De quoi s’agit-il ?
- Analyse en français de happycola233/tchMaterial-parser, de son usage documenté, de ses prérequis et de ses limites observables.
- À qui s’adresse-t-il ?
- Le README maintient l'outil au niveau de l'analyse et du téléchargement, les droits sur les ressources appartiennent à la plateforme, et la clause de non-responsabilité fixe les limites d'utilisation ; quant à la disponibilité à long terme, aux garanties de sécurité et à la maintenance future, la documentation ne fait aucune promesse.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 7 jours.
- En quel langage est-il écrit ?
- Principalement Python, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Télécharger les manuels électroniques depuis la plateforme d'éducation intelligente
Le README décrit tchMaterial-parser comme un outil de téléchargement pour la section des manuels électroniques de la plateforme nationale d'éducation intelligente pour les écoles primaires et secondaires (国家中小学智慧教育平台), hébergée à basic.smartedu.cn. On colle les URL des pages d'aperçu des manuels dans l'outil, et il les résout en fichiers PDF puis les télécharge, en nommant chaque fichier avec le nom du manuel par défaut. La clause de non-responsabilité du projet indique que l'outil ne fait que faciliter le téléchargement, ne stocke aucune ressource et que tout le contenu provient directement de la plateforme. Le README mentionne également que le projet a atteint la troisième place du classement général GitHub Trending en mai 2025 (environ 400 étoiles ajoutées en un jour) et la troisième place du classement quotidien Trendshift pour Python. Les métadonnées du dépôt enregistrent 5 977 étoiles, 741 forks et 4 issues ouvertes.
La liste des fonctionnalités telle que documentée
Le README énumère huit fonctionnalités. Le téléchargement par lots accepte plusieurs URL de pages d'aperçu à la fois. Les fichiers sont nommés automatiquement avec le nom du manuel comme nom de fichier par défaut. Un paramètre facultatif "ajouter des signets PDF" insère des signets après le téléchargement afin de pouvoir sauter à des endroits précis lors de la lecture. La prise en charge du jeton d'accès permet de saisir un jeton manuellement, qui est enregistré et chargé au prochain démarrage. La recherche de ressources fonctionne par nom de ressource ou par combinaisons de catégories telles que niveau scolaire, matière et année ; les résultats se déploient automatiquement, les noms longs défilent horizontalement et le survol affiche les informations complètes ainsi qu'une grande couverture. L'interface est adaptée aux écrans haute densité, le mode sombre suit le système au démarrage, avec un bouton manuel en haut à droite qui mémorise le choix. L'outil prend en charge Windows, Linux et macOS, et nécessite une interface graphique.
Les voies d'installation dans le README
Le README documente quatre voies d'installation. GitHub Releases fournit des builds pour Windows, Linux et macOS en x86_64 et Arm64, sans étapes d'installation supplémentaires ; sur macOS, l'application non signée est signalée comme endommagée par le système, il faut donc d'abord exécuter xattr -cr /path/to/tchMaterial-parser.app pour supprimer l'attribut de quarantaine, et il est recommandé de déplacer l'application dans /Applications pour garantir la persistance du jeton d'accès. WinGet prend en charge Windows 10, 11 et Server 2025 avec winget install tchMaterial-parser. Les utilisateurs d'Arch Linux peuvent installer depuis l'AUR avec yay -S tchmaterial-parser. Depuis les sources, Python 3.10 ou supérieur est requis ; le README montre git clone, cd, pip install . et python ./src/main.py. L'interface graphique repose sur Tkinter ; certaines distributions Linux nécessitent une installation séparée de python3-tk, et les systèmes minimalistes peuvent manquer de polices chinoises et d'emojis. Pour empaqueter son propre exécutable, le README suggère d'installer pyinstaller puis d'exécuter pyinstaller ./tchMaterial-parser.spec, avec la sortie dans le répertoire dist.
Le déroulement d'utilisation en trois étapes
La section d'utilisation décrit trois étapes. D'abord, coller une ou plusieurs URL de pages d'aperçu de manuels électroniques dans la zone de texte, une par ligne. Ensuite, définir facultativement un jeton d'accès ; depuis la v3.1, cette étape n'est plus strictement nécessaire car l'outil retombe sur une autre méthode de téléchargement, mais le README prévient que cette méthode n'est pas fiable à long terme et recommande tout de même de définir le jeton. Pour obtenir le jeton, il faut se connecter à la plateforme dans un navigateur, ouvrir la console des outils de développement et coller un extrait JavaScript fourni qui lit le access_token dans les entrées localStorage dont les clés commencent par ND_UC_AUTH, puis l'affiche dans la console pour le copier. Le README avertit de se connecter avant de coller, de coller après le ">" plutôt que dans un champ de filtre, et de taper "允许粘贴" si la console demande une autorisation. Troisièmement, cliquer sur le bouton de téléchargement ; les fichiers sont enregistrés dans le répertoire choisi avec les noms des manuels, et les signets sont ajoutés si l'option est activée.
Où vit le jeton d'accès et ce que le README dit de la confidentialité
La FAQ documente l'emplacement de stockage du jeton par système d'exploitation. Sous Windows, le jeton est stocké dans le registre sous HKEY_CURRENT_USER\Software\tchMaterial-parser, dans la valeur AccessToken. Sous Linux, il est stocké dans ~/.config/tchMaterial-parser/data.json. Sous macOS, le chemin est ~/Library/Application Support/tchMaterial-parser/data.json. Les autres systèmes d'exploitation ne prennent pas encore en charge la persistance, et le README indique qu'une solution universelle est recherchée. Le README déclare également que l'outil ne téléverse pas le jeton et ne le stocke pas dans le cloud, qu'il l'utilise uniquement pour l'autorisation locale des requêtes, et il déconseille de partager le jeton publiquement. Les jetons expirent, généralement après environ sept jours, et un nouveau jeton doit être obtenu lorsque les téléchargements échouent.
Cas d'échec documentés et mises en garde liées aux plateformes
La FAQ énumère les causes d'échec de téléchargement que le projet maintient : aucun jeton d'accès défini, auquel cas la méthode de repli peut avoir cessé de fonctionner ; un jeton expiré, généralement valable environ sept jours ; une connexion réseau instable ; et des URL de ressources invalides ou supprimées. Sur macOS, l'application non signée est signalée comme endommagée par le système, et l'attribut de quarantaine doit être supprimé avec xattr -cr avant l'exécution ; il est suggéré de déplacer l'application dans /Applications pour la persistance du jeton. Sous Linux, les installations réduites peuvent manquer de polices chinoises et d'emojis, ce qui affiche des carrés dans l'interface ; des commandes Debian et Ubuntu pour installer fonts-noto-cjk et fonts-noto-color-emoji sont données. Le README ne décrit aucune récupération automatique ni logique de nouvelle tentative au-delà de la demande de réobtenir un jeton.
Licence et clause de non-responsabilité, et ce que la source laisse ouvert
Le projet est publié sous licence MIT, comme l'indiquent le README et le fichier LICENSE, et il utilise certaines images de Microsoft Fluent Emoji sous la même licence. Le texte MIT accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, et il décline entièrement toute garantie et responsabilité. La clause de non-responsabilité du README ajoute que l'outil n'a aucun lien d'affiliation ou de coopération avec la plateforme nationale d'éducation intelligente, que le droit d'auteur des ressources téléchargées appartient à la plateforme et aux titulaires de droits concernés, que l'utilisation est limitée à l'étude personnelle et à la référence pédagogique, et que l'utilisation commerciale et la redistribution ne sont pas autorisées. Le README ne dit rien sur les garanties de sécurité, les engagements de support ou la préparation à la production ; ces aspects restent sans réponse.
Conclusion éditoriale
Le README maintient l'outil au niveau de l'analyse et du téléchargement, les droits sur les ressources appartiennent à la plateforme, et la clause de non-responsabilité fixe les limites d'utilisation ; quant à la disponibilité à long terme, aux garanties de sécurité et à la maintenance future, la documentation ne fait aucune promesse. Pour tchMaterial-parser, le premier contrôle utile porte sur tchmaterial-parser, le format des données, les commandes d’installation et les exemples fournis par le dépôt : exécuter le chemin documenté, inspecter la sortie et vérifier les permissions ou dépendances annoncées. Le projet convient au profil qui accepte ces prérequis et ne convient pas à une intégration qui exige des garanties absentes du README.
Notes de la communauté