Communitygithub.com

yuanyuanyuan430/ganhuo-textbook-downloader

Claude-Fertigkeit zur provinzbewussten Suche und zum Herunterladen von ChinaTextbook-PDFs mit Ranking.

Was ist ganhuo-textbook-downloader?

Diese Fertigkeit ermöglicht es einem KI-Agenten (z. B. Claude), auf Basis einer natürlichsprachlichen Anfrage nach chinesischen Schul- und Lehrbüchern zu suchen, diese zu bewerten und herunterzuladen. Sie greift auf das GitHub-Repository `TapXWorld/ChinaTextbook` zu und unterstützt sowohl K-12- als auch universitäre Lehrbücher, inklusive OCR-basierter Cover-Erkennung. Der Workflow beginnt mit der Extraktion von Provinz/Stadt, Schulstufe, Klasse, Fach, Verlag/Ausgabe und Band aus der Benutzeranfrage. Anschließend wird ein Python-Skript ausgeführt, das die Suchergebnisse anhand von Provinzpräferenzen, expliziten Verlagsangaben und optionalen OCR-Hinweisen bewertet. Bei eindeutiger Übereinstimmung wird das PDF direkt heruntergeladen; bei mehreren plausiblen Kandidaten wird eine nummerierte Liste zur Auswahl präsentiert. Die Fertigkeit vermeidet automatische Downloads bei Mehrdeutigkeiten und respektiert urheberrechtliche Grenzen, indem sie nur öffentlich zugängliche Dateien herunterlädt. Sie ist ideal für Entwickler und KI-Agenten, die chinesische Lehrmaterialien effizient erschließen möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ganhuo Textbook Downloader

Nutzen Sie diese Fertigkeit, um eine natürlichsprachliche Lehrbuchanfrage in bewertete Kandidaten und – bei Sicherheit – in eine heruntergeladene Lehrbuchdatei von TapXWorld/ChinaTextbook umzuwandeln.

Arbeitsablauf

  1. Extrahieren Sie Provinz/Stadt, Schulstufe, Klasse, Fach, Version, Semester/Band, Ausgabe, Verlag/Schulhinweise sowie genaue Titelhinweise.
    • K-12-Beispiele: 江苏九上译林英语, 安徽合肥三年级语文上册.
    • Universitätsbeispiele: 大一高数同济第七版上册, 本科线代同济第五版, 概率论浙大四版.
    • Beispiele für Cover-/Seitenbilder: OCR-lesbarer Text wie 新版译林 九上教材, Know yourself, Welcome to the unit.
  2. Zuerst suchen. Provinz- und Stadtwörter dienen der Bewertung, nicht als erforderliche Pfad-Token:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "安徽 合肥 小学 三年级 语文 上册" --explain
  1. Wenn der Benutzer einen Cover-/Seiten-Screenshot bereitstellt, übergeben Sie ihn als OCR-Hinweis:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "新版译林 九上 英语" \
  --cover-image "/absolute/path/to/screenshot.png" \
  --explain
  1. Wenn der Benutzer bereits extrahierten Cover-Text bereitgestellt hat, übergeben Sie ihn direkt:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "九上英语" \
  --ocr-text "新版译林 九上教材 Know yourself Welcome to the unit" \
  --explain
  1. Wenn ein Kandidat eindeutig der Anfrage des Benutzers entspricht, laden Sie ihn herunter:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "安徽 合肥 小学 三年级 语文 上册" \
  --out "$HOME/Downloads/ChinaTextbook" \
  --auto
  1. Wenn mehrere Kandidaten plausibel sind, zeigen Sie die nummerierte Liste und fragen Sie den Benutzer, welcher heruntergeladen werden soll. Provinzpräferenzen und Cover-/OCR-Hinweise dienen als Bewertungshilfen.
  2. Geben Sie den lokalen Dateipfad, den zugehörigen GitHub-Pfad, die Quell-URL, den Split-Datei-Status und die Bewertungsgründe zurück.

Befehle

Suche mit Provinzermittlung:

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

Provinz überschreiben, wenn der Benutzer einen Ort außerhalb des Textes impliziert:

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

Herunterladen nach Ergebnisnummer:

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

Universitätslehrbücher durchsuchen:

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

Führen Sie den integrierten Selbsttest nach einer Bearbeitung des Skripts aus:

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

Provinzabgleich

Das Skript verwendet Provinz-/Stadthinweise, um wahrscheinliche Lehrbuchversionen zu bevorzugen. Es erhebt keinen Anspruch auf eine offizielle Zuordnung von Provinz zu Lehrbuch.

  • Bei 语文, 道德与法治 und 历史 wird 统编版 bevorzugt, da dies üblicherweise vereinheitlichte Fächer sind.
  • Bei anderen Fächern werden Provinz-/Stadtpräferenzhinweise verwendet, wie 江苏 -> 苏教版/译林版, 北京 -> 北京版/外研版/北师大版, 上海 -> 沪教版, 深圳/广东 -> 北师大版/沪教版/人教版, mit breiteren 人教版-Rückfallebenen.
  • Wenn der Benutzer explizit eine Version nennt, hat die explizite Version Vorrang vor Provinzpräferenzen.
  • Wenn die Anfrage vage ist oder die Kandidatenbewertungen nahe beieinander liegen, bitten Sie den Benutzer zu wählen.

Lesen Sie references/province-preferences.md nur dann, wenn Sie die Einschränkung dem Benutzer erklären oder die Provinzpräferenztabelle aktualisieren müssen.

Universitätsabgleich

Das Upstream-Repository speichert derzeit universitäre Ressourcen unter 大学/, hauptsächlich mathematische Fächer wie 高等数学, 线性代数, 离散数学 und 概率论.

  • Ordnen Sie natürliche Sprache wie 本科, 高校, 大一, 高数, 线代, 离散, 数统 und 概率统计 den Repository-Begriffen zu.
  • Verwenden Sie Ausgabe- und Quellenhinweise wie 同济, 浙大, 第五版, 第六版, 第七版, 四版 und 原书 als starke Abgleichsbegriffe.
  • Werten Sie nicht-hauptsächliche Materialien wie 答案, 习题, 全解, 解析, 学习辅导, 附册 und 指南 herab, es sei denn, der Benutzer fragt explizit danach.
  • Wenn die angeforderte Universitätsausgabe fehlt, melden Sie die nächstgelegenen Kandidaten, anstatt eine Beinahe-Treffer als korrekt auszugeben.

Cover- und OCR-Abgleich

Das Skript kann lesbaren Text aus einem Cover- oder Seitenscreenshot verwenden. Es führt bei Verfügbarkeit lokales tesseract-OCR aus und akzeptiert --ocr-text, wenn der Text bereits extrahiert wurde.

  • Nützliche Hinweise: Titel, Version/Verlag, Klasse/Band, Einheitstitel, Ausgabe, Autor/Herausgeber, Schul-/Verlagsnamen.
  • Störende Hinweise aus der Benutzeroberfläche von Telefon-/PDF-Viewern werden nach Möglichkeit herausgefiltert.
  • OCR-Hinweise helfen bei der Bewertung; sie sind kein Beweis dafür, dass die genaue Ausgabe im Upstream-Repository vorhanden ist.

Grenzen

  • Laden Sie nur öffentlich zugängliche GitHub-Dateien aus dem Upstream herunter. Umgehen Sie keine Anmelde-, Zahlungs-, Urheberrechts- oder Zugriffsbeschränkungen.
  • Versprechen Sie nicht, dass die Provinzbewertung für jede Schule maßgeblich oder aktuell ist.
  • Führen Sie keinen automatischen Download durch, wenn Klasse, Fach oder Buchband unklar sind und mehrere Kandidaten existieren.
  • Führen Sie keinen automatischen Download einer Beinahe-Treffer-Universitätsausgabe durch, z. B. einer fünften Ausgabe, wenn der Benutzer nach der sechsten Ausgabe gefragt hat.
  • Split-Dateien wie .pdf.1 und .pdf.2 sind Byte-Blöcke; das Skript lädt sie in numerischer Reihenfolge herunter und verkettet sie zu einer .pdf.

Verwandte Skills