Communitygithub.com

ganhuo-textbook-downloader

Claudeスキル。自然言語での教科書リクエストから、中国の教科書(ChinaTextbook)のPDFをランク付けしてダウンロードします。

ganhuo-textbook-downloader とは?

このスキルは、ClaudeなどのAIエージェントがユーザーの自然言語によるリクエストから、中国の小中高および大学教科書のPDF候補をランク付けし、安全な場合にはダウンロードまで実行できるようにするツールです(対象リポジトリ:TapXWorld/ChinaTextbook)。主なワークフローは、リクエストから省・市・学年・科目などの情報を抽出し、専用Pythonスクリプトで検索、候補が一意に特定できれば自動ダウンロード、複数候補があればユーザーに選択を促す、という流れです。OCR機能を備えており、表紙やページのスクリーンショットから読み取ったテキストを検索のヒントとして利用できます(Tesseract OCR対応)。省ごとの教科書バージョンの優先順位付け(例:江蘇省→蘇教版/訳林版)や、大学数学教科書のエディション指定など、中国の教育現場に特化した高度なマッチングロジックを実装しています。また、分割ファイル(.pdf.1, .pdf.2)の自動結合や、ファイルの安全なダウンロード、自己診断機能(self-test)も備えています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Ganhuo Textbook Downloader(中国教科書ダウンローダー)

このスキルを使用すると、自然言語での教科書リクエストをランク付けされた候補に変換し、安全な場合には TapXWorld/ChinaTextbook から教科書ファイルをダウンロードできます。

ワークフロー

  1. 省/市、段階、学年、科目、バージョン、学期/巻、版、出版社/学校の手がかり、および正確なタイトルの手がかりを抽出します。
    • K-12(小中高)の例:江苏九上译林英语、安徽合肥三年级语文上册。
    • 大学の例:大一高数同济第七版上册、本科线代同济第五版、概率论浙大四版。
    • 表紙/ページ画像の例:新版译林 九上教材、Know yourself、Welcome to the unit など、OCRで読み取り可能なテキスト。
  2. まず検索します。省や市の単語はランキングに使用され、必須のパストークンとしては扱われません。
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "安徽 合肥 小学 三年级 语文 上册" --explain
  1. ユーザーが表紙やページのスクリーンショットを提供した場合は、OCRの手がかりとして渡します。
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "新版译林 九上 英语" \
  --cover-image "/absolute/path/to/screenshot.png" \
  --explain
  1. ユーザーがすでに抽出済みの表紙テキストを提供した場合は、直接渡します。
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "九上英语" \
  --ocr-text "新版译林 九上教材 Know yourself Welcome to the unit" \
  --explain
  1. 1つの候補がユーザーのリクエストに明確に一致する場合は、ダウンロードします。
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "安徽 合肥 小学 三年级 语文 上册" \
  --out "$HOME/Downloads/ChinaTextbook" \
  --auto
  1. 複数の候補が考えられる場合は、番号付きリストを表示し、ユーザーにどれをダウンロードするか尋ねます。省の優先順位と表紙/OCRの手がかりはランキングのヒントとして使用されます。
  2. ローカルファイルパス、上流のGitHubパス、ソースURL、分割ファイルステータス、およびランキングの理由を返します。

コマンド

省を推論して検索:

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

ユーザーがテキスト外で場所を示唆した場合に省を上書き:

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

結果番号でダウンロード:

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

大学教科書を検索:

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

スクリプト編集後に組み込みチェックを実行:

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

省のマッチング

スクリプトは省/市の手がかりを使用して、可能性の高い教科書バージョンをブーストします。公式な省と教科書の割り当てを主張するものではありません。

  • 语文、道德与法治、历史 については、これらは一般的に統一された科目であるため、统编版 を優先します。
  • その他の科目については、江苏 -> 苏教版/译林版、北京 -> 北京版/外研版/北师大版、上海 -> 沪教版、深圳/广东 -> 北师大版/沪教版/人教版 などの省/市の優先ヒントと、より広範な 人教版 フォールバックを使用します。
  • ユーザーが明示的にバージョンを指定した場合、明示されたバージョンが省の優先順位よりも優先されます。
  • リクエストが曖昧な場合や候補のランキングが近い場合は、ユーザーに選択を求めます。

制限事項をユーザーに説明する必要がある場合、または省の優先順位テーブルを更新する必要がある場合にのみ、references/province-preferences.md を参照してください。

大学のマッチング

上流リポジトリは現在、大学リソースを 大学/ の下に保存しており、主に 高等数学、线性代数、离散数学、概率论 などの数学関連科目です。

  • 本科、高校、大一、高数、线代、离散、数统、概率统计 などの自然言語をリポジトリの用語にマッピングします。
  • 同济、浙大、第五版、第六版、第七版、四版、原书 などの版とソースの手がかりを強力なマッチング用語として使用します。
  • ユーザーが明示的に要求しない限り、答案、习题、全解、解析、学习辅导、附册、指南 などの非主要資料を優先度を下げます。
  • 要求された大学エディションが存在しない場合は、ニアミスを正解と偽るのではなく、最も近い候補を報告します。

表紙とOCRのマッチング

スクリプトは、表紙またはページのスクリーンショットから読み取り可能なテキストを使用できます。利用可能な場合はローカルの tesseract OCRを実行し、テキストがすでに抽出されている場合は --ocr-text を受け入れます。

  • 有用な手がかり:タイトル、バージョン/出版社、学年/巻、ユニットタイトル、版、著者/編集者、学校/出版社名。
  • 電話やPDFビューアのUIからのノイズの多い手がかりは、可能な限りフィルタリングされます。
  • OCRの手がかりはランキングに役立ちますが、正確なエディションが上流リポジトリに存在するという証拠にはなりません。

境界

  • 公的にアクセス可能な上流のGitHubファイルのみをダウンロードします。ログイン、支払い、著作権、またはアクセス制限を回避しないでください。
  • 省のランキングがすべての学校に対して信頼できるものである、または最新であると約束しないでください。
  • 学年、科目、または巻が不明確で、複数の候補が存在する場合は自動ダウンロードしないでください。
  • ユーザーが第6版を要求したのに第5版をダウンロードするなど、大学エディションのニアミスを自動ダウンロードしないでください。
  • .pdf.1 や .pdf.2 などの分割ファイルはバイトチャンクです。スクリプトはそれらを数字順にダウンロードし、1つの .pdf に連結します。

関連スキル