Communitygithub.com

yuanyuanyuan430/ganhuo-textbook-downloader

Claude 技能,可依地區感知的方式搜尋、排行與下載 TapXWorld/ChinaTextbook 上的中國教材 PDF 檔案。

ganhuo-textbook-downloader 是什麼?

這個技能專為 Claude 設計,讓使用者能用自然語言描述教材需求(例如「江蘇九上譯林英語」或「大一同濟高數第七版上册」),系統會從 TapXWorld/ChinaTextbook 倉庫中搜尋候選教材,並根據省份/城市線索、版本偏好及 OCR 文字進行排行,最後安全地下載正確的 PDF 檔案。它支援 K-12 與大學教材,並提供 `search`、`download` 及 `self-test` 指令,可透過 CLI 或 Claude 的內建技能目錄執行。省份配對邏輯會優先採用統編版語文、道德與法治、歷史,其他科目則依常見地區版本(如江蘇→蘇教版/譯林版)排序;若候選多個或版本不明確,則要求使用者手動選擇以避免錯誤下載。OCR 功能可從封面或頁面截圖提取文字以提升排行準確度,但不會越過版權限制或自動下載不確定的檔案。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add yuanyuanyuan430/ganhuo-textbook-downloader

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Ganhuo Textbook Downloader

使用此技能,將自然語言描述的教材需求轉換為排行候選,並在安全的情況下,從 TapXWorld/ChinaTextbook 下載教材 PDF 檔案。

工作流程

  1. 提取省份/城市、階段、年級、科目、版本、學期/冊別、版次、出版社/學校線索,以及任何精確的書名線索。
    • K-12 範例:江蘇九上譯林英語、安徽合肥三年級語文上冊。
    • 大學範例:大一同濟高數第七版上冊、本科線代同濟第五版、概率論浙大四版。
    • 封面/頁面圖片範例:可 OCR 讀取的文字,如 新版譯林 九上教材、Know yourself、Welcome to the unit。
  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. 如果某個候選項目明顯符合使用者需求,則下載該項目:
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 檔案。不得繞過登入、付費、版權或存取限制。
  • 不得保證省份排名對每所學校都具有權威性或時效性。
  • 當年級、科目或冊別不明確且存在多個候選項目時,不得自動下載。
  • 不得自動下載近似但錯誤的大學版次,例如使用者要求第六版時下載第五版。
  • 分割檔案(如 .pdf.1 和 .pdf.2)是位元組區塊;腳本會按數字順序下載它們並拼接成一個 .pdf 檔案。

相關技能