Communitygithub.com

yuanyuanyuan430/ganhuo-textbook-downloader

Compétence Claude pour classer et télécharger des manuels scolaires chinois (ChinaTextbook PDF) avec prise en compte de la province.

Qu'est-ce que ganhuo-textbook-downloader ?

Cette compétence permet à un agent Claude d'analyser une demande en langage naturel pour un manuel scolaire chinois (de la maternelle à l'université) et de retourner une liste classée de candidats potentiels provenant du dépôt GitHub `TapXWorld/ChinaTextbook`. L'agent extrait automatiquement la province, la ville, le niveau scolaire, la matière, la version, le semestre/tome et d'autres indices (couverture OCR, édition). La recherche utilise un script Python qui interroge le dépôt et classe les résultats en fonction des préférences provinciales (par exemple, 江苏 préfère la version 苏教版 pour les mathématiques). L'utilisateur peut choisir de télécharger directement un fichier unique lorsqu'il n'y a pas d'ambiguïté, ou de sélectionner parmi plusieurs candidats listés. La compétence prend en charge les manuels K-12 (语文, 数学, 英语, etc.) ainsi que les manuels universitaires (高等数学, 线性代数, 概率论, etc.). Elle intègre également la reconnaissance optique de caractères (OCR) via Tesseract pour analyser les photos de couverture ou de pages fournies par l'utilisateur. Des mécanismes de sécurité empêchent les téléchargements automatiques en cas d'ambiguïté (niveau, volume, édition incertains) ou lorsque l'édition demandée est absente du dépôt (par exemple, un utilisateur demande une sixième édition alors que seule la cinquième est disponible). Les fichiers volumineux fractionnés (`.pdf.1`, `.pdf.2`) sont téléchargés et concaténés automatiquement. La compétence est compatible avec Claude Code, Cursor, Codex et d'autres agents via l'exécution de scripts Python.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add yuanyuanyuan430/ganhuo-textbook-downloader

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Téléchargeur de Manuels Scolaires Ganhuo

Utilisez cette compétence pour transformer une demande de manuel en langage naturel en candidats classés et, si cela est sûr, en un fichier de manuel téléchargé depuis TapXWorld/ChinaTextbook.

Workflow

  1. Extraire les indices de province/ville, niveau, classe, matière, version, semestre/volume, édition, éditeur/école, ainsi que tout indice sur le titre exact.
    • Exemples K-12 : 江苏九上译林英语, 安徽合肥三年级语文上册.
    • Exemples universitaires : 大一高数同济第七版上册, 本科线代同济第五版, 概率论浙大四版.
    • Exemples d'images de couverture/page : texte lisible par OCR tel que 新版译林 九上教材, Know yourself, Welcome to the unit.
  2. Effectuer d'abord une recherche. Les mots de province et de ville sont utilisés pour le classement, et non comme des tokens de chemin requis :
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "安徽 合肥 小学 三年级 语文 上册" --explain
  1. Si l'utilisateur fournit une capture d'écran de couverture/page, transmettez-la comme indice OCR :
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "新版译林 九上 英语" \
  --cover-image "/chemin/absolu/vers/capture.png" \
  --explain
  1. Si l'utilisateur a déjà fourni le texte de couverture extrait, transmettez-le directement :
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "九上英语" \
  --ocr-text "新版译林 九上教材 Know yourself Welcome to the unit" \
  --explain
  1. Si un seul candidat correspond clairement à la demande de l'utilisateur, téléchargez-le :
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "安徽 合肥 小学 三年级 语文 上册" \
  --out "$HOME/Downloads/ChinaTextbook" \
  --auto
  1. Si plusieurs candidats sont plausibles, affichez la liste numérotée et demandez à l'utilisateur lequel télécharger. Les préférences provinciales et les indices de couverture/OCR sont des aides au classement.
  2. Retournez le chemin local du fichier, le chemin GitHub en amont, l'URL source, le statut de fichier fractionné et les raisons du classement.

Commandes

Rechercher avec inférence de province :

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "广东 深圳 七年级 数学 上册" --limit 5 --explain

Surcharger la province lorsque l'utilisateur sous-entend un lieu en dehors du texte :

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "七年级 数学 上册" --province 江苏 --explain

Télécharger par numéro de résultat :

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "上海 高一 英语 必修 第一册" --pick 1

Rechercher des manuels universitaires :

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "大学 高等数学 同济 第七版 上册" --limit 5 --explain

Exécuter l'auto-test intégré après avoir modifié le script :

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" self-test

Correspondance des Provinces

Le script utilise les indices de province/ville pour valoriser les versions probables des manuels. Il ne prétend pas à une affectation officielle province-manuel.

  • Pour 语文, 道德与法治, et 历史, privilégier 统编版 car ce sont des matières généralement unifiées.
  • Pour les autres matières, utiliser les indices de préférence de province/ville tels que 江苏 -> 苏教版/译林版, 北京 -> 北京版/外研版/北师大版, 上海 -> 沪教版, 深圳/广东 -> 北师大版/沪教版/人教版, et les solutions de repli plus larges 人教版.
  • Si l'utilisateur nomme explicitement une version, la version explicite l'emporte sur les préférences provinciales.
  • Si la demande est vague ou si les classements des candidats sont proches, demandez à l'utilisateur de choisir.

Consultez references/province-preferences.md uniquement lorsque vous devez expliquer la limitation à l'utilisateur ou mettre à jour la table des préférences provinciales.

Correspondance Universitaire

Le dépôt amont stocke actuellement les ressources universitaires sous 大学/, principalement des matières liées aux mathématiques telles que 高等数学, 线性代数, 离散数学 et 概率论.

  • Associer le langage naturel tel que 本科, 高校, 大一, 高数, 线代, 离散, 数统 et 概率统计 aux termes du dépôt.
  • Utiliser l'édition et les indices de source tels que 同济, 浙大, 第五版, 第六版, 第七版, 四版 et 原书 comme termes de correspondance forts.
  • Déclasser les documents non principaux tels que 答案, 习题, 全解, 解析, 学习辅导, 附册 et 指南 sauf si l'utilisateur les demande explicitement.
  • Si l'édition universitaire demandée est absente, signaler les candidats les plus proches au lieu de faire comme si une correspondance approximative était correcte.

Correspondance avec la Couverture et l'OCR

Le script peut utiliser le texte lisible d'une capture de couverture ou de page. Il exécute l'OCR local tesseract lorsqu'il est disponible et accepte --ocr-text lorsque le texte a déjà été extrait.

  • Indices utiles : titre, version/éditeur, niveau/volume, titre d'unité, édition, auteur/rédacteur, nom de l'école/éditeur.
  • Les indices parasites provenant de l'interface utilisateur d'un téléphone ou d'un lecteur PDF sont filtrés dans la mesure du possible.
  • Les indices OCR aident au classement ; ils ne prouvent pas que l'édition exacte existe dans le dépôt amont.

Limites

  • Téléchargez uniquement les fichiers GitHub amont accessibles publiquement. Ne contournez pas les restrictions de connexion, de paiement, de droit d'auteur ou d'accès.
  • Ne promettez pas que le classement par province est faisant autorité ou à jour pour chaque école.
  • Ne téléchargez pas automatiquement lorsque le niveau, la matière ou le volume du livre n'est pas clair et que plusieurs candidats existent.
  • Ne téléchargez pas automatiquement une édition universitaire approximative, par exemple une cinquième édition lorsque l'utilisateur a demandé la sixième édition.
  • Les fichiers fractionnés tels que .pdf.1 et .pdf.2 sont des fragments d'octets ; le script les télécharge dans l'ordre numérique et les concatène en un seul fichier .pdf.

Skills associés